homepage

If pydoc is used to try to look up the documentation for a module which
does not exist, this is reported reasonably:
 exarkun@charm:~$ pydoc foobarbaz
 no Python documentation found for 'foobarbaz'
 
 exarkun@charm:~$
However, if it is used to look up the documentation for a module which
does exist but which itself imports a module which does not exist, then
the same report is made:
 exarkun@charm:~$ cat > foobarbaz.py
 import barbazquux
 exarkun@charm:~$ pydoc foobarbaz
 no Python documentation found for 'foobarbaz'
 
 exarkun@charm:~$
This is somewhat misleading, since it suggests that there is no such
module "foobarbaz", when the problem is solved by installing the module
"barbazquux":
 exarkun@charm:~$ touch barbazquux.py
 exarkun@charm:~$ pydoc foobarbaz
 Help on module foobarbaz:
 ...
 exarkun@charm:~$ 
I'm sure the cause of this is the incautious handling of ImportError by
pydoc, resulting in the mistaken identification of the problem.