Javadoc

Remove redundant open paragraph HTML tag

Author: garydgregory

commons-jcs3-core/src/main/java/org/apache/commons/jcs3/JCS.java

@@ -82,7 +82,7 @@ else if ( configFileName != null )
 
     /**
      * Gets a GroupCacheAccess which accesses the provided region.
-     * <p>
+     *
      * @param region Region that return GroupCacheAccess will provide access to
      * @return A GroupCacheAccess which provides access to a given region.
      * @throws CacheException
@@ -96,7 +96,7 @@ public static <K, V> GroupCacheAccess<K, V> getGroupCacheInstance( final String
 
     /**
      * Gets a GroupCacheAccess which accesses the provided region.
-     * <p>
+     *
      * @param region Region that return GroupCacheAccess will provide access to
      * @param icca CacheAttributes for region
      * @return A GroupCacheAccess which provides access to a given region.
@@ -111,7 +111,7 @@ public static <K, V> GroupCacheAccess<K, V> getGroupCacheInstance( final String
 
     /**
      * Gets a GroupCacheAccess which accesses the provided region.
-     * <p>
+     *
      * @param region Region that return CacheAccess will provide access to
      * @param icca CacheAttributes for region
      * @param eattr ElementAttributes for the region
@@ -127,7 +127,7 @@ public static <K, V> GroupCacheAccess<K, V> getGroupCacheInstance( final String
 
     /**
      * Gets a CacheAccess which accesses the provided region.
-     * <p>
+     *
      * @param region Region that return CacheAccess will provide access to
      * @return A CacheAccess which provides access to a given region.
      * @throws CacheException
@@ -141,7 +141,7 @@ public static <K, V> CacheAccess<K, V> getInstance( final String region )
 
     /**
      * Gets a CacheAccess which accesses the provided region.
-     * <p>
+     *
      * @param region Region that return CacheAccess will provide access to
      * @param icca CacheAttributes for region
      * @return A CacheAccess which provides access to a given region.
@@ -156,7 +156,7 @@ public static <K, V> CacheAccess<K, V> getInstance( final String region, final I
 
     /**
      * Gets a CacheAccess which accesses the provided region.
-     * <p>
+     *
      * @param region Region that return CacheAccess will provide access to
      * @param icca CacheAttributes for region
      * @param eattr ElementAttributes for the region

commons-jcs3-core/src/main/java/org/apache/commons/jcs3/access/AbstractCacheAccess.java

@@ -51,7 +51,7 @@ public abstract class AbstractCacheAccess<K, V>
 
     /**
      * Constructor for the CacheAccess object.
-     * <p>
+     *
      * @param cacheControl The cache which the created instance accesses
      */
     protected AbstractCacheAccess( final CompositeCache<K, V> cacheControl )
@@ -61,7 +61,7 @@ protected AbstractCacheAccess( final CompositeCache<K, V> cacheControl )
 
     /**
      * Removes all of the elements from a region.
-     * <p>
+     *
      * @throws CacheException
      */
     @Override
@@ -94,7 +94,7 @@ public void dispose()
      * This instructs the memory cache to remove the <em>numberToFree</em> according to its eviction
      * policy. For example, the LRUMemoryCache will remove the <em>numberToFree</em> least recently
      * used items. These will be spooled to disk if a disk auxiliary is available.
-     * <p>
+     *
      * @param numberToFree
      * @return the number that were removed. if you ask to free 5, but there are only 3, you will
      *         get 3.
@@ -119,7 +119,7 @@ public int freeMemoryElements( final int numberToFree )
 
     /**
      * Gets the ICompositeCacheAttributes of the cache region.
-     * <p>
+     *
      * @return ICompositeCacheAttributes, the controllers config info, defined in the top section of
      *         a region definition.
      */
@@ -139,7 +139,7 @@ public CompositeCache<K, V> getCacheControl() {
      * <p>
      * Each time an element is added to the cache without element attributes, the default element
      * attributes are cloned.
-     * <p>
+     *
      * @return the default element attributes used by this region.
      * @throws CacheException
      */
@@ -154,7 +154,7 @@ public IElementAttributes getDefaultElementAttributes()
      * This returns the ICacheStats object with information on this region and its auxiliaries.
      * <p>
      * This data can be formatted as needed.
-     * <p>
+     *
      * @return ICacheStats
      */
     @Override
@@ -174,7 +174,7 @@ public String getStats()
 
     /**
      * Sets the ICompositeCacheAttributes of the cache region.
-     * <p>
+     *
      * @param cattr The new ICompositeCacheAttribute value
      */
     @Override
@@ -189,7 +189,7 @@ public void setCacheAttributes( final ICompositeCacheAttributes cattr )
      * remote items. Rather than have unpredictable behavior, this method just sets the default
      * attributes. Items subsequently put into the cache will use these defaults if they do not
      * specify specific attributes.
-     * <p>
+     *
      * @param attr the default attributes.
      * @throws CacheException if something goes wrong.
      */

commons-jcs3-core/src/main/java/org/apache/commons/jcs3/access/CacheAccess.java

@@ -54,7 +54,7 @@ public class CacheAccess<K, V>
 {
     /**
      * Constructor for the CacheAccess object.
-     * <p>
+     *
      * @param cacheControl The cache which the created instance accesses
      */
     public CacheAccess( final CompositeCache<K, V> cacheControl )
@@ -64,7 +64,7 @@ public CacheAccess( final CompositeCache<K, V> cacheControl )
 
     /**
      * Retrieve an object from the cache region this instance provides access to.
-     * <p>
+     *
      * @param name Key the object is stored as
      * @return The object if found or null
      */
@@ -80,7 +80,7 @@ public V get( final K name )
      * Retrieve an object from the cache region this instance provides access to.
      * If the object cannot be found in the cache, it will be retrieved by
      * calling the supplier and subsequently storing it in the cache.
-     * <p>
+     *
      * @param name
      * @param supplier supplier to be called if the value is not found
      * @return Object.
@@ -110,7 +110,7 @@ public V get(final K name, final Supplier<V> supplier)
      * has been in the cache.
      * <p>
      * The last access time in the ElementAttributes should be current.
-     * <p>
+     *
      * @param name Key the Serializable is stored as
      * @return The ICacheElement&lt;K, V&gt; if the object is found or null
      */
@@ -133,7 +133,7 @@ public ICacheElement<K, V> getCacheElement( final K name )
      * has been in the cache.
      * <p>
      * The last access time in the ElementAttributes should be current.
-     * <p>
+     *
      * @param names set of Serializable cache keys
      * @return a map of K key to ICacheElement&lt;K, V&gt; element, or empty map if none of the keys are present
      */
@@ -147,7 +147,7 @@ public Map<K, ICacheElement<K, V>> getCacheElements( final Set<K> names )
      * GetElementAttributes will return an attribute object describing the current attributes
      * associated with the object name. The name object must override the Object.equals and
      * Object.hashCode methods.
-     * <p>
+     *
      * @param name Key of object to get attributes for
      * @return Attributes for the object, null if object not in cache
      */
@@ -170,7 +170,7 @@ public IElementAttributes getElementAttributes( final K name ) throws CacheExcep
 
     /**
      * Retrieve matching objects from the cache region this instance provides access to.
-     * <p>
+     *
      * @param pattern   a key pattern for the objects stored
      * @return A map of key to values.  These are stripped from the wrapper.
      */
@@ -211,7 +211,7 @@ public Map<K, V> getMatching( final String pattern )
      * has been in the cache.
      * <p>
      * The last access time in the ElementAttributes should be current.
-     * <p>
+     *
      * @param pattern key search pattern
      * @return a map of K key to ICacheElement&lt;K, V&gt; element, or empty map if no keys match the pattern
      */
@@ -240,7 +240,7 @@ public void put( final K name, final V obj )
      * Constructs a cache element with these attributes, and puts it into the cache.
      * <p>
      * If the key or the value is null, and InvalidArgumentException is thrown.
-     * <p>
+     *
      * @see org.apache.commons.jcs3.access.behavior.ICacheAccess#put(Object, Object, IElementAttributes)
      */
     @Override
@@ -277,7 +277,7 @@ public void put( final K key, final V val, final IElementAttributes attr )
      * Place a new object in the cache, associated with key name. If there is currently an object
      * associated with name in the region an ObjectExistsException is thrown. Names are scoped to a
      * region so they must be unique within the region they are placed.
-     * <p>
+     *
      * @param key Key object will be stored with
      * @param value Object to store
      * @throws CacheException and ObjectExistsException is thrown if the item is already in the
@@ -296,7 +296,7 @@ public void putSafe( final K key, final V value )
 
     /**
      * Removes a single item by name.
-     * <p>
+     *
      * @param name the name of the item to remove.
      */
     @Override
@@ -308,7 +308,7 @@ public void remove( final K name )
     /**
      * Reset attributes for a particular element in the cache. NOTE: this method is currently not
      * implemented.
-     * <p>
+     *
      * @param name Key of object to reset attributes for
      * @param attr New attributes for the object
      * @throws InvalidHandleException if the item does not exist.

commons-jcs3-core/src/main/java/org/apache/commons/jcs3/access/GroupCacheAccess.java

@@ -42,7 +42,7 @@ public class GroupCacheAccess<K, V>
 {
     /**
      * Constructor for the GroupCacheAccess object
-     * <p>
+     *
      * @param cacheControl
      */
     public GroupCacheAccess( final CompositeCache<GroupAttrName<K>, V> cacheControl )
@@ -52,7 +52,7 @@ public GroupCacheAccess( final CompositeCache<GroupAttrName<K>, V> cacheControl
 
     /**
      * Gets an item out of the cache that is in a specified group.
-     * <p>
+     *
      * @param name
      *            The key name.
      * @param group
@@ -68,7 +68,7 @@ public V getFromGroup( final K name, final String group )
 
     /**
      * Internal method used for group functionality.
-     * <p>
+     *
      * @param group
      * @param name
      * @return GroupAttrName
@@ -81,7 +81,7 @@ private GroupAttrName<K> getGroupAttrName( final String group, final K name )
 
     /**
      * Gets the set of keys of objects currently in the group.
-     * <p>
+     *
      * @param group
      * @return A Set of keys.
      */
@@ -99,7 +99,7 @@ public Set<K> getGroupKeys( final String group )
 
     /**
      * Gets the set of group names in the cache
-     * <p>
+     *
      * @return A Set of group names.
      */
     public Set<String> getGroupNames()
@@ -112,7 +112,7 @@ public Set<String> getGroupNames()
 
     /**
      * Invalidates a group: remove all the group members
-     * <p>
+     *
      * @param group
      *            The name of the group to invalidate
      */
@@ -126,7 +126,7 @@ public void invalidateGroup( final String group )
      * Allows the user to put an object into a group within a particular cache
      * region. This method sets the object's attributes to the default for the
      * region.
-     * <p>
+     *
      * @param name
      *            The key name.
      * @param groupName
@@ -146,7 +146,7 @@ public void putInGroup( final K name, final String groupName, final V value )
      * Allows the user to put an object into a group within a particular cache
      * region. This method allows the object's attributes to be individually
      * specified.
-     * <p>
+     *
      * @param name
      *            The key name.
      * @param groupName