RFR: JDK-8305406: Add @spec tags in java.base/java.* (part 2) [v3]

[Jonathan Gibbons]

On Fri, 5 May 2023 14:28:01 GMT, Weijun Wang <weijun at openjdk.org> wrote:

> We have quite some `standard-names.html#anchorName` links (Ex:
> 
> https://github.com/openjdk/jdk/blob/f804f2ce8ef7a859aae021b20cbdcd9e34f9fb94/src/java.base/share/classes/java/security/Signature.java#L111
> 
> ). I don't see any of them here. Is this style allowed in a `@spec` tag?
> I also see no `#anchorName` for RFC links.
> 
> And in this case, shall I also spell out the section name in the text?

1. You can use a relative URL, relative to the `specs` directory, so something like:<br>
   `@spec security/standard-names.html Standard Names`

2. The intent of the `@spec` tag is to identify the overall/root URL for each specification, not to identify all the interesting places within that specification.

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

PR Comment: https://git.openjdk.org/jdk/pull/13336#issuecomment-1536766590