The first sentence of javadoc is used as a summary for this class. It looks like the "This is a Java stub" paragraph is the same for many classes. That makes it clearly not a summary. It seems you may want to reorganize the docs so that the more informative line is first.