POV-Ray : Newsgroups : povray.unofficial.patches : format for documentation : Re: format for documentation Server Time
2 Nov 2024 07:28:15 EDT (-0400)
  Re: format for documentation  
From: Jon A  Cruz
Date: 23 Jan 2000 19:40:51
Message: <388BA0BB.67F6720A@geocities.com>
Nathan Kopp wrote:

> What would be the desired format for MegaPov documentation for Windows and
> Unix?
>
> Available formats to choose from:
>
> WordPerfect

Probably not supported enough.


> MS Word 97

Eww. Help. Please no.

> MS Word (simple, read by WordPad)

Also not too good.


> PostScript

Nice for printing, but probably not for a on-computer reference.


> PDF (only if I can generate it with free tools)

A bit better than PS, but maybe so-so. Much preferred over any MS Word format
though.


> HTML (export from MS Word)

No no no nonononononononononononooooooooooooooooooooo. Please no. Its output
is so horrible and broken that it's only due to the sloppy implementation of
HTML in MSIE that Word's output just accendentally happens to work. Please
something else.


> Some other format that I could easily generate from a MS Word file using
> free tools.

I'd suggest exporting to RTF (as most word processors on most platforms
handle that and in a fairly good manner). Then you might have it run through
some tools to make nice HTML.

If you had anyway to get to XML, that would be great. From good XML it's
quite easy to get it converted to just about anything needed, and to build
needed indexies, etc.


> (Sorry, but I don't have any tools to generate HLP files for Windows.)
>
> -Nathan

Hmmm. If you sign up for the free MSDN membership, you might get free access
to their help compiler. It's worth looking into.


And, yes, I'd be more than willing to give some time, if it would mean saving
you from having to put out MS Word's HTML.  :-)

--
"My new computer's got the clocks, it rocks
But it was obsolete before I opened the box" - W.A.Y.


Post a reply to this message

Copyright 2003-2023 Persistence of Vision Raytracer Pty. Ltd.