RFR: 8361300: Document exceptions for Unsafe offset methods [v7]

[Chen Liang]

> Unsafe throws IAE for misusing static vs instance fields, and it's revealed that AtomicXxxFieldUpdaters are using this mechanism to reject static fields. This is not a good practice, but we can at least document this so we don't accidentally introduce problems.

Chen Liang has updated the pull request incrementally with one additional commit since the last revision:

  Test update advised by volkan

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/25945/files
  - new: https://git.openjdk.org/jdk/pull/25945/files/d920ec13..1ce1415c

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=25945&range=06
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=25945&range=05-06

  Stats: 2 lines in 1 file changed: 1 ins; 0 del; 1 mod
  Patch: https://git.openjdk.org/jdk/pull/25945.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/25945/head:pull/25945

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