JDK-8205590 : API Documentation should include one more tab for "added methods"
  • Type: Enhancement
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 8,9,10,11
  • Priority: P4
  • Status: Closed
  • Resolution: Duplicate
  • Submitted: 2018-06-21
  • Updated: 2022-07-12
  • Resolved: 2018-11-14
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.
JDK 12
12Resolved
Related Reports
Duplicate :  
JDK-8157000 - Do not generate javadoc for overridden method with no spec change
Description
A DESCRIPTION OF THE PROBLEM :
Q?: How will you know which methods NavigableSet (for example) adds to its parent SortedSet, because of which its suggested name should be NavigableSet?

On Page 
https://docs.oracle.com/javase/8/docs/api/java/util/NavigableSet.html 

We have three tabs "All Methods", "Instance Methods" and "Abstract Methods" but none "Added Methods".

Definitively if we are giving the name Navigable, it is because it might be adding Navigable Capabilities , but what are those capabilities?
Its documentation responsibility to list those unique capabilities that are new from its parent SortedSet.
What is the Need? Because i go to documentation to learn and understand every class and interface, but not just to list all methods. If i would like to list all methods which i can use, which i might, when may be i am actually developing but not basically learning mode, i will probably already be in an editor like net-beans, and i will press "."  to list all choices. But will prefer to go to documentation page  when i am in learning mode to understand relative differences in all classes.
Comments
This may have been indirectly covered by JDK-8157000, which suppresses methods that have been overridden without being redefined. (Those methods are now just listed in the "methods inherited from" sections. As a result, "all" the methods listed in the summary table are different from the methods inherited from supertypes, and so no additional tab is necessary.
14-11-2018