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