RFR: JDK-8276772: Refine javax.lang.model docs

[Joe Darcy]

On Sun, 7 Nov 2021 03:23:45 GMT, liach <duke at openjdk.java.net> wrote:

>> Pass over javax.lang.model docs for some minor cleanups and improvements.
>> 
>> Before pushing, I'll do any needed copyright updates and reflow paragraphs.
>
> src/java.compiler/share/classes/javax/lang/model/element/AnnotationMirror.java line 65:
> 
>> 63:      * will by definition have an empty map.
>> 64:      *
>> 65:      * <p>To fill in default values, use {@link
> 
> Is this paragraph supposed to be part of the api notes as well?

Yes; those are both intended to be part of the apiNote and both render as such.

-------------

PR: https://git.openjdk.java.net/jdk/pull/6286