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

[Iris Clark]

On Tue, 3 May 2022 13:22:05 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

>> Jonathan Gibbons has updated the pull request with a new target base due to a merge or a rebase. The pull request now contains 22 commits:
>> 
>>  - Fix merge issue
>>  - Merge remote-tracking branch 'upstream/master' into 6251738.spec-tag-2
>>  - Merge with upstream/master
>>  - Fix typo and merge error
>>  - Merge with upstream/master
>>  - Update @since tags
>>  - Merge remote-tracking branch 'upstream/master' into 6251738.spec-tag-2
>>  - Merge remote-tracking branch 'upstream/master' into 6251738.spec-tag-2
>>  - Updates for latest repo
>>  - Merge remote-tracking branch 'upstream/master' into 6251738.spec-tag-2
>>  - ... and 12 more: https://git.openjdk.org/jdk/compare/2283c324...be7510e5
>
> src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/toolkit/taglets/TagletWriter.java line 192:
> 
>> 190:      *
>> 191:      * @param element  the element that owns the doc comment
>> 192:      * @param specTags the array of @spec tags.
> 
> Naked tags that aren't meant to be interpreted by javadoc make me uncomfortable.

`{@code @spec}` similar to line 200?

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

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