8374752: Add more JLS links to javax.lang.model.element.*

Reviewed-by: liach

src/java.compiler/share/classes/javax/lang/model/element/ExecutableElement.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2005, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2026, 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,13 @@ import javax.lang.model.type.*;
  * clause, among other restrictions; see JLS {@jls 9.6.1} for details.
  *
  * @see ExecutableType
+ * @jls 8.4 Method Declarations
+ * @jls 8.6 Instance Initializers
+ * @jls 8.7 Static Initializers
+ * @jls 8.8 Constructor Declarations
+ * @jls 9.4 Method Declarations
+ * @jls 9.6.1 Annotation Interface Elements
+ *
  * @since 1.6
  */
 public interface ExecutableElement extends Element, Parameterizable {

src/java.compiler/share/classes/javax/lang/model/element/PackageElement.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2005, 2023, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2026, 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
@@ -58,6 +58,8 @@ import javax.lang.model.type.TypeMirror;
  * </ul>
  *
  * @see javax.lang.model.util.Elements#getPackageOf
+ * @jls 7.4 Package Declarations
+ *
  * @since 1.6
  */
 public interface PackageElement extends Element, QualifiedNameable {
@@ -87,6 +89,7 @@ public interface PackageElement extends Element, QualifiedNameable {
      * @return the fully qualified name of this package, or an
      * empty name if this is an unnamed package
      * @jls 6.7 Fully Qualified Names and Canonical Names
+     * @jls 7.4.1 Named Packages
      */
     Name getQualifiedName();
 

src/java.compiler/share/classes/javax/lang/model/element/Parameterizable.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009, 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2026, 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,10 @@ import java.util.List;
 /**
  * A mixin interface for an element that has type parameters.
  *
+ * @jls 4.5 Parameterized Types
+ * @jls 8.4.4 Generic Methods
+ * @jls 8.8.4 Generic Constructors
+ *
  * @since 1.7
  */
 public interface Parameterizable extends Element {

src/java.compiler/share/classes/javax/lang/model/element/QualifiedNameable.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009, 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2026, 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,10 @@ package javax.lang.model.element;
 /**
  * A mixin interface for an element that has a qualified name.
  *
+ * @jls 6.5.3.2 Qualified Package Names
+ * @jls 6.5.5.2 Qualified Type Names
+ * @jls 6.7 Fully Qualified Names and Canonical Names
+ *
  * @since 1.7
  */
 public interface QualifiedNameable extends Element {

src/java.compiler/share/classes/javax/lang/model/element/TypeElement.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2005, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2026, 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
@@ -80,7 +80,16 @@ import javax.lang.model.util.*;
  * javax.lang.model.util.Elements#getAllTypeElements(CharSequence)
  * queried for} in the configured environment
  * </ul>
+ *
  * @see DeclaredType
+ * @jls 8.1 Class Declarations
+ * @jls 8.5 Member Class and Interface Declarations
+ * @jls 8.9 Enum Classes
+ * @jls 8.10 Record Classes
+ * @jls 9.1 Interface Declarations
+ * @jls 9.5 Member Class and Interface Declarations
+ * @jls 9.6 Annotation Interfaces
+ *
  * @since 1.6
  */
 public interface TypeElement extends Element, Parameterizable, QualifiedNameable {

src/java.compiler/share/classes/javax/lang/model/element/TypeParameterElement.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2005, 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2026, 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
@@ -35,6 +35,11 @@ import javax.lang.model.type.TypeVariable;
  * A type parameter declares a {@link TypeVariable}.
  *
  * @see TypeVariable
+ * @jls 8.1.2 Generic Classes and Type Parameters
+ * @jls 8.4.4 Generic Methods
+ * @jls 8.8.4 Generic Constructors
+ * @jls 9.1.2 Generic Interfaces and Type Parameters
+ *
  * @since 1.6
  */
 public interface TypeParameterElement extends Element {

src/java.compiler/share/classes/javax/lang/model/element/VariableElement.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2005, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2026, 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,14 @@ import javax.lang.model.type.TypeKind;
  * parameter, local variable, resource variable, or exception
  * parameter.
  *
+ * @jls 8.3 Field Declaration
+ * @jls 8.9.1 Enum Constants
+ * @jls 8.4.1 Formal Parameters
+ * @jls 8.8.1 Formal Parameters
+ * @jls 14.4 Local Variable Declarations
+ * @jls 14.20 The {@code try} statement
+ * @jls 14.20.3 {@code try}-with-resources
+
  * @since 1.6
  */
 public interface VariableElement extends Element {