JDK-8144034 : "Automatic Copying of Method Comments" doesn't always give preference to interfaces over superclasses
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 6,7,8,9
  • Priority: P4
  • Status: Resolved
  • Resolution: Duplicate
  • Submitted: 2015-11-25
  • Updated: 2023-01-26
  • Resolved: 2022-05-17
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
Other
tbd_majorResolved
Related Reports
Duplicate :  
JDK-6376959 - Algorithm for Inheriting Method Comments seems to go not as documented
Relates :  
JDK-8144156 - Fix typos and errors in javadoc tool page
Description
Here are some examples can be found in the javadoc.

* http://docs.oracle.com/javase/8/docs/api/javax/naming/directory/BasicAttribute.html#clone--

(description should've been copied from Attribute#clone)

* https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ConcurrentHashMap.KeySetView.html#hashCode--

(description should've been copied from Set#hashCode)

------------
http://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html#CHDEDCCA
Comments
Closing as a duplicate of JDK-6376959.
17-05-2022
Guys, I was wondering if this should be raised as a separate issue or can piggyback on this one? The description of the tool, namely the algorithm, has a typo (if I'm not mistaken): "...Look in each directly implemented (or extended) interface in the order they appear following the word implements (or extends) in the method declaration. Use the first documentation comment found for this method..." should be: "...Look in each directly implemented (or extended) interface in the order they appear following the word implements (or extends) in the type declaration. Use the first documentation comment found for this method..." (method -> type)
31-08-2020
+1
25-11-2015
Checked the new doclet the bug is present there as well.
25-11-2015