Georg Brandl wrote:
Brett Cannon schrieb:
Issue 2873 - htmllib is slated to go, but pydoc still uses it. Then
again, pydoc is busted thanks to the new doc format.
I will try to handle this in the coming week.
Fred had the interesting suggestion of removing pydoc in Py3K based on
the thinking that documentation tools like pydoc should be external to
Python. With the docs now so easy to generate directly, should pydoc
perhaps just be gutted to only what is needed for help() to work?
pydoc is fine for displaying docstring help, and interactive help.
This should stay.
Of course, it would also be nice for ``help("if")`` to work effortlessly,
which it currently only does if the generated HTML documentation is
available somewhere, which it typically isn't -- on Unix most distributions
put it in a separate package (from which pydoc won't always find it
of its own), on Windows only the CHM file is distributed and must be
decompiled to get single HTML files.
Now that the docs are reST, the source is almost pretty enough to display
it raw, but I could also imagine a "text" writer that removes the more
obscure markup to present a casual-reader-friendly text version.
The needed sources could then be distributed with Python -- it shouldn't
be more than about 200 kb.
The versioned documentation will sometimes be available from the
Internet if you want to think about using that as a fallback source. It
*would* be nice if help("if") worked.
It would be even handier if help(if) worked, but that's a syntax
problem, and it would be a horrendous one to overcome, I suspect.
regards
Steve
--
Steve Holden +1 571 484 6266 +1 800 494 3119
Holden Web LLC http://www.holdenweb.com/
_______________________________________________
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe:
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
