A DESCRIPTION OF THE REQUEST :
In 5.0, the compiler is supposed to handle annotations on a package declaration using a package-info.java file. I could not find any information about what needs to be done by the compiler to support this.
The only specs I found are really vague and the current implementation of javac (1.5.0_01) doesn't follow that.
The fake interface declaration called package-info is supposed to be synthetic, but the .class file compiled by javac doesn't contain any synthetic information.
It would be nice to clarify the specifications (JLS and/or JVM).
The only mention to package-info is in chapter 7.4.1.1 of the JLS.

JUSTIFICATION :
This would enable other vendors to provide a java compiler that would do the right thing.