8098790: Improve cross references and wording in java.lang.reflect.AnnotatedFoo type
authordarcy
Tue, 16 Jun 2015 17:05:08 -0700
changeset 31177 c8ceef082391
parent 31176 db59cb6634af
child 31178 6ad68e35506d
child 31180 316a8c3e572a
8098790: Improve cross references and wording in java.lang.reflect.AnnotatedFoo type Reviewed-by: lancea
jdk/src/java.base/share/classes/java/lang/reflect/AnnotatedArrayType.java
jdk/src/java.base/share/classes/java/lang/reflect/AnnotatedParameterizedType.java
jdk/src/java.base/share/classes/java/lang/reflect/AnnotatedTypeVariable.java
jdk/src/java.base/share/classes/java/lang/reflect/AnnotatedWildcardType.java
jdk/src/java.base/share/classes/java/lang/reflect/TypeVariable.java
jdk/src/java.base/share/classes/java/lang/reflect/WildcardType.java
--- a/jdk/src/java.base/share/classes/java/lang/reflect/AnnotatedArrayType.java	Tue Jun 16 14:38:51 2015 -0700
+++ b/jdk/src/java.base/share/classes/java/lang/reflect/AnnotatedArrayType.java	Tue Jun 16 17:05:08 2015 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2012, 2015, 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
@@ -39,6 +39,7 @@
      * Returns the potentially annotated generic component type of this array type.
      *
      * @return the potentially annotated generic component type of this array type
+     * @see GenericArrayType#getGenericComponentType()
      */
     AnnotatedType  getAnnotatedGenericComponentType();
 }
--- a/jdk/src/java.base/share/classes/java/lang/reflect/AnnotatedParameterizedType.java	Tue Jun 16 14:38:51 2015 -0700
+++ b/jdk/src/java.base/share/classes/java/lang/reflect/AnnotatedParameterizedType.java	Tue Jun 16 17:05:08 2015 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2012, 2015, 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
@@ -38,6 +38,7 @@
      * Returns the potentially annotated actual type arguments of this parameterized type.
      *
      * @return the potentially annotated actual type arguments of this parameterized type
+     * @see ParameterizedType#getActualTypeArguments()
      */
     AnnotatedType[] getAnnotatedActualTypeArguments();
 }
--- a/jdk/src/java.base/share/classes/java/lang/reflect/AnnotatedTypeVariable.java	Tue Jun 16 14:38:51 2015 -0700
+++ b/jdk/src/java.base/share/classes/java/lang/reflect/AnnotatedTypeVariable.java	Tue Jun 16 17:05:08 2015 -0700
@@ -36,10 +36,11 @@
 
     /**
      * Returns the potentially annotated bounds of this type variable.
-     * Note that if no bound is explicitly declared, the bound is unannotated
+     * If no bound is explicitly declared, the bound is unannotated
      * {@code Object}.
      *
      * @return the potentially annotated bounds of this type variable
+     * @see TypeVariable#getBounds()
      */
     AnnotatedType[] getAnnotatedBounds();
 }
--- a/jdk/src/java.base/share/classes/java/lang/reflect/AnnotatedWildcardType.java	Tue Jun 16 14:38:51 2015 -0700
+++ b/jdk/src/java.base/share/classes/java/lang/reflect/AnnotatedWildcardType.java	Tue Jun 16 17:05:08 2015 -0700
@@ -36,20 +36,22 @@
 
     /**
      * Returns the potentially annotated lower bounds of this wildcard type.
-     * Note that if no lower bound is explicitly declared, the lower bound is the
+     * If no lower bound is explicitly declared, the lower bound is the
      * type of null. In this case, a zero length array is returned.
      *
      * @return the potentially annotated lower bounds of this wildcard type or
      * an empty array if no lower bound is explicitly declared.
+     * @see WildcardType#getLowerBounds()
      */
     AnnotatedType[] getAnnotatedLowerBounds();
 
     /**
      * Returns the potentially annotated upper bounds of this wildcard type.
-     * Note that if no upper bound is explicitly declared, the upper bound is
+     * If no upper bound is explicitly declared, the upper bound is
      * unannotated {@code Object}
      *
      * @return the potentially annotated upper bounds of this wildcard type
+     * @see WildcardType#getUpperBounds()
      */
     AnnotatedType[] getAnnotatedUpperBounds();
 }
--- a/jdk/src/java.base/share/classes/java/lang/reflect/TypeVariable.java	Tue Jun 16 14:38:51 2015 -0700
+++ b/jdk/src/java.base/share/classes/java/lang/reflect/TypeVariable.java	Tue Jun 16 17:05:08 2015 -0700
@@ -51,7 +51,7 @@
 public interface TypeVariable<D extends GenericDeclaration> extends Type, AnnotatedElement {
     /**
      * Returns an array of {@code Type} objects representing the
-     * upper bound(s) of this type variable.  Note that if no upper bound is
+     * upper bound(s) of this type variable.  If no upper bound is
      * explicitly declared, the upper bound is {@code Object}.
      *
      * <p>For each upper bound B: <ul> <li>if B is a parameterized
@@ -67,7 +67,7 @@
      *     for any reason
      * @return an array of {@code Type}s representing the upper
      *     bound(s) of this type variable
-    */
+     */
     Type[] getBounds();
 
     /**
--- a/jdk/src/java.base/share/classes/java/lang/reflect/WildcardType.java	Tue Jun 16 14:38:51 2015 -0700
+++ b/jdk/src/java.base/share/classes/java/lang/reflect/WildcardType.java	Tue Jun 16 17:05:08 2015 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2003, 2004, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2015, 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
@@ -34,7 +34,7 @@
 public interface WildcardType extends Type {
     /**
      * Returns an array of {@code Type} objects representing the  upper
-     * bound(s) of this type variable.  Note that if no upper bound is
+     * bound(s) of this type variable.  If no upper bound is
      * explicitly declared, the upper bound is {@code Object}.
      *
      * <p>For each upper bound B :
@@ -57,7 +57,7 @@
 
     /**
      * Returns an array of {@code Type} objects representing the
-     * lower bound(s) of this type variable.  Note that if no lower bound is
+     * lower bound(s) of this type variable.  If no lower bound is
      * explicitly declared, the lower bound is the type of {@code null}.
      * In this case, a zero length array is returned.
      *