src/share/classes/java/lang/reflect/Executable.java

*** 276,285 ****
--- 276,289 ----
       * Returns an array of {@code Parameter} objects that represent
       * all the parameters to the underlying executable represented by
       * this object.  Returns an array of length 0 if the executable
       * has no parameters.
       *
+      * The parameters of the underlying executable do not necessarily
+      * have unique names, or names that are legal identifiers in the
+      * Java programming language (JLS 3.8).
+      *
       * @return an array of {@code Parameter} objects representing all
       * the parameters to the executable this object represents
       */
      public Parameter[] getParameters() {
          // TODO: This may eventually need to be guarded by security