[Doc-SIG] Where to find the docs

[Ka-Ping Yee]

Where does the documentation normally reside on Unix and Mac
platforms?  (Or, alternate question: why isn't the documentation
part of the main distribution archive on these platforms?)

At the moment, pydoc is looking in:

    os.environ.get('PYTHONDOCS')

Setting the environment variable has highest priority.  Then:

    os.path.join(os.environ.get('PYTHONHOME'), 'doc')
    os.path.join(os.path.basename(sys.executable), 'doc')

These work for Windows, and work for Mac *if* you choose to unpack
the docs into the 'doc' subdirectory of Python's home -- but you
have to rename the unpacked folder manually.

Then, for Unix:

    '/usr/doc/python-docs-' + split(sys.version)[0]
    '/usr/doc/python-' + split(sys.version)[0]
    '/usr/doc/python-docs-' + sys.version[:3]
    '/usr/doc/python-' + sys.version[:3]

The most logical place i would expect the docs to reside is
/usr/doc/python-2.1.  But the last Python documentation RPMs
i installed used /usr/doc/python-docs-1.5.2 and
/usr/doc/python-docs-2.0.  Hence the above.

Other RPMs i have seen put the documentation in
/usr/share/doc/python-docs-2.0.  Should this be added?

Is there a standard place to look?

Thanks,


-- ?!ng