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

[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 incrementally with one additional commit since the last revision:

  s/ ith/with/

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

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

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

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