javadoc improvments