Mailing-List: contact cygwin-help AT sourceware DOT cygnus DOT com; run by ezmlm
List-Unsubscribe: <mailto:cygwin-unsubscribe-archive-cygwin=delorie DOT com AT sourceware DOT cygnus DOT com>
List-Subscribe: <mailto:cygwin-subscribe AT sourceware DOT cygnus DOT com>
List-Archive: <http://sourceware.cygnus.com/ml/cygwin/>
List-Post: <mailto:cygwin AT sourceware DOT cygnus DOT com>
List-Help: <mailto:cygwin-help AT sourceware DOT cygnus DOT com>, <http://sourceware.cygnus.com/ml/#faqs>
Sender: cygwin-owner AT sourceware DOT cygnus DOT com
Delivered-To: mailing list cygwin AT sourceware DOT cygnus DOT com
Message-ID: <FDEF8CA827DDD211906B0000F802E2A78A028A@pmkgbis4.icv.co.uk>
From: "Stephenson, Paul" <Paul DOT Stephenson AT primark DOT com>
To: bsimon AT ctam DOT com DOT au, CygWin32 <cygwin AT sourceware DOT cygnus DOT com>
Subject: RE: document converter for unix and win32.
Date: Thu, 25 Nov 1999 10:56:47 -0000
X-Mailer: Internet Mail Service (5.5.2650.21)

> 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