some javadoc improvements