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

[Jonathan Gibbons]

On Mon, 26 Sep 2022 12:32:46 GMT, Hannes Wallnöfer <hannesw at openjdk.org> wrote:

> I don't know if you want to further discuss inheritability of the new tag, but the code looks good to me. I've also looked at the generated output and it also looks good.

I think of `@spec` as a highly specialized form of `@see` with the significant side effect of generating an extra summary page. So, I'm happy/OK that the support for inheritability is on a par with `@see`. It's not great, since it will only inherit one tag (!!) and you cannot specify which one, but the code is sufficiently similar so when we fix one (later) we should be able to easily fix the other.

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

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