fixed comment
added a few JavaDocs