Re: [Python-Dev] [Python-3000] Finishing up PEP 3108

On Sat, May 31, 2008 at 11:33 AM, Georg Brandl <g.brandl@gmx.net> wrote:
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.
+1 from me. Would this mean that htmllib and sgmllib could be removed without further ado. Mark

Mark Dickinson schrieb:
On Sat, May 31, 2008 at 11:33 AM, Georg Brandl <g.brandl@gmx.net <mailto:g.brandl@gmx.net>> wrote:
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.
+1 from me. Would this mean that htmllib and sgmllib could be removed without further ado.
OK, I've now implemented this in the trunk (will merge to 3k soon -- htmllib and sgmllib can go then). The topic help is contained in a new module, pydoc_topics.py, which pydoc imports to provide this help. The module can be generated with Sphinx by running "make pydoc-topics" in the Doc/ directory. (This is one more step for the release process, but it is an easy one.) The module is currently ~ 400 kb in size. If this is deemed to be a problem, we could use zlib to compress the contents -- which of course is bad for systems without the zlib module (are there any?). Georg -- Thus spake the Lord: Thou shalt indent with four spaces. No more, no less. Four shall be the number of spaces thou shalt indent, and the number of thy indenting shall be four. Eight shalt thou not indent, nor either indent thou two, excepting that thou then proceed to four. Tabs are right out.

The module is currently ~ 400 kb in size. If this is deemed to be a problem, we could use zlib to compress the contents -- which of course is bad for systems without the zlib module (are there any?).
In the distribution, the file gets compressed, anyway. In the installation, I don't think it is a problem. Regards, Martin
participants (3)
-
"Martin v. Löwis"
-
Georg Brandl
-
Mark Dickinson