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

[Jonathan Gibbons]

On Tue, 3 May 2022 12:38:09 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/doctree/DocTreeVisitor.java line 290:
> 
>> 288:     R visitSince(SinceTree node, P p);
>> 289: 
>> 290:     /**
> 
> This file uses a consistent style for doc comments for `visit` methods. Consider adhering to that style for the time being. If you think that the style could be improved, it should be improved in a separate PR.

The style is consistent with other recent additions that have default methods.  In other words, there is not one but two styles already in play in this file, for the two different kinds of methods.

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

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