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