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

[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 with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains five additional commits since the last revision:

 - Merge and update copyright year.
 - Merge branch 'master' into 8262807
 - Respond to review feedback.
 - Appease jcheck.
 - 8262807: Note assumptions of core reflection modeling and parameter handling

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

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

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

  Stats: 2708 lines in 204 files changed: 1275 ins; 709 del; 724 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