Makedoc
[1/4] from: swhite:ci:bloomington:mn:us at: 25-Jul-2006 11:06
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? 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.
Thank you. Steven White City of Bloomington 1800 W Old Shakopee Rd Bloomington MN 55431-3096
USA 952-563-4882 (voice) 952-563-4672 (fax) steven.white-ci.bloomington.mn.us
[2/4] from: henrik::webz::dk at: 27-Jul-2006 5:15
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
<<quoted lines omitted: 5>>
> 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
[3/4] 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
[4/4] from: greggirwin::mindspring::com at: 27-Jul-2006 7:47
Hi Steven,
SW> Well, I found the problem. Near the end of the script is the line that
SW> creates the output file name out of the input file name:
SW> append clear find/last file #"." ".html"
SW> My input file name did not have a dot anywhere in it, so when the
SW> script tried to find a dot as an place marker for the .html extension,
SW> it could not.
SW> With my background (Unisys and unix), I did not realize that a file
SW> name "extension" was a de-facto requirement, so I don't always use one.
SW> I guess I will from now on.
I'd submit a fix for it. It should certainly support that scenario.
-- Gregg
Notes
- Quoted lines have been omitted from some messages.
View the message alone to see the lines that have been omitted