some javadoc written