[Python-bugs-list] [ python-Bugs-405554 ] pydoc should be integrated with HTML doc

[noreply@sourceforge.net]

Bugs item #405554, was opened at 2001-03-02 15:09
You can respond by visiting: 
http://sourceforge.net/tracker/?func=detail&atid=105470&aid=405554&group_id=5470

Category: Python Library
Group: Feature Request
Status: Open
Resolution: None
Priority: 5
Submitted By: Guido van Rossum (gvanrossum)
Assigned to: Ka-Ping Yee (ping)
Summary: pydoc should be integrated with HTML doc

Initial Comment:
I really like pydoc, but it misses one feature compared
to perldoc: often the *good* documentation for a module
or class is in the library reference manual.  There
should be a way to get that integrated with the stuff
that pydoc extracts from the doc strings. 

(Wasn't this Paul Prescod's original idea?)


----------------------------------------------------------------------

Comment By: Garth T Kidd (gtk)
Date: 2001-07-29 23:28

Message:
Logged In: YES 
user_id=59803

I haven't seen anything in the library reference that 
couldn't be sucked directly out of the source by some 
appropriate combination of formally parseable docstrings 
(PEP-256, PEP-256) and some suitable markup format 
(structuredtext.sf.net). :) 

As a less mind-bending alternative, the docstring 
processing framework importantly leaves dereferencing links 
to the caller. If you decide on a standard way of 
referencing pages in the manual, module authors will need 
only insert simple links in their docstrings to refer to 
the [externally maintained] documentation:: 

  Please refer to `ftp-objects`_ for more detail. 

... or::

  Please refer to `FTP Objects`_ for more detail. 

  .. _FTP Objects: %(ftp-objects)

... or whatever. 

Someone, tell me I'm nuts. :) 

----------------------------------------------------------------------

Comment By: Ka-Ping Yee (ping)
Date: 2001-04-13 05:59

Message:
Logged In: YES 
user_id=45338

Although there is now some integration with the
reference manual, this issue is still largely
unaddressed, since we haven't decided how to
present the two kinds of documentation
together or whether to merge them somehow.

Leaving this open for now.

----------------------------------------------------------------------

You can respond by visiting: 
http://sourceforge.net/tracker/?func=detail&atid=105470&aid=405554&group_id=5470