RFR: 8280713: Related to comment inheritance jdk.javadoc cleanup and refactoring

[Pavel Rappo]

On Fri, 25 Feb 2022 00:50:30 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

> the following may be out-of-scope for what you are doing

General comment. What I'm doing is simplifying and improving readability, while also making sure that either:

  * code behaviour is unchanged, or
  * the JDK API Documentation is unchanged and the _existing_ tests are not broken.

I'm doing this to enable even more aggressive refactoring or rewrite. Currently, the code is much more complex than it needs to be, which is tolling as it requires me to re-examine and re-understand it every time I read it after not looking at it for a while.

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

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