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.

Bug 60941

Summary: Tool to reformat Javadoc to fit within line size soft limit
Product: java Reporter: janicki <janicki>
Component: JavadocAssignee: s28257902
Status: NEW ---    
Severity: blocker CC: dbalek, jkovalsky, kapitarg, olegsukhodolsky
Priority: P2 Keywords: NETFIX
Version: 5.x   
Hardware: All   
OS: All   
Issue Type: ENHANCEMENT Exception Reporter:
Bug Depends on: 20672    
Bug Blocks: 59545    

Description janicki 2005-07-13 17:20:09 UTC 
This enhancement request is regarding javadoc blocks, especially those that are later edited causing the 
original line breaks to look ragged as lines are lengthened/shortened. 

Use "Text Limit Character Count" setting from the editor (the one that draws the subtle vertical line 
through the text editor) to reformat javadoc paragraphs to fit.  In the simplest case, just break up long 
lines.  More complicated reformatting would join short lines, but would need to respect any blank lines 
or single lines containing <p> or <br>?  Also, should consider indents for tags (@param, @return, etc.) 
that span multiple lines.

I think this tool should only act on the currently selected javadoc block, and optionally on the entire 
file.  Maybe as submenu choices under "Reformat Code"?

The relatively new feature to auto-prefix a "*" in javadoc line helps a lot, but this enhancement would 
further reduce unproductive programmer keystrokes.
Comment 1 _ moser 2007-05-02 09:26:20 UTC 
In the latest dev builds, the "Refomat code" feature has been greatly improved.
Unfortunately it does nothing to javadoc, which is a must have in my eyes.
Line-wrapping, reordering params and inserting blank lines again and again must
be done manually or using external tools like Jalopy. Please consider to
implement this improvement in 6.0.

Also in my eyes this prblem is a "Highly visible usability problem" to allow P3
for this issue.
Comment 2 Jan Pokorsky 2007-10-24 14:51:26 UTC 
Raising priority. I would like to target this in the next release. It should be implemented using the new Editor
Indentation API.
Comment 3 Jan Becicka 2008-06-25 15:46:35 UTC 
Is it doable for 6.5?
Comment 4 kapitarg 2010-04-22 20:13:10 UTC 
I'd like to NetFIX [1] this bug. Is it possible?

[1] http://wiki.netbeans.org/NetFIX"
Comment 5 Jiri Kovalsky 2010-04-26 18:30:52 UTC 
Yes, Honza Lahoda promised to review and integrate your patch. Good luck Gabor!