From 0b8dd4ac82d366d7003ff1eb31a2a733f9fe8a1e Mon Sep 17 00:00:00 2001
From: Joe Darcy <darcy@openjdk.org>
Date: Wed, 25 May 2022 16:25:44 +0000
Subject: [PATCH] 8284966: Update SourceVersion.RELEASE_19 description for
 language changes

Reviewed-by: iris, jjg
---
 .../classes/javax/annotation/processing/package-info.java  | 3 +++
 .../share/classes/javax/lang/model/SourceVersion.java      | 5 ++++-
 .../classes/javax/lang/model/element/package-info.java     | 2 ++
 .../share/classes/javax/lang/model/package-info.java       | 7 +++++--
 .../share/classes/javax/lang/model/type/package-info.java  | 2 ++
 .../share/classes/javax/lang/model/util/package-info.java  | 3 +++
 6 files changed, 19 insertions(+), 3 deletions(-)

diff --git a/src/java.compiler/share/classes/javax/annotation/processing/package-info.java b/src/java.compiler/share/classes/javax/annotation/processing/package-info.java
index fec9c290058..1d2d2046886 100644
--- a/src/java.compiler/share/classes/javax/annotation/processing/package-info.java
+++ b/src/java.compiler/share/classes/javax/annotation/processing/package-info.java
@@ -36,5 +36,8 @@
  * a {@code NullPointerException} if given a {@code null} argument.
  *
  * @since 1.6
+ *
+ * @see <a href="https://jcp.org/en/jsr/detail?id=269">
+ * JSR 269: Pluggable Annotation Processing API</a>
  */
 package javax.annotation.processing;
diff --git a/src/java.compiler/share/classes/javax/lang/model/SourceVersion.java b/src/java.compiler/share/classes/javax/lang/model/SourceVersion.java
index 414313e8714..b1c6d0ee554 100644
--- a/src/java.compiler/share/classes/javax/lang/model/SourceVersion.java
+++ b/src/java.compiler/share/classes/javax/lang/model/SourceVersion.java
@@ -66,7 +66,8 @@ public enum SourceVersion {
      *  17: sealed classes, floating-point always strict (pattern
      *      matching for switch in preview)
      *  18: no changes (pattern matching for switch in second preview)
-     *  19: TBD
+     *  19: no changes (pattern matching for switch in third preview,
+     *      record patterns in preview)
      */
 
     /**
@@ -346,6 +347,8 @@ public enum SourceVersion {
      * The version recognized by the Java Platform, Standard Edition
      * 19.
      *
+     * No major changes from the prior release.
+     *
      * @since 19
      */
     RELEASE_19;
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 bb4839944e1..6e9b92bb806 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
@@ -110,6 +110,8 @@
  * a {@code NullPointerException} if given a {@code null} argument.
  *
  * @see javax.lang.model.util.Elements
+ * @see <a href="https://jcp.org/en/jsr/detail?id=269">
+ * JSR 269: Pluggable Annotation Processing API</a>
  * @jls 6.1 Declarations
  * @jls 7.4 Package Declarations
  * @jls 7.7 Module Declarations
diff --git a/src/java.compiler/share/classes/javax/lang/model/package-info.java b/src/java.compiler/share/classes/javax/lang/model/package-info.java
index 65b0d407efb..44a31977bd0 100644
--- a/src/java.compiler/share/classes/javax/lang/model/package-info.java
+++ b/src/java.compiler/share/classes/javax/lang/model/package-info.java
@@ -36,8 +36,8 @@
  * <p> This language model follows a <i>mirror</i>-based design; see
  *
  * <blockquote>
- * Gilad Bracha and David Ungar. <i>Mirrors: Design Principles for
- * Meta-level Facilities of Object-Oriented Programming Languages</i>.
+ * Gilad Bracha and David Ungar. <cite>Mirrors: Design Principles for
+ * Meta-level Facilities of Object-Oriented Programming Languages</cite>.
  * In Proc. of the ACM Conf. on Object-Oriented Programming, Systems,
  * Languages and Applications, October 2004.
  * </blockquote>
@@ -53,6 +53,9 @@
  * a {@code NullPointerException} if given a {@code null} argument.
  *
  * @since 1.6
+ *
+ * @see <a href="https://jcp.org/en/jsr/detail?id=269">
+ * JSR 269: Pluggable Annotation Processing API</a>
  */
 
 package javax.lang.model;
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 c5500d59ecb..712cfe0f217 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
@@ -34,6 +34,8 @@
  * a {@code NullPointerException} if given a {@code null} argument.
  *
  * @see javax.lang.model.util.Types
+ * @see <a href="https://jcp.org/en/jsr/detail?id=269">
+ * JSR 269: Pluggable Annotation Processing API</a>
  * @jls 4.1 The Kinds of Types and Values
  * @jls 4.2 Primitive Types and Values
  * @jls 4.3 Reference Types and Values
diff --git a/src/java.compiler/share/classes/javax/lang/model/util/package-info.java b/src/java.compiler/share/classes/javax/lang/model/util/package-info.java
index e6f34e6870a..b906cdbf342 100644
--- a/src/java.compiler/share/classes/javax/lang/model/util/package-info.java
+++ b/src/java.compiler/share/classes/javax/lang/model/util/package-info.java
@@ -36,5 +36,8 @@
  * a {@code NullPointerException} if given a {@code null} argument.
  *
  * @since 1.6
+ *
+ * @see <a href="https://jcp.org/en/jsr/detail?id=269">
+ * JSR 269: Pluggable Annotation Processing API</a>
  */
 package javax.lang.model.util;