A DESCRIPTION OF THE PROBLEM :
Javadoc fails when using a package annotation. It works when the package annotation is preceded by a Doc comment.


---------- BEGIN SOURCE ----------
@java.lang.Deprecated
package com.example;
---------- END SOURCE ----------

CUSTOMER SUBMITTED WORKAROUND :
/**
 *
 */
@java.lang.Deprecated
package com.example;