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

[Jonathan Gibbons]

On Fri, 23 Sep 2022 17:15:23 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

>> src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/toolkit/taglets/SpecTaglet.java line 65:
>> 
>>> 63:                     ? ch.getFirstSentenceTrees(output.holderTag)
>>> 64:                     : ch.getReference(output.holderTag);
>>> 65:         }
>> 
>> This implementation seems to be copied from SeeTaglet.java. Is it fully functional in this context? The use of CommentHelper.getReference looks suspicious to me.
>
> Thanks for the comment; I'll investigate

Good catch;

Yes, the use of `getReference` is indeed questionable, given its implementation, which is specific to `@see`.   Given ongoing recent work, it's also not clear that the `@spec` tag should be inheritable.

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

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