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

Tue Dec 10 20:57:24 UTC 2024

Hi all,

This pull request contains a backport of commit [0f035545](https://github.com/openjdk/jdk/commit/0f035545e5c0cd02d11ab8edd5786c1f1f6043a7) from the [openjdk/jdk](https://git.openjdk.org/jdk) repository.

This is a noreg-doc backport - these additions are clarifications to the ClassFile API's java.lang.classfile.instruction package, and are permissible in RDP1 and RDP2.

The commit being backported was authored by Chen Liang on 10 Dec 2024 and was reviewed by Adam Sotona and Joe Darcy.

Thanks!

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

Commit messages:
 - Backport 0f035545e5c0cd02d11ab8edd5786c1f1f6043a7

Changes: https://git.openjdk.org/jdk/pull/22671/files
  Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=22671&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8342469
  Stats: 2434 lines in 39 files changed: 1993 ins; 27 del; 414 mod
  Patch: https://git.openjdk.org/jdk/pull/22671.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/22671/head:pull/22671

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