JDK-8157735 : re-evaluate javadoc support for @deprecated tag
  • Type: Enhancement
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Priority: P4
  • Status: New
  • Resolution: Unresolved
  • Submitted: 2016-05-24
  • Updated: 2016-05-25
Related Reports
Relates :  
JDK-6481080 - (ann) @Deprecated annotation has no effect on packages
Relates :  
JDK-8157736 - re-evaluate javac support for @deprecated tag
Relates :  
JDK-8065614 - JEP 277: Enhanced Deprecation
Description
Currently, @deprecated is not permitted on a package. Should it be?

(In contrast, the @Deprecated annotation *is* permitted on a package declaration.)
Comments
@Deprecated on a package has an observable effect in javadoc ;-)
25-05-2016
Note that @Deprecated on a package, while allowed, is a no-op, JDK-6481080.
25-05-2016
Allowing @deprecated on packages would have implications for javac support for @deprecated/@Deprecated. JDK-8157736
24-05-2016