Please use the Apache issue tracking system for new NetBeans 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 --- QA Contact: issues <>
Priority: P2 CC: dbalek, jkovalsky, kapitarg, olegsukhodolsky
Version: 5.xKeywords: NETFIX
Target Milestone: 6.x   
Hardware: All   
OS: All   
Whiteboard: plan61
Issue Type: ENHANCEMENT Exception Report:
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?

Comment 5 Jiri Kovalsky 2010-04-26 18:30:52 UTC
Yes, Honza Lahoda promised to review and integrate your patch. Good luck Gabor!
By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2014, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo