Enums ordering in javadoc

2022-09-02 22:42:33

枚举的 Javadoc 始终使用字母顺序显示其常量。有可能改变这一点吗?

例如,如果常量不显示为星期五,星期一,星期六,星期日,星期四星期二,星期三,那么java.time.DayOfWeek的javadoc看起来会更好...


答案 1

默认的 HTML 文档对成员的摘要进行排序。

Collections.sort(members);

来自 /com/sun/tools/doclets/internal/toolkit/builders/MemberSummaryBuilder.java :312

最好不要这样做。

Javadoc 按字母顺序放置摘要,以便您可以快速找到所需的摘要。打破这个模型将使Javadoc更难快速扫描并找到你正在寻找的东西。

字母顺序仅适用于摘要,完整的Javadoc将按源文件中的降序排列。


如果你真的需要这样做,那么你可以滚动你自己的 doclet,或者一个 taglet 也许可以做到这一点。


答案 2