Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 238852

Summary: No add @param to auto-generated Doxygen documentation if no params in method/function
Product: [Tools] CDT Reporter: Pablo Rogina <pablojr>
Component: cdt-coreAssignee: Andrew Ferguson <andrew.ferguson>
Status: RESOLVED FIXED QA Contact:
Severity: minor    
Priority: P3 CC: andrew.ferguson
Version: 5.0   
Target Milestone: 5.0.1   
Hardware: All   
OS: All   
Whiteboard:

Description Pablo Rogina CLA 2008-06-27 17:10:21 EDT
Build ID: I20080617-2000

Steps To Reproduce:
Right now the auto-generation is avoid the @return tag if no return type (void) but isn't avoid the @param if no params for function/method (void). Example:

/**
 *
 * @param
 */
void someFunction(void);

However, it's working fine if only empty parenthesis


/**
 *
 */
void someFunction();

More information:
Comment 1 Andrew Ferguson CLA 2008-07-01 11:51:48 EDT
Added test:
   DoxygenCCommentAutoEditStrategyTest.testAutoDocCommentContent21_238852()

marking as FIXED (5.0.1, 5.1)
Comment 2 Andrew Ferguson CLA 2008-07-02 10:43:23 EDT
I've reworked the fix as it would have regressed some other cases, see
   DoxygenCCommentAutoEditStrategyTest.testAutoDocCommentContent21_238852_a()
   DoxygenCCommentAutoEditStrategyTest.testAutoDocCommentContent21_238852_b()
   DoxygenCCommentAutoEditStrategyTest.testAutoDocCommentContent21_238852_c()
   DoxygenCCommentAutoEditStrategyTest.testAutoDocCommentContent21_238852_d()