RFR: 8265174: Update Class.getDeclaredMethods to discuss synethetic and bridge methods

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

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

Commit messages:
 - 8265174: Update Class.getDeclaredMethods to discuss synethetic and bridge methods

Changes: https://git.openjdk.java.net/jdk/pull/3477/files
 Webrev: https://webrevs.openjdk.java.net/?repo=jdk&pr=3477&range=00
  Issue: https://bugs.openjdk.java.net/browse/JDK-8265174
  Stats: 4 lines in 1 file changed: 4 ins; 0 del; 0 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