[jdk24] RFR: 8342465: Improve API documentation for java.lang.classfile

[Chen Liang]

Please review a non-clean backport of #23277, the final patch in the improvements to the Class-File API. The backport is non-clean because a new JAVA_25_VERSION constant was added in 25; otherwise the patch applied cleanly.

Tests: Submitted tier 1-3

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

Commit messages:
 - Backport 1d8ccb89204cc5efbcecdaa0c9de7b2c5a109d5d

Changes: https://git.openjdk.org/jdk/pull/23317/files
  Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=23317&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8342465
  Stats: 2959 lines in 44 files changed: 1946 ins; 30 del; 983 mod
  Patch: https://git.openjdk.org/jdk/pull/23317.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/23317/head:pull/23317

PR: https://git.openjdk.org/jdk/pull/23317