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.
Summary: | Highlight to display comment. | ||
---|---|---|---|
Product: | platform | Reporter: | htokuda10 |
Component: | Documentation | Assignee: | Geertjan Wielenga <geertjan> |
Status: | NEW --- | ||
Severity: | normal | CC: | cezariusz, htokuda10 |
Priority: | P3 | ||
Version: | 8.1 | ||
Hardware: | PC | ||
OS: | Windows 8 x64 | ||
Issue Type: | ENHANCEMENT | Exception Reporter: | |
Attachments: | Example in PDF |
Description
htokuda10
2015-05-23 21:27:48 UTC
How about this: * View -> Code Folds -> Collapse All Javadoc * Tools -> Options -> Editor -> Folding -> Documentation And use a dev build to make the folding border less distracting (see bug 229039). Where would you like to store your nonstandard comments, and why do you want to invent something new if Javadoc works just fine? Created attachment 153833 [details]
Example in PDF
I was requested to provide more information. See below for additional details on this enhancement idea.
Attached you will find a PDF of an example of what I had in mind. I used an old project and photo shopped the images to display my idea. Currently NetBeans IDE has the ability to collapse "All Java Code" which makes searching for methods easier, "All JavaDocs" which collapses all JavaDoc specific commenting, "Fold Tree" which collapses the specific tree which the cursor is clicked in, and "Collapse All" which does exactly that. As for in-text comments, there is no clean way to hide these comments from view.
My suggestion was primarily the ability to be able to add a comment that will be hidden from view, but still immediately available when needed. Keeping the (//) as viewable in-text commenting is definitely a must, as this is a key feature to commenting lines of code out. Maybe a fourth type of commenting syntax that is NetBeans specific ("//*") that can be placed directly above the line that the comment is intended for. This allows the ability to display or hide all ("//*") type comments and make them accessible by highlight able markers. If the idea can be extended to other blocks of comments ("/**...*/" and "/*.../"), then that is great. This suggestion is intended to help provide a cleaner and more readable coding environment, with simplicity and efficiency in mind.
My suggestions for enhancements: 1. Add a code template to generate a folding block like this: // <editor-fold defaultstate="collapsed" desc="Some comment"> /** */ // </editor-fold> 2. Add an option to omit <editor-fold> when printing. |