WillClose* annotations do not produce proper javadoc

[GoogleCodeExporter]

What steps will reproduce the problem?
1. Create project javadoc using your preferred approach.
2. Review documentation for these classes vs. their source.

What is the expected output? What do you see instead?
One would hope to find the class-level descriptions of these annotations, but 
they are missing.  This is arguably a bug specific to a given javadoc 
implementation, but the generated javadocs at 
http://code.google.com/p/jsr-305/source/browse/#svn%2Ftrunk%2Fjavadoc suffer 
from the same peculiarity as those I built locally anyway, the basic usage 
examples for annotations at 
http://docs.oracle.com/javase/1.5.0/docs/guide/language/annotations.html imply 
that javadoc should precede annotations, and the remainder of the jsr-305 API 
codebase follows this practice.

What version of the product are you using? On what operating system?
svn trunk rev 51.

Please provide any additional information below.

Original issue reported on code.google.com by [email protected] on 4 May 2012 at 4:16

Attachments:

• doc-before-annotations.patch.txt