1. MAKEDOC3.EXW
- Posted by rforno at tutopia.com
Apr 03, 2003
This is a multi-part message in MIME format.
------=_NextPart_000_005C_01C2F8B9.2B2B6E60
charset="iso-8859-1"
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.
------=_NextPart_000_005C_01C2F8B9.2B2B6E60
charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML><HEAD>
<META content=3D"text/html; charset=3Diso-8859-1" =
http-equiv=3DContent-Type>
<META content=3D"MSHTML 5.00.2314.1000" name=3DGENERATOR>
<STYLE></STYLE>
</HEAD>
<BODY bgColor=3D#ffffff>
<DIV><FONT face=3DArial size=3D3>Dan:</FONT></DIV>
<DIV><FONT face=3DArial>I tried to apply MAKEDOC3.EXW to the new version =
of my=20
General Functions package, but it didn't work as well as expected. Will =
you=20
please have a look to the HTM output and the GENFUNC.E (you can download =
them=20
from the Eu site) and see what is the problem?</FONT></DIV>
------=_NextPart_000_005C_01C2F8B9.2B2B6E60--
2. 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>
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!
3. Re: MAKEDOC3.EXW
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!
>
4. Re: MAKEDOC3.EXW
On Thu, 3 Apr 2003 23:16:48 -0800, Dan Moyer <DANIELMOYER at prodigy.net>
wrote:
>
> Ricardo,
>
> In general, I made so many versions of modifications to MakeDoc (which
> was
> actually written by David Cuny & later improved by Derek Parnell),
[snip]
I think its about time I properly documented the MakeDoc utility. I sort of
evolved rather than being designed. Some other people have also contributed
to it, BTW.
--
Derek
