[PYTHON DOC-SIG] Self-documenting code.. :-)

[Fred L. Drake]

> Hmm I just thought of it targetting the documentation in the python
> code, but it could probably be easy to show the code too.. and maybe
> edit it.. and.. uhm get it written.. :-)

  Sounds like some folding modes are in order.  The reason I suggest
the parser module is that what you end up working with is structured
exactly as the interpreter sees it; you could create an augmented
parse tree with any additional display and folding information you
need fairly easily, and filling in something like a Tkinter.Text
widget becomes a depth-first traversal of the tree.

> A close integration to, or at least look at gendoc is a good idea.. if
> it is what I think it is..

  There might be some usable intermediate structures which can be
used.  Also, gendoc allows you to work by either parsing source files
or importing them, depending on whether the code is trusted.


  -Fred

--
Fred L. Drake, Jr.
fdrake@cnri.reston.va.us
Corporation for National Research Initiatives
1895 Preston White Drive
Reston, VA    20191-5434

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

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