some javadoc  written