views:

195

answers:

6

Is it just me, or the python standard library documentation is extremely difficult to browse through?

Java has its brilliant Javadocs, Ruby has its helpful Ruby-Docs, only in python I cannot find a good way to navigate through the standard library documentation.

There's the Epydoc project, which looks nice, but does anyone know if it is actually being used on the standard library, so we can all go through it? If not, what are the alternatives people are using to browse python documentation.

+2  A: 

you can go to here and download the chm version of Python 3.1. With that, searching through the docs should be easy.

ghostdog74
+5  A: 

I usually use the built-in pydoc, if you are on windows it should be called Module Docs if you are on linux use pydoc -p 8000 and connect through browser.

fn
+3  A: 

pydoc from the command line, help() from the interactive interpreter prompt.

Ignacio Vazquez-Abrams
+2  A: 

pydoc -p 8080

The python community is semi-hostile to automatically generated documentation, especially if it's Object-Orientated. Python isn't just object-orientated (it's a multi-paradigm language), so Python developers generally prefer human-written documentation. Sometimes the functions are important, sometimes the Class structure is important.

wisty
Yeah, I have tasted some of the hostility...
ivo
A: 

I used to use the python sidebar from Edgewall a long time ago.

These days, I google for the python function (the standard docs almost always show up as the first link).If I want to browse the source of the module (useful sometimes), I use this little shell function I wrote.

epy () {
    cmd="import $1 as a ; print a.__file__.endswith('.pyc') and a.__file__[:-1] or a.__file__" 
    file=$(/usr/bin/env python -c $cmd) 
    echo $file
    emacsclient --no-wait $file
}
Noufal Ibrahim
A: 

I guess I'm going to get downvoted but I find nothing wrong with the Sphinx docs and I find them way way better than the java alternative.

Jorge Vargas