more javadoc guidelines