8250920: Increase @jls usage in core reflection

Reviewed-by: mchung

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

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2012, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2012, 2020, 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
@@ -31,6 +31,7 @@ package java.lang.reflect;
  * array type, whose component type may itself represent the annotated use of a
  * type.
  *
+ * @jls 10.1 Array Types
  * @since 1.8
  */
 public interface AnnotatedArrayType extends AnnotatedType {

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

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2012, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2012, 2020, 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
@@ -30,6 +30,7 @@ package java.lang.reflect;
  * of a parameterized type, whose type arguments may themselves represent
  * annotated uses of types.
  *
+ * @jls 4.5 Parameterized Types
  * @since 1.8
  */
 public interface AnnotatedParameterizedType extends AnnotatedType {

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

@@ -37,6 +37,14 @@ import java.lang.annotation.Annotation;
  * <em>type annotations</em> (JLS {@jls 9.7.4}) as the entity being
  * potentially annotated is a type.
  *
+ * @jls 4.1 The Kinds of Types and Values
+ * @jls 4.2 Primitive Types and Values
+ * @jls 4.3 Reference Types and Values
+ * @jls 4.4 Type Variables
+ * @jls 4.5 Parameterized Types
+ * @jls 4.8 Raw Types
+ * @jls 4.9 Intersection Types
+ * @jls 10.1 Array Types
  * @since 1.8
  */
 public interface AnnotatedType extends AnnotatedElement {

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

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2012, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2012, 2020, 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
@@ -30,6 +30,7 @@ package java.lang.reflect;
  * type variable, whose declaration may have bounds which themselves represent
  * annotated uses of types.
  *
+ * @jls 4.4 Type Variables
  * @since 1.8
  */
 public interface AnnotatedTypeVariable extends AnnotatedType {

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

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2012, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2012, 2020, 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
@@ -30,6 +30,7 @@ package java.lang.reflect;
  * wildcard type argument, whose upper or lower bounds may themselves represent
  * annotated uses of types.
  *
+ * @jls 4.5.1 Type Arguments of Parameterized Types
  * @since 1.8
  */
 public interface AnnotatedWildcardType extends AnnotatedType {

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

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2003, 2004, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2020, 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
@@ -28,6 +28,8 @@ package java.lang.reflect;
 /**
  * {@code GenericArrayType} represents an array type whose component
  * type is either a parameterized type or a type variable.
+ *
+ * @jls 10.1 Array Types
  * @since 1.5
  */
 public interface GenericArrayType extends Type {

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

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2003, 2004, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2020, 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
@@ -28,7 +28,7 @@ package java.lang.reflect;
 
 /**
  * ParameterizedType represents a parameterized type such as
- * Collection<String>.
+ * {@code Collection<String>}.
  *
  * <p>A parameterized type is created the first time it is needed by a
  * reflective method, as specified in this package. When a
@@ -42,6 +42,7 @@ package java.lang.reflect;
  * an equals() method that equates any two instances that share the
  * same generic type declaration and have equal type parameters.
  *
+ * @jls 4.5 Parameterized Types
  * @since 1.5
  */
 public interface ParameterizedType extends Type {

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

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2020, 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
@@ -30,6 +30,14 @@ package java.lang.reflect;
  * programming language. These include raw types, parameterized types,
  * array types, type variables and primitive types.
  *
+ * @jls 4.1 The Kinds of Types and Values
+ * @jls 4.2 Primitive Types and Values
+ * @jls 4.3 Reference Types and Values
+ * @jls 4.4 Type Variables
+ * @jls 4.5 Parameterized Types
+ * @jls 4.8 Raw Types
+ * @jls 4.9 Intersection Types
+ * @jls 10.1 Array Types
  * @since 1.5
  */
 public interface Type {

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

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2003, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2020, 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
@@ -46,6 +46,7 @@ package java.lang.reflect;
  * @param <D> the type of generic declaration that declared the
  * underlying type variable.
  *
+ * @jls 4.4 Type Variables
  * @since 1.5
  */
 public interface TypeVariable<D extends GenericDeclaration> extends Type, AnnotatedElement {

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

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2003, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2020, 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
@@ -29,6 +29,7 @@ package java.lang.reflect;
  * WildcardType represents a wildcard type expression, such as
  * {@code ?}, {@code ? extends Number}, or {@code ? super Integer}.
  *
+ * @jls 4.5.1 Type Arguments of Parameterized Types
  * @since 1.5
  */
 public interface WildcardType extends Type {