-
Enhancement
-
Resolution: Duplicate
-
P4
-
8, 9, 10, 11
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.
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.
- duplicates
-
JDK-8157000 Do not generate javadoc for overridden method with no spec change
- Resolved