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

Hannes Wallnöfer hannesw at openjdk.org
Thu Oct 3 14:10:48 UTC 2024


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


More information about the security-dev mailing list