JDK 13 RFR of JDK-8181869: getAnnotatedParameterTypes​() specification should be clarified

[Joe Darcy]

Hello,

Please review the doc clarification below to address

     JDK-8181869: getAnnotatedParameterTypes​() specification should be 
clarified

Each of the three flavors of get-parameter-types methods 
(getParameterTypes, getGenericParameterTypes, 
getAnnotatedParameterTypes) gets the same disclaimer.

Thanks,

-Joe

diff -r 0d44bf1ead37 
src/java.base/share/classes/java/lang/reflect/Executable.java
--- a/src/java.base/share/classes/java/lang/reflect/Executable.java Fri 
Jun 07 04:57:51 2019 +0200
+++ b/src/java.base/share/classes/java/lang/reflect/Executable.java Thu 
Jun 06 20:26:34 2019 -0700
@@ -234,6 +234,9 @@
       * parameter types, in declaration order, of the executable
       * represented by this object.  Returns an array of length
       * 0 if the underlying executable takes no parameters.
+     * Note that the constructors of some inner classes
+     * may have an implicitly declared parameter in addition to
+     * explicitly declared ones.
       *
       * @return the parameter types for the executable this object
       * represents
@@ -257,6 +260,9 @@
       * parameter types, in declaration order, of the executable 
represented by
       * this object. Returns an array of length 0 if the
       * underlying executable takes no parameters.
+     * Note that the constructors of some inner classes
+     * may have an implicitly declared parameter in addition to
+     * explicitly declared ones.
       *
       * <p>If a formal parameter type is a parameterized type,
       * the {@code Type} object returned for it must accurately reflect
@@ -698,7 +704,9 @@
       * declaration of the method/constructor.
       *
       * Returns an array of length 0 if the method/constructor declares no
-     * parameters.
+     * parameters. Note that the constructors of some inner classes
+     * may have an implicitly declared parameter in addition to
+     * explicitly declared ones.
       *
       * @return an array of objects representing the types of the
       * formal parameters of the method or constructor represented by this