Review request for present, directly present, etc. in core reflection javadoc

[Alex Buckley]

On 7/10/2013 11:33 AM, Joel Borggrén-Franck wrote:
> On 10 jul 2013, at 03:38, Joe Darcy <joe.darcy at oracle.com> wrote:
>
> Second paragraph:
>
>> + * method will "look through" a container annotation (JLS 9.7) and
>> + * return the one or more annotations inside the container. Container
>> + * annotations may be generated at compile-time to wrap multiple
>> + * annotations of the argument type.
>>   *
>
> Is "the one or more" intended?

I think so, because typically the container annotation stores one or 
more base annotations. If the text was "... and return the annotations 
inside the container", then it implies there are always multiple 
annotations, which is false.

It would be more general for the intro to say "... and return any 
annotations inside the container", since that covers the "one or more" 
case and also the rare "zero" case.

Alex