[Doc-SIG] Python docs in reST?

Bill Janssen janssen at parc.xerox.com
Fri May 20 00:58:50 CEST 2005


> Do you really think that troff is suitable for large, modern
> documentation?

Yes.  Entire operating systems have been documented with it.  In
addition, the excellent GNU Troff (groff) system by James Clark and a
host of others will produce Postscript or HTML output, among other
formats.

But I like even simpler systems, such as runoff or roff.

> How many people would have to learn it?

For my purposes, two or three.

> How easy is it to install it on Windows?

No idea.  I try to avoid that particular tarpit.

> How good are the PDFs generated from it?

Very good.

> How is it converted to HTML?

The tool "grops" included with groff.

Bill


More information about the Doc-SIG mailing list