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.
[Please close this if this kind of thing is already in the feature list for the editor, or if it is not reasonable to do it.] Desired feature for Java indentation engine: more control over formatting of Javadoc comments. Specifically, (1) automatic line break after end of summary sentence, and (2) keep comment all on one line if only summary and no tags, as is typical for field Javadoc, e.g.: /** Some short comment. */ vs.: /** Longer summary sentence. * This has additional sentences. */ (alternately:) /** Longer summary sentence. * This has additional sentences. */ or this: /** Comment. * @return this is a separate line */ Also nice would be indenting of long tags: /** Comment. * @param listener A listener which you can attach if * you want to know about changes. * @return Some long complicated story about exactly * what this could return in all cases. */ Of course <pre> blocks in Javadoc should be left untouched in all cases.
This is very reasonable enhancement. Thanx for it. There is already similar issue 11553, but it is only subset of this one, so I'm going to close it as duplicate.
Target milestone -> 3.3
Changing the state of the issue to ASSIGNED, because it was covered in Requirements document at http://editor.netbeans.org/doc/Requirements.html
Target milestone -> 3.3.1.
According to http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#generalform, format /** * Some comment. */ is preferred over /** Some comment. */
Set target milestone to TBD
Changing subcomponent to "setting"
Honzo, do you plan some work in this area?