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 8200 - Interface synchronization should not copy Javadoc from declarer
Summary: Interface synchronization should not copy Javadoc from declarer
Status: CLOSED WONTFIX
Alias: None
Product: java
Classification: Unclassified
Component: Unsupported (show other bugs)
Version: 3.x
Hardware: PC Linux
: P4 minor (vote)
Assignee: issues@java
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2000-11-06 14:15 UTC by Jesse Glick
Modified: 2007-09-26 09:14 UTC (History)
1 user (show)

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Jesse Glick 2000-11-06 14:15:23 UTC
When I implement an interface and choose to accept the Synchronize feature,
generating implementations of the interface methods, it copies Javadoc from the
declaring abstract members. This is not really desirable from my point of view.
While it can be nice to see the Javadoc so you know what to implement, modern
(1.3) javadoc tool automatically copies the docs from the declaring member only
if you omit some or all of the Javadoc in the implementing member.

Suggest either an option to disable the copying of the Javadoc, or (better) copy
it but replace /** with /* so that it is informational only and not active, with
the understanding that the normal case is to use the super docs and if you want
to specify behavior of the implementation you have to edit the Javadoc anyway so
you should readd the extra asterisk.

On a related note: the Auto Comment tool should detect superclass Javadoc and
not show it as missing if you do not have it in the implementation class, since
that is more often than not intentional.
Comment 1 Jan Becicka 2001-01-31 11:08:59 UTC
*** This bug has been marked as a duplicate of 7115 ***
Comment 2 Quality Engineering 2003-07-01 13:12:41 UTC
Resolved for 3.3.x or earlier, no new info since then -> closing.
Comment 3 Quality Engineering 2003-07-01 13:20:39 UTC
Resolved for 3.4.x or earlier, no new info since then -> closing.