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

[Hannes Wallnöfer]

On Thu, 24 Oct 2024 02:23:19 GMT, Valerie Peng <valeriep at openjdk.org> wrote:

>> src/java.base/share/classes/java/security/package-info.java line 82:
>> 
>>> 80:  * </ul>
>>> 81:  *
>>> 82:  * @spec security/standard-names.html Java Security Standard Algorithm Names
>> 
>> How about the other 2 under `Package Specification` (from line 49-53)? Does this PR need to cover them also?
>
> Same question applies for the java/security/interfaces/package-info.java file as well.

I guess the link for PKCS #8 would be https://www.rfc-editor.org/info/rfc5208 , but the doc comment says "November 1993", while the spec page says "May 2008", so maybe that should be updated as well. For the JCA Reference Guide, it's not clear to me it qualifies as a specification. So this and `java/security/interfaces/package-info.java` are cases that I think should be handled by the component maintainers.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/21326#discussion_r1814551710