updated JavaDocs