From 2c911b0a1838e2a09aa650c442ee6529068e3a59 Mon Sep 17 00:00:00 2001
From: Artur Barashev <artur.barashev@oracle.com>
Date: Wed, 28 Jan 2026 21:47:18 -0500
Subject: [PATCH] Update javadoc

---
 .../share/classes/javax/net/ssl/SSLParameters.java | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/src/java.base/share/classes/javax/net/ssl/SSLParameters.java b/src/java.base/share/classes/javax/net/ssl/SSLParameters.java
index 7272d9793a5..1233aeb2c5d 100644
--- a/src/java.base/share/classes/javax/net/ssl/SSLParameters.java
+++ b/src/java.base/share/classes/javax/net/ssl/SSLParameters.java
@@ -964,9 +964,18 @@ public class SSLParameters {
 
     /**
      * Sets whether TLS certificate compression should be enabled.
-     * <p>
      * This method only applies to TLSv1.3.
      *
+     * @apiNote The peer needs to support the underlying extension
+     * and compression format in order for certificate compression
+     * to work.
+     *
+     * @implNote The SunJSSE provider supports only zlib compression.
+     * Other JSSE providers may not support this method.
+     *
+     * @spec https://www.rfc-editor.org/info/rfc8879
+     * RFC 8879: TLS Certificate Compression
+     *
      * @param   enableCertificateCompression
      *          {@code true} indicates that TLS certificate compression
      *          should be enabled; {@code false} indicates that TLS certificate
@@ -982,8 +991,7 @@ public class SSLParameters {
     }
 
     /**
-     * Returns whether TLS certificate compression should be enabled
-     * <p>
+     * Returns whether TLS certificate compression should be enabled.
      * This method only applies to TLSv1.3.
      *
      * @return  true, if TLS certificate compression should be enabled