On Wed, 16 Dec 2020 18:15:27 GMT, Jonathan Gibbons <j...@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
