RFR of JDK-8245620: Improve Annotation.annotationType() documentation

[Alan Bateman]

On 11/06/2020 06:26, Joe Darcy wrote:
> Hello,
>
> Please review a number of small updates to the javadoc of 
> java.lang.annotation.Annotation to address
>
>     JDK-8245620: Improve Annotation.annotationType() documentation
>
> The use of  Annotation.annotationType() vs calling getClass on an 
> annotation object may not be clear so the method's javadoc is 
> augmented to explain this situation. java.lang.Enum defines an 
> analogous method which always returns the enum class of an enum object.
>
> There are a number of other small improvements, including updating the 
> example toString output to account for
>
>     8162817: Annotation toString output not reusable for source input
>
> Patch below; thanks,
Looks okay to me although I wonder if the update to annotationType 
should be an @apiNote.

-Alan