document converter for unix and win32.

[Stephenson, Paul]

> From: Brendan Simon [ mailto:bsimon@ctam.com.au ]
> Sent: 25 November 1999 01:13
> 
> Can anyone recommend a good documentation tool that can 
> output PS, PDF,
> HTML, (and maybe MSWord doc) files.  The tool must have ports to Unix
> and MS-Windows machines.  I would prefer native Win32 ports 
> as most/all
> of the people I work with are Unix ignorant but Cygwin 
> apps/ports should
> be OK.
> 
> The only ones I can think of are LaTeX and Info.  Are these 
> appropriate
> or are there better tools or more standard tools for this type of work
> ?  I plan to write some scripts to extract function definitions from a
> large pool of source code to automatically generate documentation.

Texinfo is the format used for GNU documentation.  It's a bit like LaTeX,
and can be run through TeX to get DVI output, pdfTeX to get PDF, and
`makeinfo' to get online documentation (Info or HTML).  The DVI output can
be converted to PS with `dvips'.

It all comes with the MiKTeX distribution of TeX for Windows (a native port)
at http://www.miktex.de/ (probably others too, but that's the one I use).
It was invented for Unix-like systems so will probably be included with any
TeX distribution.

No direct conversion to MSWord docs as far as I know, but if you really need
it I'm sure there are ways of converting some of the output formats to RTF
or something.

Since it's not a cygwin port, it's a bit off-topic here.  For further
information, try the newsgroup comp.text.tex or, for questions specific to
the Win32 port, the MiKTeX mailing list (see the website above).

Paul

--
Want to unsubscribe from this list?
Send a message to cygwin-unsubscribe@sourceware.cygnus.com