[REBOL] Re: Makedoc
From: swhite::ci::bloomington::mn::us at: 27-Jul-2006 8:26
Well, I found the problem. Near the end of the script is the line that
creates the output file name out of the input file name:
append clear find/last file #"." ".html"
My input file name did not have a dot anywhere in it, so when the
script tried to find a dot as an place marker for the .html extension,
it could not.
With my background (Unisys and unix), I did not realize that a file
name "extension" was a de-facto requirement, so I don't always use one.
I guess I will from now on.
Thank you.
>>> Henrik Mikael Kristensen <henrik-webz.dk> 7/26/2006 10:15 PM >>>
On 25/07/2006, at 18:06, Steven White wrote:
> I downloaded both make-doc and makedoc2 and tried them on a simple
> example of my own AND on the example cut and pasted from the
> documentation, and got an error.
>
> Is makedoc still the official way of making REBOL documents?
I use it all the time to produce miles and miles of documentation,
and I believe it is the official way.
> Is one on
> one's own for figuring out why it might not work? Is it supposed
> to be
> downloaded from some place other than the library? Etc., etc. I
was
> all hot to try it out and not I'm (temporarily, I hope) stalled.
>
> I can reproduce the error, but I am not expecting help in debugging
> it,
> just making sure I'm using the correct version of the correct
> documentation tool from the correct source.
It's hard to tell when you haven't reproduced the error, but the
official version is downloadable from this place:
http://www.rebol.org/cgi-bin/cgiwrap/rebol/view-script.r?
script=makedoc2.r
The easiest way is to start it. It will then prompt for an input
file. When you give it a make doc text file, it should produce an
HTML file from that input.
A rather large example of a makedoc 2 document can be found here:
http://www.hmkdesign.dk/rebol/list-view/list-view.txt
--
Regards,
Henrik Mikael Kristensen