RFR: JDK-8322979: Add informative discussion to Modifier [v3]

[Joe Darcy]

> Add a few apiNote concerning source-level modifiers that are not represented in java.lang.reflect.Modifier.

Joe Darcy has updated the pull request incrementally with one additional commit since the last revision:

  Refine wording per review feedback.

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/17338/files
  - new: https://git.openjdk.org/jdk/pull/17338/files/e5816889..cc67f321

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

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

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