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

@@ -258,11 +258,11 @@
      * this object. Returns an array of length 0 if the
      * underlying executable takes no parameters.
      *
      * <p>If a formal parameter type is a parameterized type,
      * the {@code Type} object returned for it must accurately reflect
-     * the actual type parameters used in the source code.
+     * the actual type arguments used in the source code.
      *
      * <p>If a formal parameter type is a type variable or a parameterized
      * type, it is created. Otherwise, it is resolved.
      *
      * @return an array of {@code Type}s that represent the formal

@@ -518,11 +518,15 @@
 
     /**
      * Returns an array of arrays of {@code Annotation}s that
      * represent the annotations on the formal parameters, in
      * declaration order, of the {@code Executable} represented by
-     * this object.  Synthetic and mandated parameters (see
+     * this object.
+     *
+     * <p>Any annotations returned by this method are declaration annotations.
+     *
+     * <p>Synthetic and mandated parameters (see
      * explanation below), such as the outer "this" parameter to an
      * inner class constructor will be represented in the returned
      * array.  If the executable has no parameters (meaning no formal,
      * no synthetic, and no mandated parameters), a zero-length array
      * will be returned.  If the {@code Executable} has one or more