diff --git a/src/main/java/org/apache/commons/pool2/proxy/CglibProxyHandler.java b/src/main/java/org/apache/commons/pool2/proxy/CglibProxyHandler.java
index fcea73f70..654aaeb5e 100644
--- a/src/main/java/org/apache/commons/pool2/proxy/CglibProxyHandler.java
+++ b/src/main/java/org/apache/commons/pool2/proxy/CglibProxyHandler.java
@@ -24,7 +24,10 @@
 import net.sf.cglib.proxy.MethodProxy;
 
 /**
+ * cglib is unmaintained and does not work well (or possibly at all?) in newer JDKs, particularly JDK17+; see https://github.com/cglib/cglib
+ * <p>
  * CGLib implementation of the proxy handler.
+ * </p>
  *
  * @param <T> type of the wrapped pooled object
  *
diff --git a/src/main/java/org/apache/commons/pool2/proxy/CglibProxySource.java b/src/main/java/org/apache/commons/pool2/proxy/CglibProxySource.java
index 1a324292c..ee6ef7272 100644
--- a/src/main/java/org/apache/commons/pool2/proxy/CglibProxySource.java
+++ b/src/main/java/org/apache/commons/pool2/proxy/CglibProxySource.java
@@ -22,7 +22,10 @@
 import net.sf.cglib.proxy.Factory;
 
 /**
+ * cglib is unmaintained and does not work well (or possibly at all?) in newer JDKs, particularly JDK17+; see https://github.com/cglib/cglib
+ * <p>
  * Provides proxy objects using CGLib.
+ * </p>
  *
  * @param <T> type of the pooled object to be proxied
  *