Please review a doc update to add `@spec` tags to crypto and security APIs in `java.base`.
This was authored and proposed as #13336 by @jonathan-gibbons as part of [JDK-8296546] back in 2023, but although it was reviewed and approved it never was integrated. Since I can't reopen Jon's PR and also for the sake of transparency, I rebased the original commits on current master and created a new pull request. [JDK-8296546]: https://bugs.openjdk.org/browse/JDK-8296546 The original commits still apply cleanly, and I made sure all links are still valid. As was the case already in 2023, the [FIPS 186-3] spec returns a "superseded" page, but the same spec URL is used in the doc comment description, so this should be handled by the maintainer of the API. [FIPS 186-3]: https://csrc.nist.gov/publications/fips/fips186-3/fips_186-3.pdf ------------- Commit messages: - Add @spec tags for nist.gov docs - Address review feedback - Update src/java.base/share/classes/java/security/cert/X509Certificate.java - JDK-8305406: Add @spec tags in java.base/java.* (part 2) Changes: https://git.openjdk.org/jdk/pull/21326/files Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=21326&range=00 Issue: https://bugs.openjdk.org/browse/JDK-8305406 Stats: 270 lines in 59 files changed: 263 ins; 7 del; 0 mod Patch: https://git.openjdk.org/jdk/pull/21326.diff Fetch: git fetch https://git.openjdk.org/jdk.git pull/21326/head:pull/21326 PR: https://git.openjdk.org/jdk/pull/21326
