some javadoc improvments