[PYTHON DOC-SIG] New GENDOC released.

Robin Friedrich friedric@rose.rsoc.rockwell.com
Mon, 9 Sep 1996 11:28:40 -0500


Daniel Larsson has released gendoc 0.6 for your documentation 
pleasure. The big change here is the adoption of structured text
for the doc string formatting standard. (I will post up my HTMLgen
1.0 package tomorrow which uses this standard for it's doc strings
and the resulting online documentation turned out rather well.)
Check out http://www.python.org/sigs/doc-sig for the release and
a detailed explanation of the doc string format.

Daniel is off line for a month so I'll field as many questions
as I can. Below is from his README.

-Robin Friedrich



gendoc release 0.6
==================
Again, this release is done the day before my 4 week vacation
in Spain. This is a somewhat hasty release, so I guess I might
expect the Spanish inquisition when I come back. Anyways, most
setext markups are now gone in favor of Jim Fulton's structured
text approach. This means some new goodies, such as nested and
numbered lists, definition lists and nested headings.

Take a look in gendoc_test.py to see how to write your markups.
By my mistake, the previous releases missed the important file
'gendoc', which is the main program (just imports gendoc.py).
This is now corrected. The Makefile now uses BSD style install,
instead of the HP/UX convoluted version (thanks to David Morley,
morley@aaii.oz.au).

--
Daniel Larsson
dlarsson@sw.seisy.abb.se

=================
DOC-SIG  - SIG for the Python Documentation Project

send messages to: doc-sig@python.org
administrivia to: doc-sig-request@python.org
=================