Enums que ordenan en javadoc
(1)
El Javadoc para enumeraciones siempre muestra sus constantes mediante orden alfabético. ¿Es posible cambiar eso?
Por ejemplo, el javadoc para java.time.DayOfWeek se vería mejor si las constantes no se mostraran como VIERNES, LUNES, SÁBADO, DOMINGO, JUEVES, MARTES, MIÉRCOLES ...
El doclet HTML predeterminado ordena los resúmenes de sus miembros.
Collections.sort(members);
de /com/sun/tools/doclets/internal/toolkit/builders/MemberSummaryBuilder.java: 312
Probablemente es mejor que no hagas esto.
Javadoc coloca los resúmenes en orden alfabético para que pueda encontrar rápidamente el que desea. Romper ese modelo haría que el Javadoc sea mucho más difícil de escanear rápidamente y encontrar lo que está buscando.
El orden alfabético solo se aplica al resumen, el Javadoc completo estará en el orden de desclasificación en el archivo fuente.
Si realmente necesitabas hacer esto, entonces puedes rodar tu propio doclet o tal vez un taglet pueda hacerlo.