枚举的Javadoc始终使用字母顺序显示其常量。有可能改变吗?
例如,如果未将常量显示为FRIDAY,MONDAY,SATURDAY,SUNDAY,THURSDAY TUESDAY,WEDNESDAY,则javadoc for java.time.DayOfWeek
看起来会更好。
最佳答案
默认的HTML doclet对其成员的摘要进行排序。
Collections.sort(members);
来自/com/sun/tools/doclets/internal/toolkit/builders/MemberSummaryBuilder.java :312
最好不要这样做。
Javadoc将摘要按字母顺序排列,以便您可以快速找到所需的摘要。破坏该模型将使Javadoc更加难以快速扫描和查找所需内容。
字母顺序仅适用于摘要,完整的Javadoc将按照源文件中的declecle顺序排列。
如果您确实需要执行此操作,则可以滚动自己的doclet或taglet也许可以执行此操作。