This is an automated email from the ASF dual-hosted git repository.

ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-pool.git

commit 8a1846885e3c31cd0389669333a308d0f23aad7f
Author: Gary Gregory <[email protected]>
AuthorDate: Thu Jun 3 08:40:19 2021 -0400

    Slightly better Javadoc; use wider line length.
---
 .../apache/commons/pool2/PooledObjectState.java    | 28 ++++++++++------------
 1 file changed, 12 insertions(+), 16 deletions(-)

diff --git a/src/main/java/org/apache/commons/pool2/PooledObjectState.java 
b/src/main/java/org/apache/commons/pool2/PooledObjectState.java
index d10a9f3..f09dbb8 100644
--- a/src/main/java/org/apache/commons/pool2/PooledObjectState.java
+++ b/src/main/java/org/apache/commons/pool2/PooledObjectState.java
@@ -17,7 +17,7 @@
 package org.apache.commons.pool2;
 
 /**
- * Provides the possible states that a {@link PooledObject} may be in.
+ * Provides all possible states of a {@link PooledObject}.
  *
  * @since 2.0
  */
@@ -39,12 +39,12 @@ public enum PooledObjectState {
     EVICTION,
 
     /**
-     * Not in the queue, currently being tested for possible eviction. An
-     * attempt to borrow the object was made while being tested which removed 
it
-     * from the queue. It should be returned to the head of the queue once
-     * eviction testing completes.
-     * TODO: Consider allocating object and ignoring the result of the eviction
-     *       test.
+     * Not in the queue, currently being tested for possible eviction. An 
attempt to borrow the object was made while
+     * being tested which removed it from the queue. It should be returned to 
the head of the queue once eviction
+     * testing completes.
+     * <p>
+     * TODO: Consider allocating object and ignoring the result of the 
eviction test.
+     * </p>
      */
     EVICTION_RETURN_TO_HEAD,
 
@@ -54,24 +54,20 @@ public enum PooledObjectState {
     VALIDATION,
 
     /**
-     * Not in queue, currently being validated. The object was borrowed while
-     * being validated and since testOnBorrow was configured, it was removed
-     * from the queue and pre-allocated. It should be allocated once validation
-     * completes.
+     * Not in queue, currently being validated. The object was borrowed while 
being validated and since testOnBorrow was
+     * configured, it was removed from the queue and pre-allocated. It should 
be allocated once validation completes.
      */
     VALIDATION_PREALLOCATED,
 
     /**
-     * Not in queue, currently being validated. An attempt to borrow the object
-     * was made while previously being tested for eviction which removed it 
from
-     * the queue. It should be returned to the head of the queue once 
validation
+     * Not in queue, currently being validated. An attempt to borrow the 
object was made while previously being tested
+     * for eviction which removed it from the queue. It should be returned to 
the head of the queue once validation
      * completes.
      */
     VALIDATION_RETURN_TO_HEAD,
 
     /**
-     * Failed maintenance (e.g. eviction test or validation) and will be / has
-     * been destroyed
+     * Failed maintenance (e.g. eviction test or validation) and will be / has 
been destroyed
      */
     INVALID,
 

Reply via email to