PyDoc lists all files present in a package directory in
a "Package Contents" table instead of only the ones
listed in __all__ variable in __init__.py file.

This is very inconvenient for packages which are
wrappers for some C library since the shared library
and a Wrapper get the reference on the package page but
then they do not have any comments and their pages are
not generated. As a result package page has those
annoying dead links.

One can probably fix this by creating a special dummy
pages for those unused files but it's an agly solution.
I do believe that using __all__ variable from
__init__.py file when it is defined is more appropriate
way to know what files represent the contents of the
package.

Cheers,
Igor

Logged In: YES 
user_id=995711

Interestingly, the patch to do this is very small since
__all__ variable is already heavy used for other items.

Hope it will help,
Igor

I don't think that it is common practice to list submodules in __all__,
only names really exported from the package.  Therefore, this does not
seem like a good change to make.