RFR [15] 8238467: Clean up annotations on overridden/implemented methods

Jonathan Gibbons jonathan.gibbons at oracle.com
Tue Feb 4 21:51:22 UTC 2020


Interesting ... in the old doclet, both were IllegalArgumentException.

I'm OK with fixing the javadoc; but we should not change the method 
signatures in this changeset, which is about @Override and {@inheritDoc}

--Jon

On 2/4/20 1:46 PM, Pavel Rappo wrote:
> Further investigation suggests that this artifact (a mistyped exception name)
> was introduced in
>
>      changeset:   35426:374342e56a56
>      user:        ksrini
>      date:        Sat Nov 28 18:52:17 2015 -0800
>      summary:     8035473: [javadoc] Revamp the existing Doclet APIs
>
> -Pavel
>
>> On 4 Feb 2020, at 21:39, Pavel Rappo <pavel.rappo at oracle.com> wrote:
>>
>> 3.  jdk.javadoc.internal.doclets.toolkit.taglets.BaseTaglet#getTagletOutput(3 parameters)
>>     jdk.javadoc.internal.doclets.toolkit.taglets.Taglet#getTagletOutput(3 parameters)
>>
>>       @throws UnsupportedOperationException       thrown when the method is not supported by the taglet.
>>       @throws UnsupportedTagletOperationException thrown when the method is not supported by the taglet.
>>
>> The exceptions are different (one is a subtype of the other). However, I doubt
>> that this is significant (here) or that this reflects a conscious design decision.
>> However, I agree I should've disclosed that in my RFR.


More information about the javadoc-dev mailing list