Bug 167823

Summary: [type wizards] Generate comment option in new class wizard should use JavaDoc of Super-Class
Product: [Eclipse Project] JDT Reporter: Ulli Hafner <Knut.Friedhelm>
Component: UIAssignee: JDT-UI-Inbox <jdt-ui-inbox>
Status: ASSIGNED --- QA Contact:
Severity: enhancement    
Priority: P3    
Version: 3.3   
Target Milestone: ---   
Hardware: PC   
OS: Windows XP   
Whiteboard:
Bug Depends on:    
Bug Blocks: 169178    

Description Ulli Hafner CLA 2006-12-13 05:20:35 EST
When I'm using the create new class wizard and activating the options "generate comments" and "create constructors" the new class will get the constructors of the super class. It would be nice, if the generated comment would also contain the JavaDoc text of the @param tags of the super class. Currently only the name of the parameter is used (e.g., @param name) and not (@param name "documentation of parameter in super class).

My constructor template:
/**
 * Creates a new instance of <code>${enclosing_type}</code>.
 * ${tags}
 */

After creating a new class (sub-class of DiffNode), I get the following:
    /**
     * Creates a new instance of <code>MergeDiffNode</code>.
     * @param kind
     */
    public MergeDiffNode(int kind) {
        super(kind);
        // TODO Auto-generated constructor stub
    }

What I rather would expect is the following:
    /**
     * Creates a new instance of <code>MergeDiffNode</code>.
     * @param kind of difference (defined in <code>Differencer</code>)
     */
    public MergeDiffNode(int kind) {
        super(kind);
        // TODO Auto-generated constructor stub
    }