Re: FAQ formatting

---------

Tom Lane (tgl@sss.pgh.pa.us)
Mon, 27 Jan 1997 11:25:07 -0500


> I'm strongly compelled by the benefits of multiple-
> format documents. I'd like to put out ASCII, HTML, and Postscript versions
> of the same file. The only means that I've come across for doing this is
> the highly powerful, though somewhat kludge-y approach of redoing the
> entire file in LaTeX or one of its variants.

Other approaches you might consider are (a) the "texinfo" system used for
documentation in GNU emacs and related FSF stuff; (b) the "linuxdoc"
toolset that's being used for Linux HOWTOs and related documentation.

texinfo has a very LaTeX-like feel, while linuxdoc is SGML-based and is
pretty close to regular HTML. Both, however, are supposedly designed to
produce heavily cross-referenced, sectioned documents like program manuals
and FAQs.

The last time I tried to use linuxdoc for anything serious, I decided it
wasn't quite ready for prime time yet. But that was over a year ago.

texinfo stuff can be found at your nearest FSF archive (eg.,
prep.ai.mit.edu), linuxdoc at any Linux archive (try poking around under
http://sunsite.unc.edu/pub/Linux/docs/INDEX.html).

regards, tom lane



[ Usenet Hypertext FAQ Archive | Search Mail Archive | Authors | Usenet ]
[ 1993 | 1994 | 1995 | 1996 | 1997 ]

---------

faq-admin@landfield.com

© Copyright The Landfield Group, 1997
All rights reserved