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