[lworld] RFR: 8353236: [lworld] Better documentation for Valhalla Unsafe intrinsics

Wed Apr 9 13:23:31 UTC 2025

Hi,

This patch clarifies the meaning of undefined behavior when working with `Unsafe` and specifies the requirements when working with `Unsafe::makePrivateBuffer` and `Unsafe::finishPrivateBuffer`.

Please take a look and leave your suggestions, thanks a lot.

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

Commit messages:
 - specify undefined behavior and Valhalla intrinsics

Changes: https://git.openjdk.org/valhalla/pull/1425/files
  Webrev: https://webrevs.openjdk.org/?repo=valhalla&pr=1425&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8353236
  Stats: 70 lines in 1 file changed: 60 ins; 0 del; 10 mod
  Patch: https://git.openjdk.org/valhalla/pull/1425.diff
  Fetch: git fetch https://git.openjdk.org/valhalla.git pull/1425/head:pull/1425

PR: https://git.openjdk.org/valhalla/pull/1425