RFR: JDK-6251738: Want a top-level summary page that itemizes all spec documents referenced from javadocs (OEM spec)

Tue May 3 22:11:42 UTC 2022

On Tue, 3 May 2022 12:42:41 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

>> Please review the code and tests to add support for a new `@spec url title` tag to javadoc.  Note, this does not include any changes to API doc comments to use the new tag in JDK API documentation; that will come later.
>
> src/jdk.compiler/share/classes/com/sun/source/util/DocTreeScanner.java line 544:
> 
>> 542: 
>> 543:     /**
>> 544:      * {@inheritDoc} This implementation scans the children in left to right order.
> 
> This change is surprising; firstly, it's unrelated to this PR, secondly... why?

Bug and/or some variant of cut n paste. I'll ensure to use `@implSpec`.

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

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