update javadoc + comments