Ted Leung on the air
Ted Leung on the air: Open Source, Java, Python, and ...
Ted Leung on the air: Open Source, Java, Python, and ...
Wed, 14 Jan 2004
pydoc
When you are new to Python, and I consider myself new after a year of working on pyblosxom and a few months on Chandler, you still end up flipping through documentation.
Today I discovered the command line pydoc tool, which give you man like functionality for Python. This is pretty useful, but not as useful as it could be. The best man tool that I ever used was tkman, which was a Tk based man page browser, which also used glimpse to index the pages. That made it a lot more useful. It's to bad that glimpse has gone away, I constantly find situations where I could use it. Of course, I could use Lucene.... The snappiness of Mail.app's indexed search is one factor that convinced me to bag Thunderbird. The handling of threads (while not perfect) was another.
My other discovery was two functions related to info files in Emacs:
[23:14] |
[computers/programming/python] |
# |
TB |
F |
G |
2 Comments |
info-complete-symbol
and info-lookup-symbol
, which work off of Info files. So I grabbed the info versions of the Python documentation, appended the directory to Info-additional-directory-list
, and now I can complete symbols from the Python standard libraries, and look up their documentation from inside Emacs.
![Other blogs commenting on this post](/py-bin/images/bubble.gif)
Pydoc comes with a built in gui/http server. Run pydoc with the '-g' switch to run an http server with a little gui window to control it.
Posted by Andy Todd at Fri Jan 16 08:05:52 2004
Posted by Andy Todd at Fri Jan 16 08:05:52 2004
Does this work with xemacs? I have never tried Info-lookup-symbol before. Looks cool, but invoking info-lookup-symbol asks for a mode, and python is not one of the choices.
Maybe xemacs needs an updated info-look.el?
Posted by Neal Becker at Mon Jan 19 06:25:11 2004
Maybe xemacs needs an updated info-look.el?
Posted by Neal Becker at Mon Jan 19 06:25:11 2004
You can subscribe to an RSS feed of the comments for this blog:
Add a comment here:
You can use some HTML tags in the comment text:
To insert a URI, just type it -- no need to write an anchor tag.
Allowable html tags are:
You can also use some Wiki style:
URI => [uri title]
<em> => _emphasized text_
<b> => *bold text*
Ordered list => consecutive lines starting spaces and an asterisk
![RSS Feed for comments](http://www.sauria.com/py-bin/images/xml.gif)
To insert a URI, just type it -- no need to write an anchor tag.
Allowable html tags are:
<a href>
, <em>
, <i>
, <b>
, <blockquote>
, <br/>
, <p>
, <code>
, <pre>
, <cite>
, <sub>
and <sup>
.You can also use some Wiki style:
URI => [uri title]
<em> => _emphasized text_
<b> => *bold text*
Ordered list => consecutive lines starting spaces and an asterisk