This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author skip.montanaro
Recipients
Date 2004-12-17.21:05:48
SpamBayes Score
Marked as misclassified
Message-id
In-reply-to
Content
Logged In: YES 
user_id=44345

Pydoc generates documentation based upon what it finds in
docstrings
and function signatures.  It can't get at the signatures of
functions
written in C.  In Python 2.4 pydoc generates a link to a
local or online
version of the docs for the subject module:

    NAME
	datetime - Fast implementation of the datetime type.

    FILE
	/Users/skip/local/lib/python2.5/lib-dynload/datetime.so

    MODULE DOCS
	http://www.python.org/doc/current/lib/module-datetime.html

    CLASSES
	__builtin__.object
	    date
		datetime
     ...

I think that's the best that can be done short of macroizing
the hell
out of C extension modules to allow function signatures to be
captured as attributes attached to the functions, similar to
what
GNU Emacs did many years ago.  Correct me if I'm wrong, but
I don't
think we want to go down that path (take a peek at the Emacs
source
if you are in doubt).
History
Date User Action Args
2007-08-23 14:28:34adminlinkissue1087216 messages
2007-08-23 14:28:34admincreate