Added some javadoc comments to methods in preparation for writing some
tests