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

[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:

  Tidy up ValueBased.html

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

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

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

  Stats: 4 lines in 1 file changed: 0 ins; 2 del; 2 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