This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.
the coding guidelines at this URL http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#tag recommend that the javadoc tags are entered into source in a set order. It would be useful if the AutoComment tool automatically re-ordered tags that are entered into this recommended order unless overridden by the user. There is a related defect on issue tracking with number 22727.
Target milestone was changed from not determined to TBD
Changing to low prio DEFECT since, javadoc code generator should follow Sun recomendation on how to write docs. Please change Target Milestone accordingly.
It could be the same bug: "Tools-> Correct Javadoc" changes the order of the tags too (only if something incorrect). @return at top. At next the @param tags (sometimes in wrong order). A leading blank line like this: /** * DocComment starts here was changed to /** DocComment starts here (there is another related enhancement issue). greetings, josh.
NB 4.0 should change the order of tags according to http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#tag
I'm taking responsibility for JavaDoc module.
*** Issue 22293 has been marked as a duplicate of this issue. ***
Issue 22293 except: If you add a comment to a class or method then the Auto Comment tool starts at the very first line, like this: /** This is a comment. * @param s parameter * @return return value */ But it should look like this: /** * This is a comment. * @param s parameter * @return return value */ If you try to workaround this by adding an empty line before the comment, then it is correct until you reedit the comment at a later time, because then, the blank line is being converted to a space.
http://java.netbeans.org/source/browse/java/srcmodel/src/org/openide/src/Element.java.diff?r1=1.3&r2=1.3.34.1 issue 30669 patch
[batch] Giving up javadoc issues exclusive ownership.
Fixed by new JMI based java module.
Reorganization of java component