Bug 169178

Summary: [generate delegate] generate delegate methods should copy JavaDoc of delegate
Product: [Eclipse Project] JDT Reporter: Ulli Hafner <Knut.Friedhelm>
Component: UIAssignee: JDT-UI-Inbox <jdt-ui-inbox>
Status: NEW --- QA Contact:
Severity: enhancement    
Priority: P3    
Version: 3.3   
Target Milestone: ---   
Hardware: PC   
OS: Windows XP   
Whiteboard:
Bug Depends on: 167823    
Bug Blocks:    

Description Ulli Hafner CLA 2006-12-28 07:19:36 EST
Hi, 

when using the Source->Generate Delegate Methods... wizard, there is an option to automatically generate the JavaDoc comments for the new methods. It would be nice, if there is an option (checkbox) to copy these comments exactly from the delegate class (instead of the link). Currently, only a reference to the delegate is generated:

E.g., I hava a member of type  

private RangeDifference rangeDifference;

When selecting the rangeDifference and invoking the wizard Source->Generate Delegate Methods..., then the following method is generated:

/**
 * @return
 * @see org.eclipse.compare.RangeDifference#ancestorEnd()
 */
public int ancestorEnd() {
    return rangeDifference.ancestorEnd();
}

It would rather be nice if the generated method would be (the comments are copied from the delegate RangeDifference):

/**
 * Returns the end index of the entity range on the ancestor side.
 *
 * @return the end index of the entity range on the ancestor side
 */
public int ancestorEnd() {
    return rangeDifference.ancestorEnd();
}