update javadoc + comments for subclasses