Fixes #1 and #2 by adding a few helper methods and cleaning up the logging.  Added additional documentation to the readme file.