RFR: 8262807: Note assumptions of core reflection modeling and parameter handling [v2]

[Joe Darcy]

> Please review the javadoc change below, written in response to recent discussion on core-libs.
> 
> The bulk of the change is to add a discussion to java.lang.reflect's package-info file about a language vs JVM model for core reflection. That discussion is then linked to from several relevant locations core reflection. A discussion of generic parameter handling is also added along with various small cleanups.
> 
> I'll update copyright, etc. after agreement on the text is reached.

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

  Respond to review feedback.

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

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/3036/files
  - new: https://git.openjdk.java.net/jdk/pull/3036/files/74b2bd59..3f102171

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=jdk&pr=3036&range=01
 - incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=3036&range=00-01

  Stats: 19 lines in 3 files changed: 0 ins; 9 del; 10 mod
  Patch: https://git.openjdk.java.net/jdk/pull/3036.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/3036/head:pull/3036

PR: https://git.openjdk.java.net/jdk/pull/3036