Community
Participate
Working Groups
The getter javadoc says: /** * Gets the name. * @return Returns a string */ It should be: /** * Returns the name. * @return returns the name */ I'm not sure about the second line, but I feel strongly about the first line. Also, I think the param lines should start with lower case letters.
These comments have no value and we should not generate them in this form. We either generate no comment or change the comment to: /** * * @return int */
fixed > f1
changed milestone from F1 to F2
pls verify
Need to clear resolution due to bugzilla bug (it changed the resolution to NEW)
Marking bug as fixed again (due to bugzilla bug)
Not fixed. Both Javdoc comments are not good if follwoing the Javadoc guidelines ("How to Write Doc comments fo Javadoc"). /** * Sets the f. * @param f The f to set */ 1) phrases (which are prefered to sentences) are not capitalized and don't end with a dot. 2) after the tag follows the parameter name. After that the first noun should be the data type (starting with lower letter). SPECIAL RULE: for the primitive type int the data type is omitted. See "How to Write Doc comments fo Javadoc" for detailed guidelines on how Javadoc should be written.
defer
This will be user configurable for 2.1. Closing