Fix up documentation.
Merge pull request #1 from HitFox/improve_misleading_documentation

Fix up documentation.