closes #2 (adding JavaDocs comments)