RFR: 8347008: beancontext package spec does not clearly explain why the API is deprecated [v2]

[Alexander Zvegintsev]

> The beancontext package description or the deprecation text in the classes doesn't say anything about why the API is deprecated.
> A few more words have been added in this regard.

Alexander Zvegintsev has updated the pull request incrementally with one additional commit since the last revision:

  review comments

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/23216/files
  - new: https://git.openjdk.org/jdk/pull/23216/files/6d6ae98c..a993944f

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

  Stats: 1 line in 1 file changed: 0 ins; 0 del; 1 mod
  Patch: https://git.openjdk.org/jdk/pull/23216.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/23216/head:pull/23216

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