--- a/jdk/src/share/classes/java/lang/reflect/Executable.java	Mon Feb 11 10:07:01 2013 -0800
+++ b/jdk/src/share/classes/java/lang/reflect/Executable.java	Mon Feb 11 20:16:18 2013 +0000
@@ -278,6 +278,10 @@
      * 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
      */