7086604: (reflect) Clarifications to javadoc for getGeneric*Type methods in j.l.r
authordarcy
Tue, 11 Jun 2019 17:20:51 -0700
changeset 55337 ae3dbc712839
parent 55336 c2398053ee90
child 55338 755e82641224
child 55372 5d5fccc4fd3f
7086604: (reflect) Clarifications to javadoc for getGeneric*Type methods in j.l.r Reviewed-by: lancea, abuckley
src/java.base/share/classes/java/lang/Class.java
src/java.base/share/classes/java/lang/reflect/Executable.java
src/java.base/share/classes/java/lang/reflect/Field.java
src/java.base/share/classes/java/lang/reflect/Method.java
src/java.base/share/classes/java/lang/reflect/TypeVariable.java
--- a/src/java.base/share/classes/java/lang/Class.java	Tue Jun 11 16:31:37 2019 -0700
+++ b/src/java.base/share/classes/java/lang/Class.java	Tue Jun 11 17:20:51 2019 -0700
@@ -917,7 +917,7 @@
      *
      * <p>If the superclass is a parameterized type, the {@code Type}
      * object returned must accurately reflect the actual type
-     * parameters used in the source code. The parameterized type
+     * arguments used in the source code. The parameterized type
      * representing the superclass is created if it had not been
      * created before. See the declaration of {@link
      * java.lang.reflect.ParameterizedType ParameterizedType} for the
@@ -1097,7 +1097,7 @@
      *
      * <p>If a superinterface is a parameterized type, the
      * {@code Type} object returned for it must accurately reflect
-     * the actual type parameters used in the source code. The
+     * the actual type arguments used in the source code. The
      * parameterized type representing each superinterface is created
      * if it had not been created before. See the declaration of
      * {@link java.lang.reflect.ParameterizedType ParameterizedType}
--- a/src/java.base/share/classes/java/lang/reflect/Executable.java	Tue Jun 11 16:31:37 2019 -0700
+++ b/src/java.base/share/classes/java/lang/reflect/Executable.java	Tue Jun 11 17:20:51 2019 -0700
@@ -266,7 +266,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.
--- a/src/java.base/share/classes/java/lang/reflect/Field.java	Tue Jun 11 16:31:37 2019 -0700
+++ b/src/java.base/share/classes/java/lang/reflect/Field.java	Tue Jun 11 17:20:51 2019 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1996, 2018, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1996, 2019, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -243,9 +243,9 @@
      * Returns a {@code Type} object that represents the declared type for
      * the field represented by this {@code Field} object.
      *
-     * <p>If the {@code Type} is a parameterized type, the
-     * {@code Type} object returned must accurately reflect the
-     * actual type parameters used in the source code.
+     * <p>If the declared type of the field is a parameterized type,
+     * the {@code Type} object returned must accurately reflect the
+     * actual type arguments used in the source code.
      *
      * <p>If the type of the underlying field is a type variable or a
      * parameterized type, it is created. Otherwise, it is resolved.
--- a/src/java.base/share/classes/java/lang/reflect/Method.java	Tue Jun 11 16:31:37 2019 -0700
+++ b/src/java.base/share/classes/java/lang/reflect/Method.java	Tue Jun 11 17:20:51 2019 -0700
@@ -269,7 +269,7 @@
      *
      * <p>If the return type is a parameterized type,
      * the {@code Type} object returned must accurately reflect
-     * the actual type parameters used in the source code.
+     * the actual type arguments used in the source code.
      *
      * <p>If the return type is a type variable or a parameterized type, it
      * is created. Otherwise, it is resolved.
--- a/src/java.base/share/classes/java/lang/reflect/TypeVariable.java	Tue Jun 11 16:31:37 2019 -0700
+++ b/src/java.base/share/classes/java/lang/reflect/TypeVariable.java	Tue Jun 11 17:20:51 2019 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2003, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2019, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -72,7 +72,7 @@
 
     /**
      * Returns the {@code GenericDeclaration} object representing the
-     * generic declaration declared this type variable.
+     * generic declaration declared for this type variable.
      *
      * @return the generic declaration declared for this type variable.
      *