[PYTHON DOC-SIG] Internals documentation: what format?

[Guido van Rossum]

> I'd like the stuff on the python internals(*) that I started yonks ago
> to be finished up at some point - but I'm really not all that happy with
> the current format for the text (pod). Does anyone have suggestions for
> a better format for this stuff? I want to be able to generate HTML, and
> also something nicer, and I'd also like it to be fairly easy to write.

How about doc strings?  Jim Fulton continues to threaten to give us
tools that will generate the documentation from doc strings, even if
they are embedded in C source...

--Guido van Rossum (home page: http://www.python.org/~guido/)

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

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