Please start doc comments with capital letter and end with period. The javadoc tool will use the first sentence in the summary tables at the beginning of each page. E. g.: http://docs.oracle.com/javase/6/docs/api/java/lang/String.html → Field Summary, Constructor Summary, etc.