javac reports a compilation error when @Deprecated annotation is present and @deprecated javadoc tag. There seems to be some confusion between the annotation and the javadoc tag.
package-info.java:5: error: modifier deprecated not allowed here
package xx;
^
1 error
/**
* @deprecated removed
*/
@Deprecated()
package xx;
package-info.java:5: error: modifier deprecated not allowed here
package xx;
^
1 error
/**
* @deprecated removed
*/
@Deprecated()
package xx;