- added several JavaDocs