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 mez
Recipients georg.brandl, mez, tim.golden
Date 2008-12-02.15:31:32
SpamBayes Score 2.7468013e-06
Marked as misclassified No
Message-id <1228231895.14.0.424941929733.issue4488@psf.upfronthosting.co.za>
In-reply-to
Content
Well, I can't offer a patch (as I said - I'm a python n00b) - but I can
offer suggestions.

1) show the functions as where they are - for example - splitext would
be shown as os.path.splitext(arguments)

2) header titles for groups within the same module. So splitext, etc
etc, would be under a visible title that says "os.path"

3) alternate documentation links by modules. So the documentation stays
the same, but there is also an alternate set which shows the same
things, but where the "up" button would take me from os.path to os
(showing that that is the module title) rather than the title being 
14.1.6 Miscellaneous System Information 

In fact - 3 exists - sort of, it just seems a little wrong.

Link 1: http://www.python.org/doc/2.5.2/lib/os-path.html
Title: 
14.1.6 Miscellaneous System Information 
How to get there:- Python Library Reference -> Generic Operating System
Services -> os -> Miscellaneous System Information 

Link 2: http://www.python.org/doc/2.5.2/lib/module-os.path.html
Title: 11.1 os.path -- Common pathname manipulations 
How to Get there:- Python Library Reference -> File and Directory Access
->  os.path -- Common pathname manipulations 

Link 2 seems to give the information in a good way - but didn't show on
my "quickly search google" radar. Plus, the way to get there seems
wrong. It should (IMO) be accessible through "Python Library Reference
-> modules -> os -> os.path" or something similar.
History
Date User Action Args
2008-12-02 15:31:35mezsetrecipients: + mez, georg.brandl, tim.golden
2008-12-02 15:31:35mezsetmessageid: <1228231895.14.0.424941929733.issue4488@psf.upfronthosting.co.za>
2008-12-02 15:31:34mezlinkissue4488 messages
2008-12-02 15:31:32mezcreate