No need for blank Javadoc lines between Javadoc @ tags

Author: garydgregory

src/main/java/org/apache/commons/beanutils/BasicDynaBean.java

@@ -111,7 +111,6 @@ public boolean contains(final String name, final String key) {
      *
      * @param name Name of the property whose value is to be retrieved
      * @return The property's value
-     *
      * @throws IllegalArgumentException if there is no property
      *  of the specified name
      */
@@ -165,7 +164,6 @@ public Object get(final String name) {
      * @param name Name of the property whose value is to be retrieved
      * @param index Index of the value to be retrieved
      * @return The indexed property's value
-     *
      * @throws IllegalArgumentException if there is no property
      *  of the specified name
      * @throws IllegalArgumentException if the specified property
@@ -202,7 +200,6 @@ public Object get(final String name, final int index) {
      * @param name Name of the property whose value is to be retrieved
      * @param key Key of the value to be retrieved
      * @return The mapped property's value
-     *
      * @throws IllegalArgumentException if there is no property
      *  of the specified name
      * @throws IllegalArgumentException if the specified property
@@ -244,7 +241,6 @@ public DynaClass getDynaClass() {
      *
      * @param name Name of the property for which to retrieve the descriptor
      * @return The property descriptor
-     *
      * @throws IllegalArgumentException if this is not a valid property
      *  name for our DynaClass
      */
@@ -314,7 +310,6 @@ protected boolean isAssignable(final Class<?> dest, final Class<?> source) {
      * @param name Name of the property for which a value is to
      *  be removed
      * @param key Key of the value to be removed
-     *
      * @throws IllegalArgumentException if there is no property
      *  of the specified name
      */
@@ -341,7 +336,6 @@ public void remove(final String name, final String key) {
      * @param name Name of the property whose value is to be set
      * @param index Index of the property to be set
      * @param value Value to which this property is to be set
-     *
      * @throws ConversionException if the specified value cannot be
      *  converted to the type required for this property
      * @throws IllegalArgumentException if there is no property
@@ -387,7 +381,6 @@ public void set(final String name, final int index, final Object value) {
      *
      * @param name Name of the property whose value is to be set
      * @param value Value to which this property is to be set
-     *
      * @throws ConversionException if the specified value cannot be
      *  converted to the type required for this property
      * @throws IllegalArgumentException if there is no property
@@ -422,7 +415,6 @@ public void set(final String name, final Object value) {
      * @param name Name of the property whose value is to be set
      * @param key Key of the property to be set
      * @param value Value to which this property is to be set
-     *
      * @throws ConversionException if the specified value cannot be
      *  converted to the type required for this property
      * @throws IllegalArgumentException if there is no property

src/main/java/org/apache/commons/beanutils/BasicDynaClass.java

@@ -182,7 +182,6 @@ public DynaProperty[] getDynaProperties() {
      * @param name Name of the dynamic property for which a descriptor
      *  is requested
      * @return The descriptor for the specified property
-     *
      * @throws IllegalArgumentException if no property name is specified
      */
     @Override
@@ -253,7 +252,6 @@ public DynaBean newInstance()
      * implement the <code>DynaBean</code> interface.
      *
      * @param dynaBeanClass The new Class object
-     *
      * @throws IllegalArgumentException if the specified Class does not
      *  implement the <code>DynaBean</code> interface
      */

src/main/java/org/apache/commons/beanutils/BeanUtils.java

@@ -61,7 +61,6 @@ public class BeanUtils {
      *
      * @param bean Bean to be cloned
      * @return the cloned bean
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InstantiationException if a new instance of the bean's
@@ -88,7 +87,6 @@ public static Object cloneBean(final Object bean)
      *
      * @param dest Destination bean whose properties are modified
      * @param orig Origin bean whose properties are retrieved
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws IllegalArgumentException if the <code>dest</code> or
@@ -116,7 +114,6 @@ public static void copyProperties(final Object dest, final Object orig)
      * @param bean Bean on which setting is to be performed
      * @param name Property name (can be nested/indexed/mapped/combo)
      * @param value Value to be set
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method
@@ -150,7 +147,6 @@ public static <K, V> Map<K, V> createCache() {
      *
      * @param bean Bean whose properties are to be extracted
      * @return Map of property descriptors
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method
@@ -176,7 +172,6 @@ public static Map<String, String> describe(final Object bean)
      * @param bean Bean whose property is to be extracted
      * @param name Name of the property to be extracted
      * @return The array property value
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method
@@ -230,7 +225,6 @@ public static int getDebug() {
      * @param name <code>propertyname[index]</code> of the property value
      *  to be extracted
      * @return The indexed property's value, converted to a String
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method
@@ -259,7 +253,6 @@ public static String getIndexedProperty(final Object bean, final String name)
      * @param name Simple property name of the property value to be extracted
      * @param index Index of the property value to be extracted
      * @return The indexed property's value, converted to a String
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method
@@ -288,7 +281,6 @@ public static String getIndexedProperty(final Object bean,
      * @param name <code>propertyname(index)</code> of the property value
      *  to be extracted
      * @return The mapped property's value, converted to a String
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method
@@ -316,7 +308,6 @@ public static String getMappedProperty(final Object bean, final String name)
      * @param name Simple property name of the property value to be extracted
      * @param key Lookup key of the property value to be extracted
      * @return The mapped property's value, converted to a String
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method
@@ -344,7 +335,6 @@ public static String getMappedProperty(final Object bean,
      * @param bean Bean whose property is to be extracted
      * @param name Possibly nested name of the property to be extracted
      * @return The nested property's value, converted to a String
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws IllegalArgumentException if a nested reference to a
@@ -374,7 +364,6 @@ public static String getNestedProperty(final Object bean, final String name)
      * @param name Possibly indexed and/or nested name of the property
      *  to be extracted
      * @return The property's value, converted to a String
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method
@@ -401,7 +390,6 @@ public static String getProperty(final Object bean, final String name)
      * @param bean Bean whose property is to be extracted
      * @param name Name of the property to be extracted
      * @return The property's value, converted to a String
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method
@@ -490,7 +478,6 @@ public static void setDebug(final int newDebug) {
      * @param bean Bean on which setting is to be performed
      * @param name Property name (can be nested/indexed/mapped/combo)
      * @param value Value to be set
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method

src/main/java/org/apache/commons/beanutils/BeanUtilsBean.java

@@ -160,7 +160,6 @@ public BeanUtilsBean(
      *
      * @param bean Bean to be cloned
      * @return the cloned bean
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InstantiationException if a new instance of the bean's
@@ -196,7 +195,6 @@ public Object cloneBean(final Object bean)
      * @param value Value to be converted (may be null)
      * @param type Class of the value to be converted to
      * @return The converted value
-     *
      * @throws ConversionException if thrown by an underlying Converter
      * @since 1.8.0
      */
@@ -256,7 +254,6 @@ private Object convertForCopy(final Object value, final Class<?> type) {
      *
      * @param dest Destination bean whose properties are modified
      * @param orig Origin bean whose properties are retrieved
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws IllegalArgumentException if the <code>dest</code> or
@@ -356,7 +353,6 @@ public void copyProperties(final Object dest, final Object orig)
      * @param bean Bean on which setting is to be performed
      * @param name Property name (can be nested/indexed/mapped/combo)
      * @param value Value to be set
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method
@@ -511,7 +507,6 @@ public void copyProperty(final Object bean, String name, Object value)
      * </p>
      * @param bean Bean whose properties are to be extracted
      * @return Map of property descriptors
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method
@@ -563,7 +558,6 @@ public Map<String, String> describe(final Object bean)
      * @param bean Bean whose property is to be extracted
      * @param name Name of the property to be extracted
      * @return The array property value
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method
@@ -633,7 +627,6 @@ public ConvertUtilsBean getConvertUtils() {
      * @param name <code>propertyname[index]</code> of the property value
      *  to be extracted
      * @return The indexed property's value, converted to a String
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method
@@ -660,7 +653,6 @@ public String getIndexedProperty(final Object bean, final String name)
      * @param name Simple property name of the property value to be extracted
      * @param index Index of the property value to be extracted
      * @return The indexed property's value, converted to a String
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method
@@ -690,7 +682,6 @@ public String getIndexedProperty(final Object bean,
      * @param name <code>propertyname(index)</code> of the property value
      *  to be extracted
      * @return The mapped property's value, converted to a String
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method
@@ -717,7 +708,6 @@ public String getMappedProperty(final Object bean, final String name)
      * @param name Simple property name of the property value to be extracted
      * @param key Lookup key of the property value to be extracted
      * @return The mapped property's value, converted to a String
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method
@@ -742,7 +732,6 @@ public String getMappedProperty(final Object bean,
      * @param bean Bean whose property is to be extracted
      * @param name Possibly nested name of the property to be extracted
      * @return The nested property's value, converted to a String
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws IllegalArgumentException if a nested reference to a
@@ -769,7 +758,6 @@ public String getNestedProperty(final Object bean, final String name)
      * @param name Possibly indexed and/or nested name of the property
      *  to be extracted
      * @return The property's value, converted to a String
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method
@@ -801,7 +789,6 @@ public PropertyUtilsBean getPropertyUtils() {
      * @param bean Bean whose property is to be extracted
      * @param name Name of the property to be extracted
      * @return The property's value, converted to a String
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method
@@ -920,7 +907,6 @@ public void populate(final Object bean, final Map<String, ? extends Object> prop
      * @param bean Bean on which setting is to be performed
      * @param name Property name (can be nested/indexed/mapped/combo)
      * @param value Value to be set
-     *
      * @throws IllegalAccessException if the caller does not have
      *  access to the property accessor method
      * @throws InvocationTargetException if the property accessor method

src/main/java/org/apache/commons/beanutils/ConstructorUtils.java

@@ -217,12 +217,10 @@ private static <T> Constructor<T> getMatchingAccessibleConstructor(
      * @param klass the class to be constructed.
      * @param arg the actual argument. May be null (this will result in calling the default constructor).
      * @return new instance of <code>klazz</code>
-     *
      * @throws NoSuchMethodException If the constructor cannot be found
      * @throws IllegalAccessException If an error occurs accessing the constructor
      * @throws InvocationTargetException If an error occurs invoking the constructor
      * @throws InstantiationException If an error occurs instantiating the class
-     *
      * @see #invokeConstructor(java.lang.Class, java.lang.Object[], java.lang.Class[])
      */
     public static <T> T invokeConstructor(final Class<T> klass, final Object arg)
@@ -247,12 +245,10 @@ public static <T> T invokeConstructor(final Class<T> klass, final Object arg)
      * @param klass the class to be constructed.
      * @param args actual argument array. May be null (this will result in calling the default constructor).
      * @return new instance of <code>klazz</code>
-     *
      * @throws NoSuchMethodException If the constructor cannot be found
      * @throws IllegalAccessException If an error occurs accessing the constructor
      * @throws InvocationTargetException If an error occurs invoking the constructor
      * @throws InstantiationException If an error occurs instantiating the class
-     *
      * @see #invokeConstructor(java.lang.Class, java.lang.Object[], java.lang.Class[])
      */
     public static <T> T invokeConstructor(final Class<T> klass, Object[] args)
@@ -284,7 +280,6 @@ public static <T> T invokeConstructor(final Class<T> klass, Object[] args)
      * @param args actual argument array. May be null (this will result in calling the default constructor).
      * @param parameterTypes parameter types array
      * @return new instance of <code>klazz</code>
-     *
      * @throws NoSuchMethodException if matching constructor cannot be found
      * @throws IllegalAccessException thrown on the constructor's invocation
      * @throws InvocationTargetException thrown on the constructor's invocation
@@ -328,12 +323,10 @@ public static <T> T invokeConstructor(
      * @param klass the class to be constructed.
      * @param arg the actual argument. May be null (this will result in calling the default constructor).
      * @return new instance of <code>klazz</code>
-     *
      * @throws NoSuchMethodException If the constructor cannot be found
      * @throws IllegalAccessException If an error occurs accessing the constructor
      * @throws InvocationTargetException If an error occurs invoking the constructor
      * @throws InstantiationException If an error occurs instantiating the class
-     *
      * @see #invokeExactConstructor(java.lang.Class, java.lang.Object[], java.lang.Class[])
      */
     public static <T> T invokeExactConstructor(final Class<T> klass, final Object arg)
@@ -358,12 +351,10 @@ public static <T> T invokeExactConstructor(final Class<T> klass, final Object ar
      * @param klass the class to be constructed.
      * @param args actual argument array. May be null (this will result in calling the default constructor).
      * @return new instance of <code>klazz</code>
-     *
      * @throws NoSuchMethodException If the constructor cannot be found
      * @throws IllegalAccessException If an error occurs accessing the constructor
      * @throws InvocationTargetException If an error occurs invoking the constructor
      * @throws InstantiationException If an error occurs instantiating the class
-     *
      * @see #invokeExactConstructor(java.lang.Class, java.lang.Object[], java.lang.Class[])
      */
     public static <T> T invokeExactConstructor(final Class<T> klass, Object[] args)
@@ -396,7 +387,6 @@ public static <T> T invokeExactConstructor(final Class<T> klass, Object[] args)
      * @param args actual argument array. May be null (this will result in calling the default constructor).
      * @param parameterTypes parameter types array
      * @return new instance of <code>klazz</code>
-     *
      * @throws NoSuchMethodException if matching constructor cannot be found
      * @throws IllegalAccessException thrown on the constructor's invocation
      * @throws InvocationTargetException thrown on the constructor's invocation