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