Update documentation to clarify a couple methods.

Change-Id: Iad2cb8f49757596c8b82931ad1908d5c7258e38c
Merge pull request #61 from robertmaynard/update_docs

Update documentation to clarify a couple methods.