Self-documenting Python??

[Gilles Lenfant]

I got the Mandrake rpm burn of Python. Same mess...
Delete this documents (installed by the rpm), download the full documents
set from www.python.org.
and put the first page (index.html) in your Netscape bookmarks...
Does this seem difficult ?

For the rest...
IDLE has syntax coloring and a path browser, try it.
put __doc__, __author__ and __version__ variables in each personal module
You can make pretty print with py2html with
http://www.lemburg.com/files/python/ or in PDF with a demo package from
reportlab http://www.reportlab.com

<nbecker at fred.net> a écrit dans le message news:
x881yvcfodl.fsf at adglinux1.hns.com...
> Has there been any proposals to integrate a documentation system with
> python?  I feel this is one feature that is sorely missing.
>
> We have a way to put some very minimal documentation into python
> sources, but there is no integrated help browser to use it.
>
> I use RedHat Linux here.  The standard Python docs are installed in a
> manner by the standard distribution that they are not accessible
> except by users sufficiently knowledgeable to know where and how to
> look for them.  Most people can use a web browser, but they don't know
> that /usr/share/doc/python.... has something of interest.
> Furthermore, documentation for user-written code is not accessible at
> all.
>
> I believe nothing would do more to further the wider acceptance of
> Python than integrated help.