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

[Joe Darcy]

On Wed, 22 Jun 2022 20:00:24 GMT, Jonathan Gibbons <jjg 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.
>
> Jonathan Gibbons has updated the pull request with a new target base due to a merge or a rebase. The pull request now contains 14 commits:
> 
>  - Updates for latest repo
>  - Merge remote-tracking branch 'upstream/master' into 6251738.spec-tag-2
>  - Merge remote-tracking branch 'upstream/master' into 6251738.spec-tag-2
>  - Merge with upstream/master
>  - fix copyright dates
>    remove archaic obsolete build flags
>  - more URI -> URL
>  - address review feedback
>  - Merge remote-tracking branch 'upstream/master' into 6251738.spec-tag-2
>  - address review feedback
>  - fix merge issues
>  - ... and 4 more: https://git.openjdk.org/jdk/compare/58b6937b...26540818

src/jdk.compiler/share/classes/com/sun/source/doctree/DocTree.java line 225:

> 223:          * representing an {@code @spec} tag.
> 224:          *
> 225:          * @since 19

Please correct the `@since` tag.

src/jdk.compiler/share/classes/com/sun/source/util/SimpleDocTreeVisitor.java line 476:

> 474:      * @return  the result of {@code defaultAction}
> 475:      *
> 476:      * @since 19

Please update the `@since` tag.

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

PR: https://git.openjdk.org/jdk/pull/8439