Czy istnieje sposób na uzyskanie narzędzia javadoc do dokumentowania adnotacji?

Question

W moim projekcie używamy wielu adnotacji, które byłyby bardzo przydatne w dokumentacji interfejsu API javadoc.

Czy ktoś zna prosty sposób dołączania adnotacji do wygenerowanych javadocs? Nie chcę pisać własnej wtyczki javadoc. Czy są jakieś rozwiązania?

Answer 1

Zobacz java.lang.annotation.Documented

Wskazuje, że adnotacje o rodzaju muszą być udokumentowane przez javadoc i podobnych narzędzi domyślnie. Tego typu należy używać do opisywania deklaracji typów, których adnotacje wpływają na używanie elementów adnotowanych przez ich klientów. Jeśli deklaracja typu ma adnotację Udokumentowane, jej adnotacje stają się częścią publicznego interfejsu API adnotowanych elementów.

przykład:

import java.lang.annotation.Documented; 

@Documented 
public @interface MyAnnotation { 
}