Bug 61145

Summary: Missing @Documented annotation in some javax.annotation classes
Product: Tomcat 9 Reporter: Katya Todorova <katya.k.todorova>
Component: CatalinaAssignee: Tomcat Developers Mailing List <dev>
Status: RESOLVED FIXED    
Severity: normal    
Priority: P2    
Version: unspecified   
Target Milestone: -----   
Hardware: PC   
OS: Mac OS X 10.1   
Attachments: Patch validated against tomcat tests and the corresponding specification

Description Katya Todorova 2017-06-02 07:46:23 UTC
Created attachment 35026 [details]
Patch validated against tomcat tests and the corresponding specification

According to 
https://docs.oracle.com/javaee/7/api/javax/annotation/package-summary.html and 
https://docs.oracle.com/javaee/7/api/javax/annotation/security/package-summary.html

the following classes should have @Documented annotation:

javax.annotation.Generated
javax.annotation.PostConstruct
javax.annotation.PreDestroy
javax.annotation.Priority
javax.annotation.Resources
javax.annotation.security.DeclareRoles
javax.annotation.security.DenyAll
javax.annotation.security.PermitAll
javax.annotation.security.RolesAllowed
javax.annotation.security.RunAs
Comment 1 Mark Thomas 2017-06-02 09:15:40 UTC
Confirmed.

This also needs back-porting to 8.x and 7.x (less Priority which was introduced in Java EE 7).

Working on this now...
Comment 2 Mark Thomas 2017-06-02 09:27:35 UTC
Thanks for spotting this and thanks for the patch.

This has been fixed in:
- trunk for 9.0.0.M22 onwards
- 8.5.x for 8.5.16 onwards
- 8.0.x for 8.0.45 onwards
- 7.0.x for 7.0.79 onwards