JDK-8151146 : The order of enum constants is different from the previous version
Type:Bug
Component:tools
Sub-Component:javadoc(tool)
Affected Version:9
Priority:P3
Status:Resolved
Resolution:Not an Issue
Submitted:2016-03-03
Updated:2019-12-04
Resolved:2017-08-08
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.
In the previous javadoc (JDK 8) the section "Enum Constant Detail" listed constants in the order they appeared in the source code.
Now it seems to be the same order as in the section "Enum Constant Summary" (lexicographical?)
Comments
[~prappo] I guess it's mildly surprising, at least in this case, or maybe the case of enums, where there is a strong inherent ordering, but it is consistent with the general policy of alpha-sorting the summary, and natural-sorting the details.
04-12-2019
[~ksrini] Understood. I guess it's not always surprising, but sometimes it is. See https://docs.oracle.com/en/java/javase/13/docs/api/java.base/java/time/Month.html
04-12-2019
I'm surprised it's been Resolved/Not An Issue, because it was an issue, and has been resolved.
08-08-2017
Right, the Summary sections are all alpha-sorted to allow viewers to quickly locate a member,
and the Details sections are listed as it appears in the code, this was/is a deliberate decision.