RFR: 8265174: Update Class.getDeclaredMethods to discuss synthetic and bridge methods [v2]

[Joe Darcy]

> The results from Class.getDeclaredMethods can include bridge and other synthetic methods, which can be unexpected by users (JDK-6815786, JDK-8142904) and appear to be inherited methods. The javadoc for Class.getDeclaredMethods should be updated to explicitly mention the possibility of synthetic methods appearing.

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

  Add links to discussion in java.lang.reflect package javadoc.

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

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/3477/files
  - new: https://git.openjdk.java.net/jdk/pull/3477/files/696daa59..dc1a5381

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

  Stats: 24 lines in 5 files changed: 22 ins; 1 del; 1 mod
  Patch: https://git.openjdk.java.net/jdk/pull/3477.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/3477/head:pull/3477

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