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

[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:

  Per current terminology conventions, "types" -> "classes and interfaces" in package-info.

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

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/3036/files
  - new: https://git.openjdk.java.net/jdk/pull/3036/files/c2bf7434..cd6fd6fe

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

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