finalized javadoc