RFR: 8339852: Fix typos in java.compiler documentation

[Pavel Rappo]

On Tue, 10 Sep 2024 17:58:27 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

>> src/java.compiler/share/classes/javax/lang/model/AnnotatedConstruct.java line 55:
>> 
>>> 53:  * <p>In the definitions below, an annotation <i>A</i> has an
>>> 54:  * annotation interface <i>AI</i>. If <i>AI</i> is a repeatable annotation
>>> 55:  * interface, the type of the container annotation is <i>AIC</i>.
>> 
>> "the annotation interface of the container annotation is *AIC*"
>> or
>> "the containing annotation interface is *AIC*"
>> 
>> To align with the JLS.
>
> "Type" is appropriate here and in some other locations in the `AnnotatedConstruct` javadoc. I paid attention to the difference between "contain-ing annotation interface" and "contain-er annotation".
> 
> @dansmithcode, please correct me if I'm wrong.

For convenience, here's the rendered documentation in question for JDK 23: https://download.java.net/java/early_access/jdk23/docs/api/java.compiler/javax/lang/model/AnnotatedConstruct.html#:~:text=containing

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

PR Review Comment: https://git.openjdk.org/jdk/pull/20937#discussion_r1752455117