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

[Joe Darcy]

On 07/10/2013 12:25 PM, Alex Buckley wrote:
> On 7/10/2013 12:11 PM, Joe Darcy wrote:
>> On 07/10/2013 11:29 AM, Alex Buckley wrote:
>>> Elena Votchennikova pointed out in a comment of JDK-8010679 that
>>> classes which implement AnnotatedElement contain method specifications
>>> copied from AnnotatedElement. I believe the following classes need to
>>> have their method specifications updated:
>>>
>>> - j.l.Class
>>> - j.l.Package
>>> - j.l.r.AccessibleObject
>>>   (re: j.l.r.Field, j.l.r.Executable, j.l.r.Method, j.l.r.Constructor)
>>> - j.l.r.Parameter
>>
>> The specifications on the implementation classes should generally just
>> be @inheritdoc'ed (meaning no explicit update should be needed in those
>> files), but I'll double check.
>
> Is there a reason why isAnnotationPresent in the classes has an 
> @inheritDoc for its main description, but the six 
> get[Declared]Annotation... methods don't?
>

There is an implicit @inheritDoc if the method has no documentation, to 
the explicit @inheritDoc is fine but not strictly required.

-Joe