RFR: 8223607: --override-methods=summary ignores some signature changes

[Hannes Wallnöfer]

On Wed, 16 Dec 2020 18:15:27 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

>> This change causes overriding methods to be documented in the details section under some conditions even when javadoc is run with `--override-methods=summary` and the method does not have a doc comment. Previously this already happened when the overriding method had a covariant return type (JDK-8219147). The following conditions will now trigger the same behaviour:
>> 
>>  - method visibility changes from `protected` to `public`
>>  - any change in thrown exceptions
>>  - change in documented annotations anywhere in the method signature
>> 
>> The conditions are simple by intention as we don't want to do checks that add to much complexity (such as distinguishing between checked and unchecked exceptions) and instead want to set the bar for inclusion in the details section relatively low.
>
> This looks good, but given the noteworthy and significant changes in `VisibleMemberTable`,
> I'd like to suggest you address JDK-8258429 at this time, which has significant overlap.

New PR created for jdk16 repository, closing this one.

https://github.com/openjdk/jdk16/pull/52

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

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