Hi! It's my birthday today, and i think it would be a really awesome present if pydoc.py were to be accepted into the distribution. :) (Not just because it's my birthday, though. I would hope it is worth accepting based on its own merits.) The most recent version of pydoc is just a single file, for the easiest possible setup -- zero installation effort. You only need the "inspect" module to run it. You can find it under the CVS tree at nondist/sandbox/help/pydoc.py or download it from http://www.lfw.org/python/pydoc.py http://www.lfw.org/python/inspect.py Among other things, it now handles a few corner cases better, the formatting is a bit improved, and you can now tell it to write out the documentation to files on disk if that's your fancy (it can still display the documentation interactively in your shell or your web browser). -- ?!ng
It's my birthday today, and i think it would be a really awesome present if pydoc.py were to be accepted into the distribution. :)
Congratulations, Ping.
(Not just because it's my birthday, though. I would hope it is worth accepting based on its own merits.)
No, it's being accepted because your name is Ping. I just read the first few pages of the script for Monty Python's Meaning of Life, which figures a "machine that goes 'Ping'". That makes your name sufficiently Pythonic.
The most recent version of pydoc is just a single file, for the easiest possible setup -- zero installation effort. You only need the "inspect" module to run it. You can find it under the CVS tree at nondist/sandbox/help/pydoc.py or download it from
http://www.lfw.org/python/pydoc.py http://www.lfw.org/python/inspect.py
Among other things, it now handles a few corner cases better, the formatting is a bit improved, and you can now tell it to write out the documentation to files on disk if that's your fancy (it can still display the documentation interactively in your shell or your web browser).
You can check these into the regular tree. I guess they both go into the Lib directory, right? Make sure pydoc.py is checked in with +x permissions. I'll see if we can import pydoc.help into __builtin__ in interactive mode. Now let's paaaartaaaay! --Guido van Rossum (home page: http://www.python.org/~guido/)
On Mon, Feb 26, 2001 at 09:08:36PM -0500, Guido van Rossum wrote:
You can check these into the regular tree. I guess they both go into the Lib directory, right? Make sure pydoc.py is checked in with +x permissions. I'll see if we can import pydoc.help into __builtin__ in interactive mode.
What about installing it as a script, into <prefix>/bin, so it's also available at the command line? The setup.py script could do it, or the Makefile could handle it. --amk
On Mon, Feb 26, 2001 at 09:08:36PM -0500, Guido van Rossum wrote:
You can check these into the regular tree. I guess they both go into the Lib directory, right? Make sure pydoc.py is checked in with +x permissions. I'll see if we can import pydoc.help into __builtin__ in interactive mode.
What about installing it as a script, into <prefix>/bin, so it's also available at the command line? The setup.py script could do it, or the Makefile could handle it.
Sounds like a good idea. (Maybe idle can also be installed if Tk is found.) Go for it. --Guido van Rossum (home page: http://www.python.org/~guido/)
On Tue, Feb 27, 2001 at 12:04:28AM -0500, Guido van Rossum wrote:
Sounds like a good idea. (Maybe idle can also be installed if Tk is found.) Go for it.
Will do. Is there anything else in Tools/ or Lib/ that could be usefully installed, such as tabnanny or whatever? I can't think of anything that would be really burningly important, so I'll just take care of pydoc. Re: IDLE: Martin already contributed a Tools/idle/setup.py, but I'm not sure how to trigger it recursively. Perhaps a configure option --install-idle, which controls an idleinstall target in the Makefile. Making it only install if Tkinter is compiled seems icky; I don't see how to do that cleanly. Martin, any suggestions? --amk
On Tue, Feb 27, 2001 at 12:04:28AM -0500, Guido van Rossum wrote:
Sounds like a good idea. (Maybe idle can also be installed if Tk is found.) Go for it.
Will do. Is there anything else in Tools/ or Lib/ that could be usefully installed, such as tabnanny or whatever? I can't think of anything that would be really burningly important, so I'll just take care of pydoc.
Offhand, not -- idle and pydoc seem to be overwhelmingly more important to me than anything else...
Re: IDLE: Martin already contributed a Tools/idle/setup.py, but I'm not sure how to trigger it recursively. Perhaps a configure option --install-idle, which controls an idleinstall target in the Makefile. Making it only install if Tkinter is compiled seems icky; I don't see how to do that cleanly. Martin, any suggestions?
I have to admit that I don't know what IDLE's setup.py does... :-( --Guido van Rossum (home page: http://www.python.org/~guido/)
On Mon, Feb 26, 2001 at 11:52:28PM -0800, Ka-Ping Yee wrote:
It's my birthday today, and i think it would be a really awesome present if pydoc.py were to be accepted into the distribution. :)
It has my vote ;) I think pydoc serves two purposes: it's a useful tool, especially if we can get it accepted by the larger community (get it mentioned on python-list by non-dev'ers, get it mentioned in books, etc.) And it serves as a great example on how to do things like introspection. -- Thomas Wouters <thomas@xs4all.net> Hi! I'm a .signature virus! copy me into your .signature file to help me spread!
participants (5)
-
Andrew Kuchling -
Guido van Rossum -
Ka-Ping Yee -
Skip Montanaro -
Thomas Wouters