--- old/src/java.base/share/classes/java/lang/reflect/Executable.java	2019-06-07 22:41:46.418498274 -0700
+++ new/src/java.base/share/classes/java/lang/reflect/Executable.java	2019-06-07 22:41:46.046498274 -0700
@@ -260,7 +260,7 @@
      *
      * <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.
@@ -520,7 +520,11 @@
      * 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,