Update documentation for the lookup method.

This pull request fixes #261 and borrows documentation from the real man page. This is based on the changes made in the epydoc -> sphinx PR #256