Mail Archives: cygwin/1999/11/25/05:59:31
> From: Brendan Simon [mailto:bsimon AT ctam DOT com DOT 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 AT sourceware DOT cygnus DOT com
- Raw text -