[lworld] RFR: 8346035: [lworld] javadoc for value objects when enable preview [v3]

[Roger Riggs]

> Updated javadoc for value objects when preview is enabled.
> 
> Added text and decoration to highlight preview behavior of identity classes that are value classes with --enable-preview
> The decorations are similar to the existing preview highlights for Preview classes and methods.
> 
> The updates include all of the wrapper classes, java.time, and java.util.Optional* and other classed annotated with @ValueBased.
> 
> The ValueBased is updated to describe the behavior when --enable-preview.

Roger Riggs has updated the pull request incrementally with one additional commit since the last revision:

  Clarified comments based on review feedback.
  Highlighted value object behavior on Object.notify* and Object.wait*.

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

Changes:
  - all: https://git.openjdk.org/valhalla/pull/1316/files
  - new: https://git.openjdk.org/valhalla/pull/1316/files/1d1e6234..3d057635

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=valhalla&pr=1316&range=02
 - incr: https://webrevs.openjdk.org/?repo=valhalla&pr=1316&range=01-02

  Stats: 52 lines in 3 files changed: 44 ins; 0 del; 8 mod
  Patch: https://git.openjdk.org/valhalla/pull/1316.diff
  Fetch: git fetch https://git.openjdk.org/valhalla.git pull/1316/head:pull/1316

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