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 171326

Summary: [C/C++] Generating classes/methods comment skeletons in code editor
Product: cnd Reporter: skip5500 <skip5500>
Component: -- Other --Assignee: Alexander Simon <alexvsimon>
Status: RESOLVED FIXED    
Severity: blocker CC: fwgx
Priority: P2    
Version: 6.x   
Hardware: All   
OS: All   
Issue Type: ENHANCEMENT Exception Reporter:

Description skip5500 2009-09-02 14:50:04 UTC 
It would be nice to have the ability to quickly generate comments in code editor.

For example, when coding in Java you can type /** followed by enter above a method declaration. It generates a nice
javadoc-compliant comment skeleton (with @param and @return) which you can adapt.

It makes documenting much less error prone and cumbersome, especially if you plan to generate an HTML code
documentation. I think that doxygen tags might be the best for this purpose.
Comment 1 Alexander Simon 2009-10-07 14:09:16 UTC 
partly fixed in change set:
http://hg.netbeans.org/cnd-main?cmd=changeset;node=72133d3a46f6

fixed use case:
/***/
int foo(int arg){
    return 0;
}
Cursor position is /**|*/.
Press enter.
Result is:
/**
 *
 * @param arg
 * @return
 */
int foo(int arg){
    return 0;
}
It is important to have well formed comments. If comment is not completed the doc generation does not work.
Comment 2 Quality Engineering 2009-10-09 22:55:14 UTC 
Integrated into 'main-golden', will be available in build *200910091401* on http://bits.netbeans.org/dev/nightly/ (upload may still be in progress)
Changeset: http://hg.netbeans.org/main-golden/rev/72133d3a46f6
User: Alexander Simon <alexvsimon@netbeans.org>
Log: fixing IZ#171326 [C/C++] Generating classes/methods comment skeletons in code editor
Comment 3 Irina Filippova 2010-02-17 09:24:44 UTC 
This issue erroneously got into the usersguide module. Changing to cnd