diff --git a/src/java.compiler/share/classes/javax/annotation/processing/Filer.java b/src/java.compiler/share/classes/javax/annotation/processing/Filer.java index 7fe41006104..e077d7b7edb 100644 --- a/src/java.compiler/share/classes/javax/annotation/processing/Filer.java +++ b/src/java.compiler/share/classes/javax/annotation/processing/Filer.java @@ -164,7 +164,7 @@ public interface Filer { * An implementation may use information about the configuration of * the annotation processing tool as part of the inference. * - *

Creating a source file in or for an unnamed package in a named + *

Creating a source file in or for an unnamed package in a named * module is not supported. * * @apiNote To use a particular {@linkplain @@ -240,7 +240,7 @@ public interface Filer { * An implementation may use information about the configuration of * the annotation processing tool as part of the inference. * - *

Creating a class file in or for an unnamed package in a named + *

Creating a class file in or for an unnamed package in a named * module is not supported. * * @apiNote To avoid subsequent errors, the contents of the class diff --git a/src/java.compiler/share/classes/javax/annotation/processing/Processor.java b/src/java.compiler/share/classes/javax/annotation/processing/Processor.java index c9bd9738b20..c4ff4619c79 100644 --- a/src/java.compiler/share/classes/javax/annotation/processing/Processor.java +++ b/src/java.compiler/share/classes/javax/annotation/processing/Processor.java @@ -234,7 +234,7 @@ public interface Processor { * in which case it may wish to report a warning. * * @return the options recognized by this processor or an - * empty collection if none + * empty set if none * @see javax.annotation.processing.SupportedOptions */ Set getSupportedOptions(); @@ -286,7 +286,8 @@ public interface Processor { * * * where TypeName and ModuleName are as defined in - * The Java™ Language Specification. + * The Java™ Language Specification + * ({@jls 6.5 Determining the Meaning of a Name}). * * @apiNote When running in an environment which supports modules, * processors are encouraged to include the module prefix when @@ -297,9 +298,9 @@ public interface Processor { * environment without modules. * * @return the names of the annotation types supported by this processor + * or an empty set if none * @see javax.annotation.processing.SupportedAnnotationTypes * @jls 3.8 Identifiers - * @jls 6.5 Determining the Meaning of a Name */ Set getSupportedAnnotationTypes(); @@ -390,14 +391,14 @@ public interface Processor { * 

     * import static javax.annotation.processing.Completions.*;
     * ...
-    * return Arrays.asList({@link Completions#of(String) of}("3"),
-    *                      of("7"),
-    *                      of("31"),
-    *                      of("127"),
-    *                      of("8191"),
-    *                      of("131071"),
-    *                      of("524287"),
-    *                      of("2147483647"));
+    * return List.of({@link Completions#of(String) of}("3"),
+    *                of("7"),
+    *                of("31"),
+    *                of("127"),
+    *                of("8191"),
+    *                of("131071"),
+    *                of("524287"),
+    *                of("2147483647"));
     *
* * @@ -406,14 +407,14 @@ public interface Processor { * *
* 
-    * return Arrays.asList({@link Completions#of(String, String) of}("3",          "M2"),
-    *                      of("7",          "M3"),
-    *                      of("31",         "M5"),
-    *                      of("127",        "M7"),
-    *                      of("8191",       "M13"),
-    *                      of("131071",     "M17"),
-    *                      of("524287",     "M19"),
-    *                      of("2147483647", "M31"));
+    * return List.of({@link Completions#of(String, String) of}("3",          "M2"),
+    *                of("7",          "M3"),
+    *                of("31",         "M5"),
+    *                of("127",        "M7"),
+    *                of("8191",       "M13"),
+    *                of("131071",     "M17"),
+    *                of("524287",     "M19"),
+    *                of("2147483647", "M31"));
     *
*
* diff --git a/src/java.compiler/share/classes/javax/lang/model/AnnotatedConstruct.java b/src/java.compiler/share/classes/javax/lang/model/AnnotatedConstruct.java index d639af0bdcf..6f9220edf7b 100644 --- a/src/java.compiler/share/classes/javax/lang/model/AnnotatedConstruct.java +++ b/src/java.compiler/share/classes/javax/lang/model/AnnotatedConstruct.java @@ -81,8 +81,8 @@ import javax.lang.model.type.*; * C, then if AT is repeatable annotation type, an * annotation of type ATC is {@linkplain javax.lang.model.util.Elements#getOrigin(AnnotatedConstruct, AnnotationMirror) implicitly declared} on C. *
  • A representation of A appears in the executable output - * for C, such as the {@code RuntimeVisibleAnnotations} or - * {@code RuntimeVisibleParameterAnnotations} attributes of a class + * for C, such as the {@code RuntimeVisibleAnnotations} (JVMS {@jvms 4.7.16}) or + * {@code RuntimeVisibleParameterAnnotations} (JVMS {@jvms 4.7.17}) attributes of a class * file. * * diff --git a/src/java.compiler/share/classes/javax/lang/model/UnknownEntityException.java b/src/java.compiler/share/classes/javax/lang/model/UnknownEntityException.java index 34971fab11e..3e2cee42400 100644 --- a/src/java.compiler/share/classes/javax/lang/model/UnknownEntityException.java +++ b/src/java.compiler/share/classes/javax/lang/model/UnknownEntityException.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2009, 2017, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2009, 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 @@ -32,10 +32,6 @@ package javax.lang.model; * this exception may be thrown by visitors to indicate that the * visitor was created for a prior version of the language. * - * @apiNote A common superclass for exceptions specific to different - * kinds of unknown entities allows a single catch block to easily - * provide uniform handling of those related conditions. - * * @author Joseph D. Darcy * @see javax.lang.model.element.UnknownElementException * @see javax.lang.model.element.UnknownAnnotationValueException diff --git a/src/java.compiler/share/classes/javax/lang/model/element/Element.java b/src/java.compiler/share/classes/javax/lang/model/element/Element.java index 39b3d14e03f..0e1593cd2b1 100644 --- a/src/java.compiler/share/classes/javax/lang/model/element/Element.java +++ b/src/java.compiler/share/classes/javax/lang/model/element/Element.java @@ -37,7 +37,7 @@ import javax.lang.model.util.*; /** * Represents a program element such as a module, package, class, or method. - * Each element represents a static, language-level construct + * Each element represents a compile-time language-level construct * (and not, for example, a runtime construct of the virtual machine). * *

    Elements should be compared using the {@link #equals(Object)} diff --git a/src/java.compiler/share/classes/javax/lang/model/element/RecordComponentElement.java b/src/java.compiler/share/classes/javax/lang/model/element/RecordComponentElement.java index 5b7d4ce54ff..be4bd7c2680 100644 --- a/src/java.compiler/share/classes/javax/lang/model/element/RecordComponentElement.java +++ b/src/java.compiler/share/classes/javax/lang/model/element/RecordComponentElement.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2019, 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 @@ -55,7 +55,7 @@ public interface RecordComponentElement extends Element { * Returns the simple name of this record component. * *

    The name of each record component must be distinct from the - * names of all other record components. + * names of all other record components of the same record. * * @return the simple name of this record component * diff --git a/src/java.compiler/share/classes/javax/lang/model/element/package-info.java b/src/java.compiler/share/classes/javax/lang/model/element/package-info.java index 83f849d6230..6787ea97538 100644 --- a/src/java.compiler/share/classes/javax/lang/model/element/package-info.java +++ b/src/java.compiler/share/classes/javax/lang/model/element/package-info.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 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 @@ -50,7 +50,7 @@ * recovered from class files and class files might not be able to * provide source position information. * - * Names of parameters may not be recoverable from class files. + * Names of {@linkplain javax.lang.model.element.ExecutableElement#getParameters() parameters} may not be recoverable from class files. * * The {@linkplain javax.lang.model.element.Modifier modifiers} on an * element created from a class file may differ in some cases from an @@ -108,6 +108,15 @@ * @author Scott Seligman * @author Peter von der Ahé * @see javax.lang.model.util.Elements + * @jls 6.1 Declarations + * @jls 7.4 Package Declarations + * @jls 7.7 Module Declarations + * @jls 8.1 Class Declarations + * @jls 8.3 Field Declarations + * @jls 8.4 Method Declarations + * @jls 8.5 Member Type Declarations + * @jls 8.8 Constructor Declarations + * @jls 9.1 Interface Declarations * @since 1.6 */ package javax.lang.model.element; diff --git a/src/java.compiler/share/classes/javax/lang/model/type/NullType.java b/src/java.compiler/share/classes/javax/lang/model/type/NullType.java index 2bb96e3c4b2..cc41a02990e 100644 --- a/src/java.compiler/share/classes/javax/lang/model/type/NullType.java +++ b/src/java.compiler/share/classes/javax/lang/model/type/NullType.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2006, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 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 @@ -33,6 +33,8 @@ package javax.lang.model.type; * @author Joseph D. Darcy * @author Scott Seligman * @author Peter von der Ahé + * @jls 3.10.7 The Null Literal + * @jls 4.1 The Kinds of Types and Values * @since 1.6 */ diff --git a/src/java.compiler/share/classes/javax/lang/model/type/PrimitiveType.java b/src/java.compiler/share/classes/javax/lang/model/type/PrimitiveType.java index 4c8883c0223..e91f1ef2998 100644 --- a/src/java.compiler/share/classes/javax/lang/model/type/PrimitiveType.java +++ b/src/java.compiler/share/classes/javax/lang/model/type/PrimitiveType.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2006, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 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 @@ -34,6 +34,7 @@ package javax.lang.model.type; * @author Joseph D. Darcy * @author Scott Seligman * @author Peter von der Ahé + * @jls 4.2 Primitive Types and Values * @since 1.6 */ public interface PrimitiveType extends TypeMirror { diff --git a/src/java.compiler/share/classes/javax/lang/model/type/ReferenceType.java b/src/java.compiler/share/classes/javax/lang/model/type/ReferenceType.java index d41a72b2d5c..9ab823ee81b 100644 --- a/src/java.compiler/share/classes/javax/lang/model/type/ReferenceType.java +++ b/src/java.compiler/share/classes/javax/lang/model/type/ReferenceType.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2006, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 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 @@ -34,6 +34,7 @@ package javax.lang.model.type; * @author Joseph D. Darcy * @author Scott Seligman * @author Peter von der Ahé + * @jls 4.3 Reference Types and Values * @since 1.6 */ public interface ReferenceType extends TypeMirror { diff --git a/src/java.compiler/share/classes/javax/lang/model/type/TypeMirror.java b/src/java.compiler/share/classes/javax/lang/model/type/TypeMirror.java index 7d2b862ee00..f8881f7b04a 100644 --- a/src/java.compiler/share/classes/javax/lang/model/type/TypeMirror.java +++ b/src/java.compiler/share/classes/javax/lang/model/type/TypeMirror.java @@ -55,6 +55,14 @@ import javax.lang.model.util.Types; * @author Peter von der Ahé * @see Element * @see 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.6 */ public interface TypeMirror extends javax.lang.model.AnnotatedConstruct { diff --git a/src/java.compiler/share/classes/javax/lang/model/type/TypeVariable.java b/src/java.compiler/share/classes/javax/lang/model/type/TypeVariable.java index dd45b59c68a..1056ad7c356 100644 --- a/src/java.compiler/share/classes/javax/lang/model/type/TypeVariable.java +++ b/src/java.compiler/share/classes/javax/lang/model/type/TypeVariable.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 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 @@ -38,13 +38,14 @@ import javax.lang.model.util.Types; * type, method, or constructor. * A type variable may also be declared implicitly, as by * the capture conversion of a wildcard type argument - * (see chapter 5 of + * (see chapter {@jls 5} of * The Java™ Language Specification). * * @author Joseph D. Darcy * @author Scott Seligman * @author Peter von der Ahé * @see TypeParameterElement + * @jls 4.4 Type Variables * @since 1.6 */ public interface TypeVariable extends ReferenceType { @@ -67,6 +68,7 @@ public interface TypeVariable extends ReferenceType { * {@linkplain IntersectionType#getBounds() bounds}. * * @return the upper bound of this type variable + * @jls 4.9 Intersection Types */ TypeMirror getUpperBound(); @@ -78,6 +80,7 @@ public interface TypeVariable extends ReferenceType { * lower bound of {@link NullType}. * * @return the lower bound of this type variable + * @jls 18.1.3. Bounds */ TypeMirror getLowerBound(); } diff --git a/src/java.compiler/share/classes/javax/lang/model/type/UnionType.java b/src/java.compiler/share/classes/javax/lang/model/type/UnionType.java index 97d7014bb6e..d33d696b384 100644 --- a/src/java.compiler/share/classes/javax/lang/model/type/UnionType.java +++ b/src/java.compiler/share/classes/javax/lang/model/type/UnionType.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2010, 2017, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2010, 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 @@ -33,6 +33,7 @@ import java.util.List; * Union types can appear as the type of a multi-catch exception * parameter. * + * @jls 14.20 The try statement * @since 1.7 */ public interface UnionType extends TypeMirror { diff --git a/src/java.compiler/share/classes/javax/lang/model/type/WildcardType.java b/src/java.compiler/share/classes/javax/lang/model/type/WildcardType.java index 859cdfc6c0a..f6d091c8d00 100644 --- a/src/java.compiler/share/classes/javax/lang/model/type/WildcardType.java +++ b/src/java.compiler/share/classes/javax/lang/model/type/WildcardType.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2006, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 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 @@ -41,6 +41,7 @@ package javax.lang.model.type; * @author Joseph D. Darcy * @author Scott Seligman * @author Peter von der Ahé + * @jls 4.5.1 Type Arguments of Parameterized Types * @since 1.6 */ public interface WildcardType extends TypeMirror { diff --git a/src/java.compiler/share/classes/javax/lang/model/type/package-info.java b/src/java.compiler/share/classes/javax/lang/model/type/package-info.java index a33eba0f684..13ec0f638bc 100644 --- a/src/java.compiler/share/classes/javax/lang/model/type/package-info.java +++ b/src/java.compiler/share/classes/javax/lang/model/type/package-info.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 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 @@ -37,6 +37,14 @@ * @author Scott Seligman * @author Peter von der Ahé * @see javax.lang.model.util.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.6 */ package javax.lang.model.type;