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-jcs.git


The following commit(s) were added to refs/heads/master by this push:
     new e0834d9e Javadoc
e0834d9e is described below

commit e0834d9ec8bd60f73ff1a9cf52867a4ecca210ea
Author: Gary Gregory <garydgreg...@gmail.com>
AuthorDate: Sun Mar 23 10:40:11 2025 -0400

    Javadoc
---
 .../socket/tcp/TCPLateralCacheAttributes.java      | 38 +++++++--------
 .../tcp/behavior/ITCPLateralCacheAttributes.java   |  2 +-
 .../jcs3/engine/CompositeCacheAttributes.java      | 54 +++++++++++-----------
 .../engine/behavior/ICompositeCacheAttributes.java |  6 +--
 4 files changed, 50 insertions(+), 50 deletions(-)

diff --git 
a/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/TCPLateralCacheAttributes.java
 
b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/TCPLateralCacheAttributes.java
index 6894ecde..b44d745d 100644
--- 
a/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/TCPLateralCacheAttributes.java
+++ 
b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/TCPLateralCacheAttributes.java
@@ -122,7 +122,7 @@ public class TCPLateralCacheAttributes
 
     /**
      * Gets the tcpListenerHost attribute of the ILateralCacheAttributes object
-     * <p>
+     *
      * @return The tcpListenerHost value
      */
     @Override
@@ -133,7 +133,7 @@ public class TCPLateralCacheAttributes
 
     /**
      * Gets the tcpListenerPort attribute of the ILateralCacheAttributes object
-     * <p>
+     *
      * @return The tcpListenerPort value
      */
     @Override
@@ -144,7 +144,7 @@ public class TCPLateralCacheAttributes
 
     /**
      * Gets the tcpServer attribute of the ILateralCacheAttributes object
-     * <p>
+     *
      * @return The tcpServer value
      */
     @Override
@@ -155,7 +155,7 @@ public class TCPLateralCacheAttributes
 
     /**
      * Gets the tcpServers attribute of the ILateralCacheAttributes object
-     * <p>
+     *
      * @return The tcpServers value
      */
     @Override
@@ -166,7 +166,7 @@ public class TCPLateralCacheAttributes
 
     /**
      * The address to broadcast to if UDPDiscovery is enabled.
-     * <p>
+     *
      * @return the udpDiscoveryAddr.
      */
     @Override
@@ -177,7 +177,7 @@ public class TCPLateralCacheAttributes
 
     /**
      * The port to use if UDPDiscovery is enabled.
-     * <p>
+     *
      * @return the udpDiscoveryPort.
      */
     @Override
@@ -188,7 +188,7 @@ public class TCPLateralCacheAttributes
 
     /**
      * The time-to-live for the UDP multicast packets
-     * <p>
+     *
      * @return the udpTTL.
      * @since 3.1
      */
@@ -200,7 +200,7 @@ public class TCPLateralCacheAttributes
 
     /**
      * Is the lateral allowed to try and get from other laterals.
-     * <p>
+     *
      * @return true if the lateral will try to get
      */
     @Override
@@ -211,7 +211,7 @@ public class TCPLateralCacheAttributes
 
     /**
      * Is the lateral allowed to put objects to other laterals.
-     * <p>
+     *
      * @return true if puts are allowed
      */
     @Override
@@ -226,7 +226,7 @@ public class TCPLateralCacheAttributes
      * then it will compare the hash code. if they are the same, it will not 
remove. This isn't
      * perfect since different objects can have the same hash code, but it is 
unlikely of objects of
      * the same type.
-     * <p>
+     *
      * @return boolean
      */
     @Override
@@ -239,7 +239,7 @@ public class TCPLateralCacheAttributes
      * Should the client send a remove command rather than a put when update 
is called. This is a
      * client option, not a receiver option. This allows you to prevent the 
lateral from serializing
      * objects.
-     * <p>
+     *
      * @return true if updates will result in a remove command being sent.
      */
     @Override
@@ -249,8 +249,8 @@ public class TCPLateralCacheAttributes
     }
 
     /**
-     * Whether or not TCP laterals can try to find each other by multicast 
communication.
-     * <p>
+     * Tests whether or not TCP laterals can try to find each other by 
multicast communication.
+     *
      * @return the udpDiscoveryEnabled.
      */
     @Override
@@ -274,7 +274,7 @@ public class TCPLateralCacheAttributes
 
     /**
      * Is the lateral allowed to put objects to other laterals.
-     * <p>
+     *
      * @param allowPut
      */
     @Override
@@ -289,7 +289,7 @@ public class TCPLateralCacheAttributes
      * then it will compare the hash code. if they are the same, it will not 
remove. This isn't
      * perfect since different objects can have the same hash code, but it is 
unlikely of objects of
      * the same type.
-     * <p>
+     *
      * @param filter
      */
     @Override
@@ -302,7 +302,7 @@ public class TCPLateralCacheAttributes
      * Should the client send a remove command rather than a put when update 
is called. This is a
      * client option, not a receiver option. This allows you to prevent the 
lateral from serializing
      * objects.
-     * <p>
+     *
      * @param issueRemoveOnPut
      */
     @Override
@@ -331,7 +331,7 @@ public class TCPLateralCacheAttributes
 
     /**
      * Sets the tcpListenerHost attribute of the ILateralCacheAttributes object
-     * <p>
+     *
      * @param val
      *            The new tcpListenerHost value
      */
@@ -343,7 +343,7 @@ public class TCPLateralCacheAttributes
 
     /**
      * Sets the tcpListenerPort attribute of the ILateralCacheAttributes object
-     * <p>
+     *
      * @param val The new tcpListenerPort value
      */
     @Override
@@ -354,7 +354,7 @@ public class TCPLateralCacheAttributes
 
     /**
      * Sets the tcpServer attribute of the ILateralCacheAttributes object
-     * <p>
+     *
      * @param val The new tcpServer value
      */
     @Override
diff --git 
a/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/behavior/ITCPLateralCacheAttributes.java
 
b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/behavior/ITCPLateralCacheAttributes.java
index b86e8fa5..841accbf 100644
--- 
a/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/behavior/ITCPLateralCacheAttributes.java
+++ 
b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/auxiliary/lateral/socket/tcp/behavior/ITCPLateralCacheAttributes.java
@@ -125,7 +125,7 @@ public interface ITCPLateralCacheAttributes
     boolean isIssueRemoveOnPut();
 
     /**
-     * Whether or not TCP laterals can try to find each other by multicast
+     * Tests whether or not TCP laterals can try to find each other by 
multicast
      * communication.
      * <p>
      * @return the udpDiscoveryEnabled.
diff --git 
a/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/engine/CompositeCacheAttributes.java
 
b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/engine/CompositeCacheAttributes.java
index 120b0bda..5ec27550 100644
--- 
a/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/engine/CompositeCacheAttributes.java
+++ 
b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/engine/CompositeCacheAttributes.java
@@ -127,7 +127,7 @@ public class CompositeCacheAttributes
 
     /**
      * Gets the cacheName attribute of the CompositeCacheAttributes object
-     * <p>
+     *
      * @return The cacheName value
      */
     @Override
@@ -147,7 +147,7 @@ public class CompositeCacheAttributes
 
     /**
      * If UseMemoryShrinker is true the memory cache should auto-expire 
elements to reclaim space.
-     * <p>
+     *
      * @return The MaxMemoryIdleTimeSeconds value
      */
     @Override
@@ -158,7 +158,7 @@ public class CompositeCacheAttributes
 
     /**
      * Gets the maxObjects attribute of the CompositeCacheAttributes object
-     * <p>
+     *
      * @return The maxObjects value
      */
     @Override
@@ -170,7 +170,7 @@ public class CompositeCacheAttributes
     /**
      * If UseMemoryShrinker is true the memory cache should auto-expire 
elements to reclaim space.
      * This gets the maximum number of items to spool per run.
-     * <p>
+     *
      * @return The maxSpoolPerRun value
      */
     @Override
@@ -181,7 +181,7 @@ public class CompositeCacheAttributes
 
     /**
      * Gets the memoryCacheName attribute of the CompositeCacheAttributes 
object
-     * <p>
+     *
      * @return The memoryCacheName value
      */
     @Override
@@ -193,7 +193,7 @@ public class CompositeCacheAttributes
     /**
      * If UseMemoryShrinker is true the memory cache should auto-expire 
elements to reclaim space.
      * This gets the shrinker interval.
-     * <p>
+     *
      * @return The ShrinkerIntervalSeconds value
      */
     @Override
@@ -204,7 +204,7 @@ public class CompositeCacheAttributes
 
     /**
      * Number to send to disk at the time when memory is full.
-     * <p>
+     *
      * @return int
      */
     @Override
@@ -215,7 +215,7 @@ public class CompositeCacheAttributes
 
     /**
      * Gets the useDisk attribute of the CompositeCacheAttributes object
-     * <p>
+     *
      * @return The useDisk value
      */
     @Override
@@ -226,7 +226,7 @@ public class CompositeCacheAttributes
 
     /**
      * Gets the useLateral attribute of the CompositeCacheAttributes object
-     * <p>
+     *
      * @return The useLateral value
      */
     @Override
@@ -236,8 +236,8 @@ public class CompositeCacheAttributes
     }
 
     /**
-     * Whether the memory cache should perform background memory shrinkage.
-     * <p>
+     * Tests whether the memory cache should perform background memory 
shrinkage.
+     *
      * @return The UseMemoryShrinker value
      */
     @Override
@@ -248,7 +248,7 @@ public class CompositeCacheAttributes
 
     /**
      * Gets the useRemote attribute of the CompositeCacheAttributes object
-     * <p>
+     *
      * @return The useRemote value
      */
     @Override
@@ -259,7 +259,7 @@ public class CompositeCacheAttributes
 
     /**
      * Sets the cacheName attribute of the CompositeCacheAttributes object
-     * <p>
+     *
      * @param s The new cacheName value
      */
     @Override
@@ -270,7 +270,7 @@ public class CompositeCacheAttributes
 
     /**
      * By default this is SWAP_ONLY.
-     * <p>
+     *
      * @param diskUsagePattern The diskUsagePattern to set.
      */
     @Override
@@ -283,7 +283,7 @@ public class CompositeCacheAttributes
      * Translates the name to the disk usage pattern short value.
      * <p>
      * The allowed values are SWAP and UPDATE.
-     * <p>
+     *
      * @param diskUsagePatternName The diskUsagePattern to set.
      */
     @Override
@@ -305,7 +305,7 @@ public class CompositeCacheAttributes
 
     /**
      * If UseMemoryShrinker is true the memory cache should auto-expire 
elements to reclaim space.
-     * <p>
+     *
      * @param seconds The new MaxMemoryIdleTimeSeconds value
      */
     @Override
@@ -316,7 +316,7 @@ public class CompositeCacheAttributes
 
     /**
      * Sets the maxObjects attribute of the CompositeCacheAttributes object
-     * <p>
+     *
      * @param maxObjs The new maxObjects value
      */
     @Override
@@ -330,7 +330,7 @@ public class CompositeCacheAttributes
      * This sets the maximum number of items to spool per run.
      * <p>
      * If the value is -1, then there is no limit to the number of items to be 
spooled.
-     * <p>
+     *
      * @param maxSpoolPerRun The new maxSpoolPerRun value
      */
     @Override
@@ -341,7 +341,7 @@ public class CompositeCacheAttributes
 
     /**
      * Sets the memoryCacheName attribute of the CompositeCacheAttributes 
object
-     * <p>
+     *
      * @param s The new memoryCacheName value
      */
     @Override
@@ -353,7 +353,7 @@ public class CompositeCacheAttributes
     /**
      * If UseMemoryShrinker is true the memory cache should auto-expire 
elements to reclaim space.
      * This sets the shrinker interval.
-     * <p>
+     *
      * @param seconds The new ShrinkerIntervalSeconds value
      */
     @Override
@@ -364,7 +364,7 @@ public class CompositeCacheAttributes
 
     /**
      * Number to send to disk at a time.
-     * <p>
+     *
      * @param spoolChunkSize
      */
     @Override
@@ -375,7 +375,7 @@ public class CompositeCacheAttributes
 
     /**
      * Sets the useDisk attribute of the CompositeCacheAttributes object
-     * <p>
+     *
      * @param useDisk The new useDisk value
      */
     @Override
@@ -386,7 +386,7 @@ public class CompositeCacheAttributes
 
     /**
      * Sets the useLateral attribute of the CompositeCacheAttributes object
-     * <p>
+     *
      * @param b The new useLateral value
      */
     @Override
@@ -396,8 +396,8 @@ public class CompositeCacheAttributes
     }
 
     /**
-     * Whether the memory cache should perform background memory shrinkage.
-     * <p>
+     * Sets whether the memory cache should perform background memory 
shrinkage.
+     *
      * @param useShrinker The new UseMemoryShrinker value
      */
     @Override
@@ -408,7 +408,7 @@ public class CompositeCacheAttributes
 
     /**
      * Sets the useRemote attribute of the CompositeCacheAttributes object
-     * <p>
+     *
      * @param useRemote The new useRemote value
      */
     @Override
@@ -419,7 +419,7 @@ public class CompositeCacheAttributes
 
     /**
      * Dumps the core attributes.
-     * <p>
+     *
      * @return For debugging.
      */
     @Override
diff --git 
a/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/engine/behavior/ICompositeCacheAttributes.java
 
b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/engine/behavior/ICompositeCacheAttributes.java
index 33419719..48c02c69 100644
--- 
a/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/engine/behavior/ICompositeCacheAttributes.java
+++ 
b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/engine/behavior/ICompositeCacheAttributes.java
@@ -117,7 +117,7 @@ public interface ICompositeCacheAttributes
     boolean isUseLateral();
 
     /**
-     * Whether the memory cache should perform background memory shrinkage.
+     * Tests whether the memory cache should perform background memory 
shrinkage.
      * <p>
      * @return The UseMemoryShrinker value
      */
@@ -219,7 +219,7 @@ public interface ICompositeCacheAttributes
     void setUseDisk( boolean useDisk );
 
     /**
-     * set whether the cache should use a lateral cache
+     * Sets whether the cache should use a lateral cache
      * <p>
      * @param d
      *            The new useLateral value
@@ -227,7 +227,7 @@ public interface ICompositeCacheAttributes
     void setUseLateral( boolean d );
 
     /**
-     * Whether the memory cache should perform background memory shrinkage.
+     * Sets whether the memory cache should perform background memory 
shrinkage.
      * <p>
      * @param useShrinker
      *            The new UseMemoryShrinker value

Reply via email to