RFR: 8310892: ScopedValue throwing StructureViolationException should be clearer [v3]

[Alan Bateman]

> Docs only update to add a missing `@throws StructureViolationException` and make it clearer when the exception is thrown. In the future we might re-visit this so that the description is in one place rather than in each method.

Alan Bateman has updated the pull request with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains three additional commits since the last revision:

 - Merge
 - s/ ith/with/
 - Initial commit

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/14679/files
  - new: https://git.openjdk.org/jdk/pull/14679/files/08158fe8..2e94515d

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

  Stats: 52253 lines in 606 files changed: 7072 ins; 42498 del; 2683 mod
  Patch: https://git.openjdk.org/jdk/pull/14679.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/14679/head:pull/14679

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