Description Randy Hudson 2004-06-17 11:45:00 EDT

When overriding a method, incorrect javadoc is displayed
If you use:
/*
 * @see MySuperclass#theMethodName()
 */

Then the tooltips will display the superclass' Javadoc.  But, if you use:
/**
 * @see MySuperclass#theMethodName()
 */

Then no description is displayed. This is the incorrect behavior because 
javadoc.exe will copy down the description from the superclass when it is empty.

The reason we are using the latter form is that our code-auditing program 
requires some form of javadoc to be present.  See also bug 24227, since an 
empty description is essentially an implicit {@inheritdoc}.