Re: MAKEDOC3.EXW
- Posted by Dan Moyer <DANIELMOYER at prodigy.net> Apr 04, 2003
- 315 views
Ricardo, In general, I made so many versions of modifications to MakeDoc (which was actually written by David Cuny & later improved by Derek Parnell), for a variety of reasons that I no longer clearly remember, and didn't comment the changes at all, with the result that I'm not very sure what's going on, but I'll try to find out. On my system I show up to version 5, with a bunch of "workup" versions after that, some of which *may* relate to making MakeDoc optionally produce multi-page htm, so when people with slower systems (like me) look at a large doc like Win32Lib.htm it doesn't take forever to jump to links. But in specific: you wrote: > > Dan: > I noticed the following problems: > 1) MAKEDOC3 adds some indentations to the text, apparently at random. See > for example the line near the beginning starting with "Version 1.7...", that > is indented one position. Not very important, but I'd like to know why this > happens ;) Haven't found the code that does that yet, but as you say, it's not really very important. > 2) Comments in each function are chained together, while in the program they > are in separate lines (is this intentional?). Yes, I'm pretty sure that's deliberate, so the htm doc displays "paragraphs" of related comments; if you want to force separate lines, one way (there may be others) is to put a line with just --/code in it just before the comments you want to show as separate lines, and put a line with just --/endcode after the block of comments you want to have show as separate lines in the .htm. The "code" block won't show in a fancy font, but it will display however you write it. As I look into the commenting of Win32Lib.ew and compare its .htm, it would appear that you can also force separate lines by just using /n, either at the end of a comment line or after the comment dashes in a new line (may need space before and after the /n, and it's /n, not \n, probably to be consistent with the other slash-tags), or, alternatively by just putting a blank comment line between lines you want to separate. > 3) And, most important, in some functions the text after the old function > definition has disappeared. For example, for the And function, the comments > end with: > > (Eberlein?). The old version is: global function And(object a) > > while in the program they end with: > > --The old version is: > --global function And(object a) > --atom b > --if atom(a) then > --return a and 1 > --end if > --b = 1 > --for i = 1 to length(a) do > --b = b and And(a[i]) > --if not b then > --return 0 > --end if > --end for > --return b > --end function > --Examples: And({7, 2, -6.76}) gives 1. And({9,0,-4}) gives 0. > --1 is returned for empty arguments. > > So, not only the old version is missing, but the examples too. I'm pretty sure that's because those lines don't *start* with comment dashes (at the left margin), and MakeDoc expects anything that is to be carried into the .htm to do so. Since you want to show the code, try putting lines with --/code and --/endcode around the commented code lines, which will show it as you have indented it, minus the comment dashes; I think if you do that, the examples after the code will also show up, because I think that whenever it sees the first instance of no more comment dashes at the *beginning* of a line, it takes that to mean there's nothing more that's intended to show in the .htm. > > Many thanks for your help. HTH some, Dan > > ----- Original Message ----- > From: Dan Moyer <DANIELMOYER at prodigy.net> > To: EUforum <EUforum at topica.com> > Sent: Thursday, April 03, 2003 2:19 AM > Subject: Re: MAKEDOC3.EXW > > > > Ricardo, > > > > I downloaded your genfunc.e Version 1.7 - 2003/03/26, and its .htm file, & > > the .htm seems to work fine; did you have to tweak it or something to > make > > it right, or am I not noticing something? How exactly is MakeDoc3.exw not > > working as well as expected? In the meantime, I'll have to look through a > > bunch of different versions to make sure ver. 3 is the most appropriate. > > > > Dan > > > > ----- Original Message ----- > > From: <rforno at tutopia.com> > > To: "EUforum" <EUforum at topica.com> > > Sent: Tuesday, April 01, 2003 8:42 PM > > Subject: MAKEDOC3.EXW > > > > > > Dan: > > I tried to apply MAKEDOC3.EXW to the new version of my General Functions > > package, but it didn't work as well as expected. Will you please have a > look > > to the HTM output and the GENFUNC.E (you can download them from the Eu > site) > > and see what is the problem? > > TIA. > > > > ==^^=============================================================== > > This email was sent to: DANIELMOYER at prodigy.net > > > > > > TOPICA - Start your own email discussion group. FREE! > > > > > > TOPICA - Start your own email discussion group. FREE! > > > > > > TOPICA - Start your own email discussion group. FREE! >