[PYTHON DOC-SIG] Documentation format

[Guido van Rossum]

I'm trying to follow this discussion without reading every message...

For standard C modules like posix, am I supposed to have the complete
text of the manual section for that module in the C source?  Should it
be accesseble at runtime?  I'm not sure this is an ideal solution (for
one thing, large amounts of plain text are a pain to type in Emacs' CC
mode).

If this is not happening, we still have the question of what
documentation format to use (also for things like the reference
manual, the tutorial and the extending/embedding manual, which will
never be contained in docstrings).  How feasible is @texinfo or ILU's
TIM (which looks like an extension of @texinfo)?

--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
=================