RFR: JDK-8309964: Use directed inheritDoc for javax.lang.model API

Joe Darcy darcy at openjdk.org
Thu Jun 15 22:31:58 UTC 2023


On Wed, 14 Jun 2023 20:05:23 GMT, Joe Darcy <darcy at openjdk.org> wrote:

> Update javax.lang.model and javax.annotation.processing to use directed inhertitDoc.

Possible follow-up work includes reviewing the `@return` tags in the visitor hierarchy to be less implSpec and more spec and, if I understand the functionality correctly, replacing the repeated paragraphs in the class-level docs in the visitor hierarchy with directed inheritance of implSpec/implNote, etc. to result in DRY-er documentation when reading the sources.

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

PR Comment: https://git.openjdk.org/jdk/pull/14477#issuecomment-1593803310


More information about the compiler-dev mailing list