This is an automated email from the ASF dual-hosted git repository.
garydgregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-configuration.git
The following commit(s) were added to refs/heads/master by this push:
new ef5797e81 Javadoc
ef5797e81 is described below
commit ef5797e81c927bfcd10a7110373c5811434b5089
Author: Gary Gregory <[email protected]>
AuthorDate: Tue Jun 30 13:57:16 2026 +0000
Javadoc
---
.../commons/configuration2/AbstractConfiguration.java | 6 +++---
.../AbstractHierarchicalConfiguration.java | 4 ++--
.../commons/configuration2/ConfigurationConsumer.java | 2 +-
.../commons/configuration2/DatabaseConfiguration.java | 2 +-
.../apache/commons/configuration2/FindNodeVisitor.java | 2 +-
.../configuration2/HierarchicalConfiguration.java | 2 +-
.../HierarchicalConfigurationXMLReader.java | 2 +-
.../commons/configuration2/ImmutableConfiguration.java | 12 ++++++------
.../configuration2/beanutils/DefaultBeanFactory.java | 2 +-
.../configuration2/beanutils/XMLBeanDeclaration.java | 12 ++++++------
.../configuration2/builder/BasicBuilderParameters.java | 2 +-
.../configuration2/builder/BasicBuilderProperties.java | 2 +-
.../builder/BasicConfigurationBuilder.java | 8 ++++----
.../builder/BuilderConfigurationWrapperFactory.java | 4 ++--
.../configuration2/builder/ConfigurationBuilder.java | 2 +-
.../builder/DatabaseBuilderProperties.java | 2 +-
.../configuration2/builder/DefaultParametersHandler.java | 2 +-
.../configuration2/builder/DefaultParametersManager.java | 4 ++--
.../configuration2/builder/EventListenerParameters.java | 4 ++--
.../builder/FileBasedBuilderProperties.java | 2 +-
.../builder/FileBasedConfigurationBuilder.java | 2 +-
.../builder/HierarchicalBuilderProperties.java | 2 +-
.../configuration2/builder/INIBuilderProperties.java | 2 +-
.../configuration2/builder/JndiBuilderProperties.java | 2 +-
.../builder/PropertiesBuilderProperties.java | 2 +-
.../builder/ReloadingFileBasedConfigurationBuilder.java | 2 +-
.../configuration2/builder/XMLBuilderProperties.java | 2 +-
.../builder/combined/CombinedBuilderProperties.java | 6 +++---
.../builder/combined/MultiFileBuilderProperties.java | 2 +-
.../builder/combined/MultiFileConfigurationBuilder.java | 2 +-
.../combined/ReloadingMultiFileConfigurationBuilder.java | 2 +-
.../configuration2/builder/fluent/Configurations.java | 16 ++++++++--------
.../configuration2/builder/fluent/Parameters.java | 6 +++---
.../configuration2/convert/ConversionHandler.java | 4 ++--
.../configuration2/convert/DefaultConversionHandler.java | 6 +++---
.../commons/configuration2/event/BaseEventSource.java | 8 ++++----
.../commons/configuration2/event/EventListener.java | 2 +-
.../commons/configuration2/event/EventListenerList.java | 16 ++++++++--------
.../event/EventListenerRegistrationData.java | 2 +-
.../apache/commons/configuration2/event/EventSource.java | 4 ++--
.../apache/commons/configuration2/event/EventType.java | 2 +-
.../spring/ConfigurationPropertiesFactoryBean.java | 2 +-
.../configuration2/tree/ConfigurationNodeVisitor.java | 2 +-
.../tree/ConfigurationNodeVisitorAdapter.java | 2 +-
.../configuration2/tree/DefaultExpressionEngine.java | 12 ++++++------
.../commons/configuration2/tree/ExpressionEngine.java | 8 ++++----
.../commons/configuration2/tree/ModelTransaction.java | 16 ++++++++--------
.../apache/commons/configuration2/tree/NodeAddData.java | 2 +-
.../apache/commons/configuration2/tree/NodeHandler.java | 6 +++---
.../configuration2/tree/NodeHandlerDecorator.java | 2 +-
.../commons/configuration2/tree/NodeKeyResolver.java | 2 +-
.../apache/commons/configuration2/tree/NodeMatcher.java | 4 ++--
.../apache/commons/configuration2/tree/NodeModel.java | 2 +-
.../commons/configuration2/tree/NodeModelSupport.java | 2 +-
.../commons/configuration2/tree/NodeTreeWalker.java | 10 +++++-----
.../commons/configuration2/tree/NodeUpdateData.java | 8 ++++----
.../apache/commons/configuration2/tree/QueryResult.java | 6 +++---
.../tree/xpath/AbstractConfigurationNodeIterator.java | 2 +-
.../tree/xpath/ConfigurationAttributePointer.java | 2 +-
.../tree/xpath/ConfigurationNodeIteratorAttribute.java | 2 +-
.../tree/xpath/ConfigurationNodeIteratorChildren.java | 2 +-
.../tree/xpath/ConfigurationNodePointer.java | 2 +-
.../tree/xpath/ConfigurationNodePointerFactory.java | 4 ++--
.../configuration2/tree/xpath/XPathContextFactory.java | 2 +-
.../configuration2/tree/xpath/XPathExpressionEngine.java | 8 ++++----
.../configuration2/DatabaseConfigurationTestHelper.java | 6 +++---
.../configuration2/builder/BuilderEventListenerImpl.java | 2 +-
.../event/AbstractEventListenerTestImpl.java | 2 +-
68 files changed, 145 insertions(+), 145 deletions(-)
diff --git
a/src/main/java/org/apache/commons/configuration2/AbstractConfiguration.java
b/src/main/java/org/apache/commons/configuration2/AbstractConfiguration.java
index 847e89d4d..467980863 100644
--- a/src/main/java/org/apache/commons/configuration2/AbstractConfiguration.java
+++ b/src/main/java/org/apache/commons/configuration2/AbstractConfiguration.java
@@ -118,7 +118,7 @@ public abstract class AbstractConfiguration extends
BaseEventSource implements C
* Checks whether the specified value is <strong>null</strong> and throws
an exception in this case. This method is used by
* conversion methods returning primitive Java types. Here values to be
returned must not be <strong>null</strong>.
*
- * @param <T> the type of the object to be checked.
+ * @param <T> The type of the object to be checked.
* @param key the key which caused the problem.
* @param value the value to be checked.
* @return the passed in value for chaining this method call.
@@ -471,7 +471,7 @@ public abstract class AbstractConfiguration extends
BaseEventSource implements C
/**
* Helper method for obtaining a property value with a type conversion.
*
- * @param <T> the target type of the conversion.
+ * @param <T> The target type of the conversion.
* @param cls the target class.
* @param key the key of the desired property.
* @param defValue a default value.
@@ -611,7 +611,7 @@ public abstract class AbstractConfiguration extends
BaseEventSource implements C
/**
* Obtains the property value for the specified key and converts it to the
given target class.
*
- * @param <T> the target type of the conversion.
+ * @param <T> The target type of the conversion.
* @param cls the target class.
* @param key the key of the desired property.
* @param defaultValue a default value.
diff --git
a/src/main/java/org/apache/commons/configuration2/AbstractHierarchicalConfiguration.java
b/src/main/java/org/apache/commons/configuration2/AbstractHierarchicalConfiguration.java
index 683a67abc..a3cb17a25 100644
---
a/src/main/java/org/apache/commons/configuration2/AbstractHierarchicalConfiguration.java
+++
b/src/main/java/org/apache/commons/configuration2/AbstractHierarchicalConfiguration.java
@@ -148,7 +148,7 @@ import org.apache.commons.configuration2.tree.QueryResult;
* undesired effects. For concrete subclasses dealing with specific node
structures, this situation may be different.
* </p>
*
- * @param <T> the type of the nodes managed by this hierarchical configuration
+ * @param <T> The type of the nodes managed by this hierarchical configuration
* @since 2.0
*/
public abstract class AbstractHierarchicalConfiguration<T> extends
AbstractConfiguration
@@ -230,7 +230,7 @@ public abstract class AbstractHierarchicalConfiguration<T>
extends AbstractConfi
* A specialized visitor that checks if a node is defined.
"Defined" in this terms means that the node or at
* least one of its sub nodes is associated with a value.
*
- * @param <T> the type of the nodes managed by this hierarchical
configuration
+ * @param <T> The type of the nodes managed by this hierarchical
configuration
*/
private static final class DefinedVisitor<T> extends
ConfigurationNodeVisitorAdapter<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/ConfigurationConsumer.java
b/src/main/java/org/apache/commons/configuration2/ConfigurationConsumer.java
index ef120c9fd..9da091f8c 100644
--- a/src/main/java/org/apache/commons/configuration2/ConfigurationConsumer.java
+++ b/src/main/java/org/apache/commons/configuration2/ConfigurationConsumer.java
@@ -22,7 +22,7 @@ import
org.apache.commons.configuration2.ex.ConfigurationException;
/**
* A Configuration task that may throw a ConfigurationException.
*
- * @param <T> the type of the input to the operation.
+ * @param <T> The type of the input to the operation.
* @since 2.6
*/
@FunctionalInterface
diff --git
a/src/main/java/org/apache/commons/configuration2/DatabaseConfiguration.java
b/src/main/java/org/apache/commons/configuration2/DatabaseConfiguration.java
index cc1151b49..878b669cb 100644
--- a/src/main/java/org/apache/commons/configuration2/DatabaseConfiguration.java
+++ b/src/main/java/org/apache/commons/configuration2/DatabaseConfiguration.java
@@ -122,7 +122,7 @@ public class DatabaseConfiguration extends
AbstractConfiguration {
* framework for creating and executing a JDBC statement. It especially
takes care of proper handling of JDBC resources
* even in case of an error.
*
- * @param <T> the type of the results produced by a JDBC operation
+ * @param <T> The type of the results produced by a JDBC operation
*/
private abstract class AbstractJdbcOperation<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/FindNodeVisitor.java
b/src/main/java/org/apache/commons/configuration2/FindNodeVisitor.java
index ea9e422f9..42fc90d60 100644
--- a/src/main/java/org/apache/commons/configuration2/FindNodeVisitor.java
+++ b/src/main/java/org/apache/commons/configuration2/FindNodeVisitor.java
@@ -24,7 +24,7 @@ import org.apache.commons.configuration2.tree.NodeHandler;
* A specialized {@code NodeVisitor} implementation which searches for a
specific node in a hierarchy.
* </p>
*
- * @param <T> the type of the nodes to be visited
+ * @param <T> The type of the nodes to be visited
*/
final class FindNodeVisitor<T> extends ConfigurationNodeVisitorAdapter<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/HierarchicalConfiguration.java
b/src/main/java/org/apache/commons/configuration2/HierarchicalConfiguration.java
index 92fff4ebe..74f129cd9 100644
---
a/src/main/java/org/apache/commons/configuration2/HierarchicalConfiguration.java
+++
b/src/main/java/org/apache/commons/configuration2/HierarchicalConfiguration.java
@@ -36,7 +36,7 @@ import
org.apache.commons.configuration2.tree.NodeModelSupport;
* structures.
* </p>
*
- * @param <T> the type of the nodes used by this hierarchical configuration
+ * @param <T> The type of the nodes used by this hierarchical configuration
* @since 2.0
*/
public interface HierarchicalConfiguration<T> extends Configuration,
ImmutableHierarchicalConfiguration, NodeModelSupport<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/HierarchicalConfigurationXMLReader.java
b/src/main/java/org/apache/commons/configuration2/HierarchicalConfigurationXMLReader.java
index a61068667..9e0e88157 100644
---
a/src/main/java/org/apache/commons/configuration2/HierarchicalConfigurationXMLReader.java
+++
b/src/main/java/org/apache/commons/configuration2/HierarchicalConfigurationXMLReader.java
@@ -38,7 +38,7 @@ import org.xml.sax.helpers.AttributesImpl;
* methods ignore their argument.
* </p>
*
- * @param <T> the type of the nodes supported by this reader
+ * @param <T> The type of the nodes supported by this reader
*/
public class HierarchicalConfigurationXMLReader<T> extends
ConfigurationXMLReader {
diff --git
a/src/main/java/org/apache/commons/configuration2/ImmutableConfiguration.java
b/src/main/java/org/apache/commons/configuration2/ImmutableConfiguration.java
index fb4ab41f9..d4b23ba59 100644
---
a/src/main/java/org/apache/commons/configuration2/ImmutableConfiguration.java
+++
b/src/main/java/org/apache/commons/configuration2/ImmutableConfiguration.java
@@ -139,7 +139,7 @@ public interface ImmutableConfiguration {
* existing object, the method returns null unless {@link
AbstractConfiguration#isThrowExceptionOnMissing()} is set to
* {@code true}.
*
- * @param <T> the target type of the value
+ * @param <T> The target type of the value
* @param cls the target class of the value
* @param key the key of the value
* @return the value of the requested type for the key
@@ -155,7 +155,7 @@ public interface ImmutableConfiguration {
* Gets an object of the specified type associated with the given
configuration key using a default value. If the key
* doesn't map to an existing object, the default value is returned.
*
- * @param <T> the target type of the value
+ * @param <T> The target type of the value
* @param cls the target class of the value
* @param key the key of the value
* @param defaultValue the default value
@@ -306,7 +306,7 @@ public interface ImmutableConfiguration {
* Gets a collection of typed objects associated with the given
configuration key. This method works like
* {@link #getCollection(Class, String, Collection, Collection)} passing
in <strong>null</strong> as default value.
*
- * @param <T> the element type of the result list
+ * @param <T> The element type of the result list
* @param cls the element class of the result list
* @param key the configuration key
* @param target the target collection (may be <strong>null</strong>)
@@ -331,7 +331,7 @@ public interface ImmutableConfiguration {
* the default collection), return value is the target collection created
by this method.</li>
* </ul>
*
- * @param <T> the element type of the result list
+ * @param <T> The element type of the result list
* @param cls the element class of the result list
* @param key the configuration key
* @param target the target collection (may be <strong>null</strong>)
@@ -615,7 +615,7 @@ public interface ImmutableConfiguration {
* Gets a list of typed objects associated with the given configuration
key returning a null if the key doesn't map to
* an existing object.
*
- * @param <T> the type expected for the elements of the list
+ * @param <T> The type expected for the elements of the list
* @param cls the class expected for the elements of the list
* @param key The configuration key.
* @return The associated list if the key is found.
@@ -633,7 +633,7 @@ public interface ImmutableConfiguration {
* concrete subclasses), all values are extracted and added to the
resulting list - performing a type conversion if
* necessary.
*
- * @param <T> the type expected for the elements of the list
+ * @param <T> The type expected for the elements of the list
* @param cls the class expected for the elements of the list
* @param key the configuration key.
* @param defaultValue the default value.
diff --git
a/src/main/java/org/apache/commons/configuration2/beanutils/DefaultBeanFactory.java
b/src/main/java/org/apache/commons/configuration2/beanutils/DefaultBeanFactory.java
index 2e6d3a90e..5557f4a83 100644
---
a/src/main/java/org/apache/commons/configuration2/beanutils/DefaultBeanFactory.java
+++
b/src/main/java/org/apache/commons/configuration2/beanutils/DefaultBeanFactory.java
@@ -92,7 +92,7 @@ public class DefaultBeanFactory implements BeanFactory {
*
* @param beanClass the class of the bean to be created
* @param data the current {@code BeanDeclaration}
- * @param <T> the type of the bean to be created
+ * @param <T> The type of the bean to be created
* @return the single matching constructor
* @throws ConfigurationRuntimeException if no single matching constructor
can be found
* @throws NullPointerException if the bean class or bean declaration are
<strong>null</strong>
diff --git
a/src/main/java/org/apache/commons/configuration2/beanutils/XMLBeanDeclaration.java
b/src/main/java/org/apache/commons/configuration2/beanutils/XMLBeanDeclaration.java
index 48f0f66c5..4b066f76d 100644
---
a/src/main/java/org/apache/commons/configuration2/beanutils/XMLBeanDeclaration.java
+++
b/src/main/java/org/apache/commons/configuration2/beanutils/XMLBeanDeclaration.java
@@ -104,7 +104,7 @@ public class XMLBeanDeclaration implements BeanDeclaration {
/**
* An internal helper class which wraps the node with the bean declaration
and the corresponding node handler.
*
- * @param <T> the type of the node
+ * @param <T> The type of the node
*/
static class NodeData<T> {
@@ -241,7 +241,7 @@ public class XMLBeanDeclaration implements BeanDeclaration {
* Creates a {@code NodeData} object from the root node of the given
configuration.
*
* @param config the configuration
- * @param <T> the type of the nodes
+ * @param <T> The type of the nodes
* @return the {@code NodeData} object
*/
private static <T> NodeData<T> createNodeDataFromConfiguration(final
HierarchicalConfiguration<T> config) {
@@ -287,7 +287,7 @@ public class XMLBeanDeclaration implements BeanDeclaration {
* configuration's root node must contain the bean declaration.
*
* @param config the configuration with the bean declaration
- * @param <T> the node type of the configuration
+ * @param <T> The node type of the configuration
*/
public <T> XMLBeanDeclaration(final HierarchicalConfiguration<T> config) {
this(config, (String) null);
@@ -300,7 +300,7 @@ public class XMLBeanDeclaration implements BeanDeclaration {
* @param config the configuration (must not be <strong>null</strong>)
* @param key the key to the bean declaration (this key must point to
exactly one bean declaration or a
* {@code IllegalArgumentException} exception will be thrown)
- * @param <T> the node type of the configuration
+ * @param <T> The node type of the configuration
* @throws IllegalArgumentException if required information is missing to
construct the bean declaration
*/
public <T> XMLBeanDeclaration(final HierarchicalConfiguration<T> config,
final String key) {
@@ -315,7 +315,7 @@ public class XMLBeanDeclaration implements BeanDeclaration {
* @param key the key to the bean declaration
* @param optional a flag whether this declaration is optional; if set to
<strong>true</strong>, no exception will be thrown if
* the passed in key is undefined
- * @param <T> the node type of the configuration
+ * @param <T> The node type of the configuration
* @throws IllegalArgumentException if required information is missing to
construct the bean declaration
*/
public <T> XMLBeanDeclaration(final HierarchicalConfiguration<T> config,
final String key, final boolean optional) {
@@ -336,7 +336,7 @@ public class XMLBeanDeclaration implements BeanDeclaration {
* @param optional a flag whether this declaration is optional; if set to
<strong>true</strong>, no exception will be thrown if
* the passed in key is undefined
* @param defBeanClsName a default bean class name
- * @param <T> the node type of the configuration
+ * @param <T> The node type of the configuration
* @throws IllegalArgumentException if required information is missing to
construct the bean declaration
* @since 2.0
*/
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/BasicBuilderParameters.java
b/src/main/java/org/apache/commons/configuration2/builder/BasicBuilderParameters.java
index 1f46f8932..b7f3c146d 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/BasicBuilderParameters.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/BasicBuilderParameters.java
@@ -203,7 +203,7 @@ public class BasicBuilderParameters implements Cloneable,
BuilderParameters, Bas
* @param params the map with parameters
* @param key the key of the parameter
* @param expClass the expected class of the parameter value
- * @param <T> the parameter type
+ * @param <T> The parameter type
* @return the value of the parameter in the correct data type
* @throws IllegalArgumentException if the parameter is not of the
expected type
*/
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/BasicBuilderProperties.java
b/src/main/java/org/apache/commons/configuration2/builder/BasicBuilderProperties.java
index c414bf1eb..91d92d1be 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/BasicBuilderProperties.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/BasicBuilderProperties.java
@@ -42,7 +42,7 @@ import org.apache.commons.configuration2.sync.Synchronizer;
* available properties and may be extended even in minor releases.
* </p>
*
- * @param <T> the type of the result of all set methods for method chaining
+ * @param <T> The type of the result of all set methods for method chaining
* @since 2.0
*/
public interface BasicBuilderProperties<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/BasicConfigurationBuilder.java
b/src/main/java/org/apache/commons/configuration2/builder/BasicConfigurationBuilder.java
index 0cae96dc9..5848a3ace 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/BasicConfigurationBuilder.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/BasicConfigurationBuilder.java
@@ -85,7 +85,7 @@ import
org.apache.commons.configuration2.reloading.ReloadingController;
* {@code ImmutableConfiguration} instance is returned until the builder is
reset.
* </p>
*
- * @param <T> the concrete type of {@code ImmutableConfiguration} objects
created by this builder
+ * @param <T> The concrete type of {@code ImmutableConfiguration} objects
created by this builder
* @since 2.0
*/
public class BasicConfigurationBuilder<T extends ImmutableConfiguration>
implements ConfigurationBuilder<T> {
@@ -95,7 +95,7 @@ public class BasicConfigurationBuilder<T extends
ImmutableConfiguration> impleme
*
* @param evSrc the event source
* @param regData the registration data object
- * @param <E> the type of the event listener
+ * @param <E> The type of the event listener
*/
private static <E extends Event> void registerListener(final EventSource
evSrc, final EventListenerRegistrationData<E> regData) {
evSrc.addEventListener(regData.getEventType(), regData.getListener());
@@ -106,7 +106,7 @@ public class BasicConfigurationBuilder<T extends
ImmutableConfiguration> impleme
*
* @param evSrc the event source
* @param regData the registration data object
- * @param <E> the type of the event listener
+ * @param <E> The type of the event listener
*/
private static <E extends Event> void removeListener(final EventSource
evSrc, final EventListenerRegistrationData<E> regData) {
evSrc.removeEventListener(regData.getEventType(),
regData.getListener());
@@ -520,7 +520,7 @@ public class BasicConfigurationBuilder<T extends
ImmutableConfiguration> impleme
*
* @param eventType the event type object
* @param listener the listener to be registered
- * @param <E> the event type
+ * @param <E> The event type
*/
protected final <E extends Event> void installEventListener(final
EventType<E> eventType, final EventListener<? super E> listener) {
fetchEventSource().addEventListener(eventType, listener);
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/BuilderConfigurationWrapperFactory.java
b/src/main/java/org/apache/commons/configuration2/builder/BuilderConfigurationWrapperFactory.java
index 3aa36a7d6..69d607af9 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/BuilderConfigurationWrapperFactory.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/BuilderConfigurationWrapperFactory.java
@@ -155,7 +155,7 @@ public class BuilderConfigurationWrapperFactory {
* builder. This is a convenience method which allows creating wrapper
configurations without having to instantiate this
* class.
*
- * @param <T> the type of the configuration objects returned by this method
+ * @param <T> The type of the configuration objects returned by this method
* @param ifcClass the class of the configuration objects returned by this
method; this must be an interface class and
* must not be <strong>null</strong>
* @param builder the wrapped {@code ConfigurationBuilder} (must not be
<strong>null</strong>)
@@ -216,7 +216,7 @@ public class BuilderConfigurationWrapperFactory {
* implementation delegates to
* {@link #createBuilderConfigurationWrapper(Class, ConfigurationBuilder,
EventSourceSupport)}.
*
- * @param <T> the type of the configuration objects returned by this method
+ * @param <T> The type of the configuration objects returned by this method
* @param ifcClass the class of the configuration objects returned by this
method; this must be an interface class and
* must not be <strong>null</strong>
* @param builder the wrapped {@code ConfigurationBuilder} (must not be
<strong>null</strong>)
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/ConfigurationBuilder.java
b/src/main/java/org/apache/commons/configuration2/builder/ConfigurationBuilder.java
index ba9ff1e7f..455deec77 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/ConfigurationBuilder.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/ConfigurationBuilder.java
@@ -36,7 +36,7 @@ import
org.apache.commons.configuration2.ex.ConfigurationException;
* configurations can be created.
* </p>
*
- * @param <T> the concrete type of the {@code ImmutableConfiguration} class
produced by this builder
+ * @param <T> The concrete type of the {@code ImmutableConfiguration} class
produced by this builder
* @since 2.0
*/
public interface ConfigurationBuilder<T extends ImmutableConfiguration>
extends EventSource {
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/DatabaseBuilderProperties.java
b/src/main/java/org/apache/commons/configuration2/builder/DatabaseBuilderProperties.java
index 732e729ca..eb59e0eb7 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/DatabaseBuilderProperties.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/DatabaseBuilderProperties.java
@@ -32,7 +32,7 @@ import javax.sql.DataSource;
* available properties and may be extended even in minor releases.
* </p>
*
- * @param <T> the type of the result of all set methods for method chaining
+ * @param <T> The type of the result of all set methods for method chaining
* @since 2.0
*/
public interface DatabaseBuilderProperties<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/DefaultParametersHandler.java
b/src/main/java/org/apache/commons/configuration2/builder/DefaultParametersHandler.java
index 5a8155238..d0cae4947 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/DefaultParametersHandler.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/DefaultParametersHandler.java
@@ -28,7 +28,7 @@ package org.apache.commons.configuration2.builder;
* initialization.
* </p>
*
- * @param <T> the type of parameters supported by this handler
+ * @param <T> The type of parameters supported by this handler
* @since 2.0
*/
public interface DefaultParametersHandler<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/DefaultParametersManager.java
b/src/main/java/org/apache/commons/configuration2/builder/DefaultParametersManager.java
index bc2f74d7e..27924cc5a 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/DefaultParametersManager.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/DefaultParametersManager.java
@@ -130,7 +130,7 @@ public class DefaultParametersManager {
* there are multiple handlers registered supporting a specific parameters
class, they are invoked in the order in which
* they were registered. So handlers registered later may override the
values set by handlers registered earlier.
*
- * @param <T> the type of the parameters supported by this handler
+ * @param <T> The type of the parameters supported by this handler
* @param paramsClass the parameters class supported by this handler (must
not be <strong>null</strong>)
* @param handler the {@code DefaultParametersHandler} to be registered
(must not be <strong>null</strong>)
* @throws IllegalArgumentException if a required parameter is missing
@@ -161,7 +161,7 @@ public class DefaultParametersManager {
* then the parameter class supported by the handler is used (which is the
default behavior of the
* {@link #registerDefaultsHandler(Class, DefaultParametersHandler)}
method).
*
- * @param <T> the type of the parameters supported by this handler
+ * @param <T> The type of the parameters supported by this handler
* @param paramsClass the parameters class supported by this handler (must
not be <strong>null</strong>)
* @param handler the {@code DefaultParametersHandler} to be registered
(must not be <strong>null</strong>)
* @param startClass an optional start class in the hierarchy of parameter
objects for which this handler should be
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/EventListenerParameters.java
b/src/main/java/org/apache/commons/configuration2/builder/EventListenerParameters.java
index 37fef3ed8..705df1e6f 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/EventListenerParameters.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/EventListenerParameters.java
@@ -68,7 +68,7 @@ public class EventListenerParameters implements
BuilderParameters, EventListener
* Adds the specified {@code EventListenerRegistrationData} instance to
this object.
*
* @param registrationData the registration object to be added
- * @param <T> the event type of the contained event listener
+ * @param <T> The event type of the contained event listener
* @return a reference to this object for method chaining
*/
public <T extends Event> EventListenerParameters addEventListener(final
EventListenerRegistrationData<T> registrationData) {
@@ -81,7 +81,7 @@ public class EventListenerParameters implements
BuilderParameters, EventListener
*
* @param eventType the event type object
* @param listener the event listener
- * @param <T> the event type
+ * @param <T> The event type
* @return a reference to this object for method chaining
*/
public <T extends Event> EventListenerParameters addEventListener(final
EventType<T> eventType, final EventListener<? super T> listener) {
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/FileBasedBuilderProperties.java
b/src/main/java/org/apache/commons/configuration2/builder/FileBasedBuilderProperties.java
index 43d80b79c..fcc012cf6 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/FileBasedBuilderProperties.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/FileBasedBuilderProperties.java
@@ -31,7 +31,7 @@ import
org.apache.commons.configuration2.io.URLConnectionOptions;
* This interface defines a set of properties which can be used to specify the
location of a configuration source.
* </p>
*
- * @param <T> the type of the result of all set methods for method chaining
+ * @param <T> The type of the result of all set methods for method chaining
*/
public interface FileBasedBuilderProperties<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/FileBasedConfigurationBuilder.java
b/src/main/java/org/apache/commons/configuration2/builder/FileBasedConfigurationBuilder.java
index 59207aaec..e1e6b7c9c 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/FileBasedConfigurationBuilder.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/FileBasedConfigurationBuilder.java
@@ -47,7 +47,7 @@ import org.apache.commons.lang3.StringUtils;
* location is reset, too.
* </p>
*
- * @param <T> the concrete type of {@code Configuration} objects created by
this builder
+ * @param <T> The concrete type of {@code Configuration} objects created by
this builder
* @since 2.0
*/
public class FileBasedConfigurationBuilder<T extends FileBasedConfiguration>
extends BasicConfigurationBuilder<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/HierarchicalBuilderProperties.java
b/src/main/java/org/apache/commons/configuration2/builder/HierarchicalBuilderProperties.java
index af1f91bf0..d9bd2945d 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/HierarchicalBuilderProperties.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/HierarchicalBuilderProperties.java
@@ -30,7 +30,7 @@ import
org.apache.commons.configuration2.tree.ExpressionEngine;
* available properties and may be extended even in minor releases.
* </p>
*
- * @param <T> the type of the result of all set methods for method chaining
+ * @param <T> The type of the result of all set methods for method chaining
* @since 2.0
*/
public interface HierarchicalBuilderProperties<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/INIBuilderProperties.java
b/src/main/java/org/apache/commons/configuration2/builder/INIBuilderProperties.java
index e2866e1e7..2893a4e32 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/INIBuilderProperties.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/INIBuilderProperties.java
@@ -28,7 +28,7 @@ package org.apache.commons.configuration2.builder;
* available properties and may be extended even in minor releases.
* </p>
*
- * @param <T> the type of the result of all set methods for method chaining
+ * @param <T> The type of the result of all set methods for method chaining
* @since 2.2
*/
public interface INIBuilderProperties<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/JndiBuilderProperties.java
b/src/main/java/org/apache/commons/configuration2/builder/JndiBuilderProperties.java
index 71f006b59..bc63aa1e8 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/JndiBuilderProperties.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/JndiBuilderProperties.java
@@ -30,7 +30,7 @@ import javax.naming.Context;
* available properties and may be extended even in minor releases.
* </p>
*
- * @param <T> the type of the result of all set methods for method chaining
+ * @param <T> The type of the result of all set methods for method chaining
* @since 2.0
*/
public interface JndiBuilderProperties<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/PropertiesBuilderProperties.java
b/src/main/java/org/apache/commons/configuration2/builder/PropertiesBuilderProperties.java
index 91acef262..abe32c08c 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/PropertiesBuilderProperties.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/PropertiesBuilderProperties.java
@@ -34,7 +34,7 @@ import
org.apache.commons.configuration2.ex.ConfigurationException;
* available properties and may be extended even in minor releases.
* </p>
*
- * @param <T> the type of the result of all set methods for method chaining
+ * @param <T> The type of the result of all set methods for method chaining
* @since 2.0
*/
public interface PropertiesBuilderProperties<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/ReloadingFileBasedConfigurationBuilder.java
b/src/main/java/org/apache/commons/configuration2/builder/ReloadingFileBasedConfigurationBuilder.java
index 769305020..af094bcc0 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/ReloadingFileBasedConfigurationBuilder.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/ReloadingFileBasedConfigurationBuilder.java
@@ -48,7 +48,7 @@ import
org.apache.commons.configuration2.reloading.ReloadingDetector;
* by an external component, for example a timer.
* </p>
*
- * @param <T> the concrete type of {@code Configuration} objects created by
this builder
+ * @param <T> The concrete type of {@code Configuration} objects created by
this builder
* @since 2.0
*/
public class ReloadingFileBasedConfigurationBuilder<T extends
FileBasedConfiguration> extends FileBasedConfigurationBuilder<T>
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/XMLBuilderProperties.java
b/src/main/java/org/apache/commons/configuration2/builder/XMLBuilderProperties.java
index 0fbdd582f..8daf76690 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/XMLBuilderProperties.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/XMLBuilderProperties.java
@@ -32,7 +32,7 @@ import org.xml.sax.EntityResolver;
* available properties and may be extended even in minor releases.
* </p>
*
- * @param <T> the type of the result of all set methods for method chaining
+ * @param <T> The type of the result of all set methods for method chaining
* @since 2.0
*/
public interface XMLBuilderProperties<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/combined/CombinedBuilderProperties.java
b/src/main/java/org/apache/commons/configuration2/builder/combined/CombinedBuilderProperties.java
index 3acec1f4a..a662f2000 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/combined/CombinedBuilderProperties.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/combined/CombinedBuilderProperties.java
@@ -35,7 +35,7 @@ import
org.apache.commons.configuration2.builder.DefaultParametersManager;
* available properties and may be extended even in minor releases.
* </p>
*
- * @param <T> the return type of all methods for allowing method chaining
+ * @param <T> The return type of all methods for allowing method chaining
* @since 2.0
*/
public interface CombinedBuilderProperties<T> {
@@ -46,7 +46,7 @@ public interface CombinedBuilderProperties<T> {
* by invoking all matching {@code DefaultParametersHandler}s on them. So,
basically the same mechanism is used for the
* initialization of parameters for child configuration sources as for
normal parameter objects.
*
- * @param <D> the type of the handler to be registered
+ * @param <D> The type of the handler to be registered
* @param paramClass the parameter class supported by the handler
* @param handler the {@code DefaultParametersHandler} to be registered
* @return a reference to this object for method chaining
@@ -59,7 +59,7 @@ public interface CombinedBuilderProperties<T> {
* method works like the overloaded variant, but limits the application of
the defaults handler to specific child
* configuration sources.
*
- * @param <D> the type of the handler to be registered
+ * @param <D> The type of the handler to be registered
* @param paramClass the parameter class supported by the handler
* @param handler the {@code DefaultParametersHandler} to be registered
* @param startClass an optional start class in the hierarchy of parameter
objects for which this handler should be
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/combined/MultiFileBuilderProperties.java
b/src/main/java/org/apache/commons/configuration2/builder/combined/MultiFileBuilderProperties.java
index 1e70406dc..29c63415d 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/combined/MultiFileBuilderProperties.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/combined/MultiFileBuilderProperties.java
@@ -31,7 +31,7 @@ import
org.apache.commons.configuration2.builder.BuilderParameters;
* available properties and may be extended even in minor releases.
* </p>
*
- * @param <T> the return type of all methods for allowing method chaining
+ * @param <T> The return type of all methods for allowing method chaining
* @since 2.0
*/
public interface MultiFileBuilderProperties<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/combined/MultiFileConfigurationBuilder.java
b/src/main/java/org/apache/commons/configuration2/builder/combined/MultiFileConfigurationBuilder.java
index 355657f93..ab6911bdb 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/combined/MultiFileConfigurationBuilder.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/combined/MultiFileConfigurationBuilder.java
@@ -66,7 +66,7 @@ import org.apache.commons.lang3.concurrent.ConcurrentUtils;
* builders for managed configurations.
* </p>
*
- * @param <T> the concrete type of {@code Configuration} objects created by
this builder
+ * @param <T> The concrete type of {@code Configuration} objects created by
this builder
* @since 2.0
*/
public class MultiFileConfigurationBuilder<T extends FileBasedConfiguration>
extends BasicConfigurationBuilder<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/combined/ReloadingMultiFileConfigurationBuilder.java
b/src/main/java/org/apache/commons/configuration2/builder/combined/ReloadingMultiFileConfigurationBuilder.java
index b19d04db5..22e22f54c 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/combined/ReloadingMultiFileConfigurationBuilder.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/combined/ReloadingMultiFileConfigurationBuilder.java
@@ -52,7 +52,7 @@ import
org.apache.commons.configuration2.reloading.ReloadingControllerSupport;
* configuration, but occur for each of the managed configuration.
* </p>
*
- * @param <T> the concrete type of {@code Configuration} objects created by
this builder
+ * @param <T> The concrete type of {@code Configuration} objects created by
this builder
* @since 2.0
*/
public class ReloadingMultiFileConfigurationBuilder<T extends
FileBasedConfiguration> extends MultiFileConfigurationBuilder<T>
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/fluent/Configurations.java
b/src/main/java/org/apache/commons/configuration2/builder/fluent/Configurations.java
index 674a02a78..3ab97d007 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/fluent/Configurations.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/fluent/Configurations.java
@@ -165,7 +165,7 @@ public class Configurations {
* Creates a configured builder for a file-based configuration of the
specified type.
*
* @param configClass the configuration class
- * @param <T> the type of the configuration to be constructed
+ * @param <T> The type of the configuration to be constructed
* @return the newly created builder
* @since 2.6
*/
@@ -178,7 +178,7 @@ public class Configurations {
*
* @param configClass the configuration class
* @param params the parameters object for configuring the builder
- * @param <T> the type of the configuration to be constructed
+ * @param <T> The type of the configuration to be constructed
* @return the newly created builder
*/
private <T extends FileBasedConfiguration>
FileBasedConfigurationBuilder<T> createFileBasedBuilder(final Class<T>
configClass,
@@ -193,7 +193,7 @@ public class Configurations {
*
* @param configClass the configuration class
* @param file the file to be loaded
- * @param <T> the type of the configuration to be constructed
+ * @param <T> The type of the configuration to be constructed
* @return a {@code FileBasedConfiguration} object initialized from this
file
* @throws ConfigurationException if an error occurred when loading the
configuration
*/
@@ -208,7 +208,7 @@ public class Configurations {
*
* @param configClass the configuration class
* @param path the path to the file to be loaded
- * @param <T> the type of the configuration to be constructed
+ * @param <T> The type of the configuration to be constructed
* @return a {@code FileBasedConfiguration} object initialized from this
file
* @throws ConfigurationException if an error occurred when loading the
configuration
*/
@@ -223,7 +223,7 @@ public class Configurations {
*
* @param configClass the configuration class
* @param url the URL to be loaded
- * @param <T> the type of the configuration to be constructed
+ * @param <T> The type of the configuration to be constructed
* @return a {@code FileBasedConfiguration} object initialized from this
file
* @throws ConfigurationException if an error occurred when loading the
configuration
*/
@@ -237,7 +237,7 @@ public class Configurations {
*
* @param configClass the configuration class
* @param file the file to be loaded
- * @param <T> the type of the configuration to be constructed
+ * @param <T> The type of the configuration to be constructed
* @return the new {@code FileBasedConfigurationBuilder}
*/
public <T extends FileBasedConfiguration> FileBasedConfigurationBuilder<T>
fileBasedBuilder(final Class<T> configClass, final File file) {
@@ -250,7 +250,7 @@ public class Configurations {
*
* @param configClass the configuration class
* @param path the path to the file to be loaded
- * @param <T> the type of the configuration to be constructed
+ * @param <T> The type of the configuration to be constructed
* @return the new {@code FileBasedConfigurationBuilder}
*/
public <T extends FileBasedConfiguration> FileBasedConfigurationBuilder<T>
fileBasedBuilder(final Class<T> configClass, final String path) {
@@ -263,7 +263,7 @@ public class Configurations {
*
* @param configClass the configuration class
* @param url the URL to be loaded
- * @param <T> the type of the configuration to be constructed
+ * @param <T> The type of the configuration to be constructed
* @return the new {@code FileBasedConfigurationBuilder}
*/
public <T extends FileBasedConfiguration> FileBasedConfigurationBuilder<T>
fileBasedBuilder(final Class<T> configClass, final URL url) {
diff --git
a/src/main/java/org/apache/commons/configuration2/builder/fluent/Parameters.java
b/src/main/java/org/apache/commons/configuration2/builder/fluent/Parameters.java
index eba3952f7..c0f60cd8b 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/fluent/Parameters.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/fluent/Parameters.java
@@ -161,7 +161,7 @@ public final class Parameters {
* Creates a proxy object for a given parameters interface based on the
given implementation object. The newly created
* object is initialized with default values if there are matching {@link
DefaultParametersHandler} objects.
*
- * @param <T> the type of the parameters interface
+ * @param <T> The type of the parameters interface
* @param target the implementing target object
* @param ifcClass the interface class
* @param superIfcs an array with additional interface classes to be
implemented
@@ -253,7 +253,7 @@ public final class Parameters {
* Registers the specified {@code DefaultParametersHandler} object for the
given parameters class. This is a convenience
* method which just delegates to the associated {@code
DefaultParametersManager}.
*
- * @param <T> the type of the parameters supported by this handler
+ * @param <T> The type of the parameters supported by this handler
* @param paramsClass the parameters class supported by this handler (must
not be <strong>null</strong>)
* @param handler the {@code DefaultParametersHandler} to be registered
(must not be <strong>null</strong>)
* @throws IllegalArgumentException if a required parameter is missing
@@ -268,7 +268,7 @@ public final class Parameters {
* inheritance hierarchy. This is a convenience method which just
delegates to the associated
* {@code DefaultParametersManager}.
*
- * @param <T> the type of the parameters supported by this handler
+ * @param <T> The type of the parameters supported by this handler
* @param paramsClass the parameters class supported by this handler (must
not be <strong>null</strong>)
* @param handler the {@code DefaultParametersHandler} to be registered
(must not be <strong>null</strong>)
* @param startClass an optional start class in the hierarchy of parameter
objects for which this handler should be
diff --git
a/src/main/java/org/apache/commons/configuration2/convert/ConversionHandler.java
b/src/main/java/org/apache/commons/configuration2/convert/ConversionHandler.java
index ce6002bd1..e647b721e 100644
---
a/src/main/java/org/apache/commons/configuration2/convert/ConversionHandler.java
+++
b/src/main/java/org/apache/commons/configuration2/convert/ConversionHandler.java
@@ -54,7 +54,7 @@ public interface ConversionHandler {
* is not possible, a {@link ConversionException} is thrown. It is up to a
concrete implementation how <strong>null</strong>
* values are handled; a default strategy would be to return
<strong>null</strong> if the source object is <strong>null</strong>.
*
- * @param <T> the type of the desired result
+ * @param <T> The type of the desired result
* @param src the object to be converted
* @param targetCls the target class of the conversion
* @param ci an object for performing variable substitution
@@ -86,7 +86,7 @@ public interface ConversionHandler {
* added to the destination collection. If the conversion of an element is
not possible, a {@link ConversionException}
* is thrown.
*
- * @param <T> the type of the elements of the destination collection
+ * @param <T> The type of the elements of the destination collection
* @param src the object to be converted
* @param elemClass the element class of the destination collection
* @param ci an object for performing variable substitution
diff --git
a/src/main/java/org/apache/commons/configuration2/convert/DefaultConversionHandler.java
b/src/main/java/org/apache/commons/configuration2/convert/DefaultConversionHandler.java
index d774bad4c..76198cdf4 100644
---
a/src/main/java/org/apache/commons/configuration2/convert/DefaultConversionHandler.java
+++
b/src/main/java/org/apache/commons/configuration2/convert/DefaultConversionHandler.java
@@ -102,7 +102,7 @@ public class DefaultConversionHandler implements
ConversionHandler {
* value. Eventually, {@link #convertValue(Object, Class,
ConfigurationInterpolator)} is called with the single value to
* be converted.
*
- * @param <T> the desired target type of the conversion
+ * @param <T> The desired target type of the conversion
* @param src the source object to be converted
* @param targetCls the desired target class
* @param ci the {@code ConfigurationInterpolator} (not
<strong>null</strong>)
@@ -117,7 +117,7 @@ public class DefaultConversionHandler implements
ConversionHandler {
/**
* Helper method for converting all values of a source object and storing
them in a collection.
*
- * @param <T> the target type of the conversion
+ * @param <T> The target type of the conversion
* @param src the source object
* @param elemClass the target class of the conversion
* @param ci the {@code ConfigurationInterpolator}
@@ -133,7 +133,7 @@ public class DefaultConversionHandler implements
ConversionHandler {
* be a single value, but it can be <strong>null</strong>. Derived classes
that want to extend the available conversions, but are
* happy with the handling of complex objects, just need to override this
method.
*
- * @param <T> the desired target type of the conversion
+ * @param <T> The desired target type of the conversion
* @param src the source object (a single value)
* @param targetCls the target class of the conversion
* @param ci the {@code ConfigurationInterpolator} (not
<strong>null</strong>)
diff --git
a/src/main/java/org/apache/commons/configuration2/event/BaseEventSource.java
b/src/main/java/org/apache/commons/configuration2/event/BaseEventSource.java
index b9623933c..1d4d1f787 100644
--- a/src/main/java/org/apache/commons/configuration2/event/BaseEventSource.java
+++ b/src/main/java/org/apache/commons/configuration2/event/BaseEventSource.java
@@ -160,7 +160,7 @@ public class BaseEventSource implements EventSource {
* @param propName the name of the affected property (can be
<strong>null</strong>)
* @param propValue the value of the affected property (can be
<strong>null</strong>)
* @param before the before update flag
- * @param <T> the type of the event to be created
+ * @param <T> The type of the event to be created
* @return the newly created event object
*/
protected <T extends ConfigurationEvent> ConfigurationEvent
createEvent(final EventType<T> type, final String propName, final Object
propValue,
@@ -176,7 +176,7 @@ public class BaseEventSource implements EventSource {
* @param propertyName the name of the affected property (can be
<strong>null</strong>)
* @param propertyValue the value of the affected property (can be
<strong>null</strong>)
* @param cause the {@code Throwable} object that caused this error event
- * @param <T> the event type
+ * @param <T> The event type
*/
public <T extends ConfigurationErrorEvent> void fireError(final
EventType<T> eventType, final EventType<?> operationType, final String
propertyName,
final Object propertyValue, final Throwable cause) {
@@ -197,7 +197,7 @@ public class BaseEventSource implements EventSource {
* @param propName the name of the affected property (can be
<strong>null</strong>)
* @param propValue the value of the affected property (can be
<strong>null</strong>)
* @param before the before update flag
- * @param <T> the type of the event to be fired
+ * @param <T> The type of the event to be fired
*/
protected <T extends ConfigurationEvent> void fireEvent(final EventType<T>
type, final String propName, final Object propValue, final boolean before) {
if (checkDetailEvents(-1)) {
@@ -226,7 +226,7 @@ public class BaseEventSource implements EventSource {
* object.
*
* @param eventType the event type object
- * @param <T> the event type
+ * @param <T> The event type
* @return a collection with the event listeners of the specified event
type (this collection is a snapshot of the
* currently registered listeners; it cannot be manipulated)
*/
diff --git
a/src/main/java/org/apache/commons/configuration2/event/EventListener.java
b/src/main/java/org/apache/commons/configuration2/event/EventListener.java
index b89618476..77d99f2e4 100644
--- a/src/main/java/org/apache/commons/configuration2/event/EventListener.java
+++ b/src/main/java/org/apache/commons/configuration2/event/EventListener.java
@@ -27,7 +27,7 @@ package org.apache.commons.configuration2.event;
* Java 8 ({@code EventListener} is a functional interface and thus can be
represented by a Lambda expression).
* </p>
*
- * @param <T> the type of events this listener can process
+ * @param <T> The type of events this listener can process
* @since 2.0
*/
public interface EventListener<T extends Event> {
diff --git
a/src/main/java/org/apache/commons/configuration2/event/EventListenerList.java
b/src/main/java/org/apache/commons/configuration2/event/EventListenerList.java
index 7aacf8054..e2a3f35d9 100644
---
a/src/main/java/org/apache/commons/configuration2/event/EventListenerList.java
+++
b/src/main/java/org/apache/commons/configuration2/event/EventListenerList.java
@@ -55,7 +55,7 @@ public class EventListenerList {
* returns only listeners compatible with a specified event type. It has a
convenience method for invoking the current
* listener in the iteration with an event.
*
- * @param <T> the event type
+ * @param <T> The event type
*/
public static final class EventListenerIterator<T extends Event>
implements Iterator<EventListener<? super T>> {
@@ -207,7 +207,7 @@ public class EventListenerList {
* registration method; the event type and the listener are passed as a
single data object.
*
* @param regData the registration data object (must not be
<strong>null</strong>)
- * @param <T> the type of events processed by this listener
+ * @param <T> The type of events processed by this listener
* @throws IllegalArgumentException if the registration data object is
<strong>null</strong>
*/
public <T extends Event> void addEventListener(final
EventListenerRegistrationData<T> regData) {
@@ -223,7 +223,7 @@ public class EventListenerList {
*
* @param type the event type (must not be <strong>null</strong>)
* @param listener the listener to be registered (must not be
<strong>null</strong>)
- * @param <T> the type of events processed by this listener
+ * @param <T> The type of events processed by this listener
* @throws IllegalArgumentException if a required parameter is
<strong>null</strong>
*/
public <T extends Event> void addEventListener(final EventType<T> type,
final EventListener<? super T> listener) {
@@ -258,7 +258,7 @@ public class EventListenerList {
* specified event type.
*
* @param eventType the event type object
- * @param <T> the event type
+ * @param <T> The event type
* @return an {@code Iterator} with the selected event listeners
*/
public <T extends Event> EventListenerIterator<T>
getEventListenerIterator(final EventType<T> eventType) {
@@ -270,7 +270,7 @@ public class EventListenerList {
* specified event type.
*
* @param eventType the event type object
- * @param <T> the event type
+ * @param <T> The event type
* @return an {@code Iterable} with the selected event listeners
*/
public <T extends Event> Iterable<EventListener<? super T>>
getEventListeners(final EventType<T> eventType) {
@@ -294,7 +294,7 @@ public class EventListenerList {
* for listeners that extend a given super type.
*
* @param eventType the event type object
- * @param <T> the event type
+ * @param <T> The event type
* @return a list with the matching event listener registration objects
*/
public <T extends Event> List<EventListenerRegistrationData<? extends T>>
getRegistrationsForSuperType(final EventType<T> eventType) {
@@ -320,7 +320,7 @@ public class EventListenerList {
* removing a listener which expects the event type and the listener in a
single data object.
*
* @param regData the registration data object
- * @param <T> the type of events processed by this listener
+ * @param <T> The type of events processed by this listener
* @return a flag whether a listener registration was removed
* @see #removeEventListener(EventType, EventListener)
*/
@@ -336,7 +336,7 @@ public class EventListenerList {
*
* @param eventType the event type
* @param listener the event listener to be removed
- * @param <T> the type of events processed by this listener
+ * @param <T> The type of events processed by this listener
* @return a flag whether a listener registration was removed
*/
public <T extends Event> boolean removeEventListener(final EventType<T>
eventType, final EventListener<? super T> listener) {
diff --git
a/src/main/java/org/apache/commons/configuration2/event/EventListenerRegistrationData.java
b/src/main/java/org/apache/commons/configuration2/event/EventListenerRegistrationData.java
index 24d538258..730e79948 100644
---
a/src/main/java/org/apache/commons/configuration2/event/EventListenerRegistrationData.java
+++
b/src/main/java/org/apache/commons/configuration2/event/EventListenerRegistrationData.java
@@ -30,7 +30,7 @@ package org.apache.commons.configuration2.event;
* components.
* </p>
*
- * @param <T> the type of events processed by the listener
+ * @param <T> The type of events processed by the listener
* @since 2.0
*/
public final class EventListenerRegistrationData<T extends Event> {
diff --git
a/src/main/java/org/apache/commons/configuration2/event/EventSource.java
b/src/main/java/org/apache/commons/configuration2/event/EventSource.java
index 64e09290e..5ca0f91c4 100644
--- a/src/main/java/org/apache/commons/configuration2/event/EventSource.java
+++ b/src/main/java/org/apache/commons/configuration2/event/EventSource.java
@@ -36,7 +36,7 @@ public interface EventSource {
*
* @param eventType the event type (must not be <strong>null</strong>)
* @param listener the listener to be registered (must not be
<strong>null</strong>)
- * @param <T> the type of events processed by this listener
+ * @param <T> The type of events processed by this listener
* @throws IllegalArgumentException if a required parameter is
<strong>null</strong>
*/
<T extends Event> void addEventListener(EventType<T> eventType,
EventListener<? super T> listener);
@@ -49,7 +49,7 @@ public interface EventSource {
*
* @param eventType the event type
* @param listener the event listener to be removed
- * @param <T> the type of events processed by this listener
+ * @param <T> The type of events processed by this listener
* @return a flag whether a listener registration was removed
*/
<T extends Event> boolean removeEventListener(EventType<T> eventType,
EventListener<? super T> listener);
diff --git
a/src/main/java/org/apache/commons/configuration2/event/EventType.java
b/src/main/java/org/apache/commons/configuration2/event/EventType.java
index 340b78bce..3cfb158d7 100644
--- a/src/main/java/org/apache/commons/configuration2/event/EventType.java
+++ b/src/main/java/org/apache/commons/configuration2/event/EventType.java
@@ -36,7 +36,7 @@ import java.util.Set;
* listener interfaces and a natural selection of events to be processed.
* </p>
*
- * @param <T> the event associated with this type
+ * @param <T> The event associated with this type
* @since 2.0
*/
public class EventType<T extends Event> implements Serializable {
diff --git
a/src/main/java/org/apache/commons/configuration2/spring/ConfigurationPropertiesFactoryBean.java
b/src/main/java/org/apache/commons/configuration2/spring/ConfigurationPropertiesFactoryBean.java
index 545535651..9d151fdb8 100644
---
a/src/main/java/org/apache/commons/configuration2/spring/ConfigurationPropertiesFactoryBean.java
+++
b/src/main/java/org/apache/commons/configuration2/spring/ConfigurationPropertiesFactoryBean.java
@@ -50,7 +50,7 @@ public class ConfigurationPropertiesFactoryBean implements
InitializingBean, Fac
* Creates a defensive copy of the specified array. Handles null values
correctly.
*
* @param src the source array
- * @param <T> the type of the array
+ * @param <T> The type of the array
* @return the defensive copy of the array
*/
private static <T> T[] clone(final T[] src) {
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/ConfigurationNodeVisitor.java
b/src/main/java/org/apache/commons/configuration2/tree/ConfigurationNodeVisitor.java
index d900ac128..f6d0ec2cc 100644
---
a/src/main/java/org/apache/commons/configuration2/tree/ConfigurationNodeVisitor.java
+++
b/src/main/java/org/apache/commons/configuration2/tree/ConfigurationNodeVisitor.java
@@ -30,7 +30,7 @@ package org.apache.commons.configuration2.tree;
* traversal process.
* </p>
*
- * @param <T> the type of the nodes processed by this visitor
+ * @param <T> The type of the nodes processed by this visitor
* @since 1.3
*/
public interface ConfigurationNodeVisitor<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/ConfigurationNodeVisitorAdapter.java
b/src/main/java/org/apache/commons/configuration2/tree/ConfigurationNodeVisitorAdapter.java
index 4a6479b53..797d0b0fd 100644
---
a/src/main/java/org/apache/commons/configuration2/tree/ConfigurationNodeVisitorAdapter.java
+++
b/src/main/java/org/apache/commons/configuration2/tree/ConfigurationNodeVisitorAdapter.java
@@ -25,7 +25,7 @@ package org.apache.commons.configuration2.tree;
* Derived classes only need to override the methods they really need.
* </p>
*
- * @param <T> the type of the nodes processed by this visitor
+ * @param <T> The type of the nodes processed by this visitor
*/
public class ConfigurationNodeVisitorAdapter<T> implements
ConfigurationNodeVisitor<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/DefaultExpressionEngine.java
b/src/main/java/org/apache/commons/configuration2/tree/DefaultExpressionEngine.java
index b27919fe9..d385612ca 100644
---
a/src/main/java/org/apache/commons/configuration2/tree/DefaultExpressionEngine.java
+++
b/src/main/java/org/apache/commons/configuration2/tree/DefaultExpressionEngine.java
@@ -173,7 +173,7 @@ public class DefaultExpressionEngine implements
ExpressionEngine {
* @param parent the parent node
* @param nodeName the name of the current node
* @param handler the node handler
- * @param <T> the type of the nodes to be dealt with
+ * @param <T> The type of the nodes to be dealt with
* @return the index of this node
*/
private <T> int determineIndex(final T node, final T parent, final String
nodeName, final NodeHandler<T> handler) {
@@ -187,7 +187,7 @@ public class DefaultExpressionEngine implements
ExpressionEngine {
* @param handler the {@code NodeHandler}
* @param parent the parent node
* @param nodeName the name of the current node
- * @param <T> the type of the nodes to be dealt with
+ * @param <T> The type of the nodes to be dealt with
* @return a list with all matching child nodes
*/
private <T> List<T> findChildNodesByName(final NodeHandler<T> handler,
final T parent, final String nodeName) {
@@ -198,7 +198,7 @@ public class DefaultExpressionEngine implements
ExpressionEngine {
* Finds the last existing node for an add operation. This method
traverses the node tree along the specified key. The
* last existing node on this path is returned.
*
- * @param <T> the type of the nodes to be dealt with
+ * @param <T> The type of the nodes to be dealt with
* @param keyIt the key iterator
* @param node the current node
* @param handler the node handler
@@ -225,7 +225,7 @@ public class DefaultExpressionEngine implements
ExpressionEngine {
* Recursive helper method for evaluating a key. This method processes all
facets of a configuration key, traverses the
* tree of properties and fetches the results of all matching properties.
*
- * @param <T> the type of nodes to be dealt with
+ * @param <T> The type of nodes to be dealt with
* @param keyPart the configuration key iterator
* @param node the current node
* @param results here the found results are stored
@@ -337,7 +337,7 @@ public class DefaultExpressionEngine implements
ExpressionEngine {
* relevant; the branch is new so there cannot be any ambiguities.)
* </p>
*
- * @param <T> the type of the nodes to be dealt with
+ * @param <T> The type of the nodes to be dealt with
* @param root the root node of the nodes hierarchy
* @param key the key of the new property
* @param handler the node handler
@@ -368,7 +368,7 @@ public class DefaultExpressionEngine implements
ExpressionEngine {
* Called by {@code findNodesForKey()} to process the sub nodes of the
current node depending on the type of the current
* key part (children, attributes, or both).
*
- * @param <T> the type of the nodes to be dealt with
+ * @param <T> The type of the nodes to be dealt with
* @param keyPart the key part
* @param subNodes a list with the sub nodes to process
* @param nodes the target collection
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/ExpressionEngine.java
b/src/main/java/org/apache/commons/configuration2/tree/ExpressionEngine.java
index 08c1a0c33..96a2ffa71 100644
--- a/src/main/java/org/apache/commons/configuration2/tree/ExpressionEngine.java
+++ b/src/main/java/org/apache/commons/configuration2/tree/ExpressionEngine.java
@@ -60,7 +60,7 @@ public interface ExpressionEngine {
* implementations, this means that an index is added to the node name to
ensure that there are no ambiguities with
* child nodes having the same names.
*
- * @param <T> the type of the node to be processed
+ * @param <T> The type of the node to be processed
* @param node the node, for which the key must be constructed
* @param parentKey the key of this node's parent (can be
<strong>null</strong> for the root node)
* @param handler the {@code NodeHandler} for accessing the node
@@ -73,7 +73,7 @@ public interface ExpressionEngine {
* called whenever a property key for a node has to be constructed, for
example by the
* {@link org.apache.commons.configuration2.Configuration#getKeys()
getKeys()} method.
*
- * @param <T> the type of the node to be processed
+ * @param <T> The type of the node to be processed
* @param node the node, for which the key must be constructed
* @param parentKey the key of this node's parent (can be
<strong>null</strong> for the root node)
* @param handler the {@code NodeHandler} for accessing the node
@@ -86,7 +86,7 @@ public interface ExpressionEngine {
* configuration. An implementation has to interpret the specified key,
find the parent node for the new elements, and
* provide all information about new nodes to be added.
*
- * @param <T> the type of the node to be processed
+ * @param <T> The type of the node to be processed
* @param root the root node
* @param key the key for the new property
* @param handler the {@code NodeHandler} for accessing the node
@@ -101,7 +101,7 @@ public interface ExpressionEngine {
* throw a (runtime) exception indicating this error condition. The passed
in {@code NodeHandler} can be used to gather
* the required information from the node object.
*
- * @param <T> the type of the node to be processed
+ * @param <T> The type of the node to be processed
* @param root the root node of a hierarchy of nodes
* @param key the key to be evaluated
* @param handler the {@code NodeHandler} for accessing the node
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/ModelTransaction.java
b/src/main/java/org/apache/commons/configuration2/tree/ModelTransaction.java
index 67387c3b2..a30301d77 100644
--- a/src/main/java/org/apache/commons/configuration2/tree/ModelTransaction.java
+++ b/src/main/java/org/apache/commons/configuration2/tree/ModelTransaction.java
@@ -434,7 +434,7 @@ final class ModelTransaction {
*
* @param col the collection
* @param node the element to be added
- * @param <E> the type of elements involved
+ * @param <E> The type of elements involved
* @return the resulting collection
*/
private static <E> Collection<E> append(final Collection<E> col, final E
node) {
@@ -449,8 +449,8 @@ final class ModelTransaction {
* @param map the map
* @param key the key
* @param value the value
- * @param <K> the type of the key
- * @param <V> the type of the value
+ * @param <K> The type of the key
+ * @param <V> The type of the value
* @return the resulting map
*/
private static <K, V> Map<K, V> append(final Map<K, V> map, final K key,
final V value) {
@@ -464,7 +464,7 @@ final class ModelTransaction {
*
* @param col the set
* @param elem the element to be added
- * @param <E> the type of the elements involved
+ * @param <E> The type of the elements involved
* @return the resulting set
*/
private static <E> Set<E> append(final Set<E> col, final E elem) {
@@ -478,7 +478,7 @@ final class ModelTransaction {
*
* @param col1 the first collection
* @param col2 the second collection
- * @param <E> the type of the elements involved
+ * @param <E> The type of the elements involved
* @return the resulting collection
*/
private static <E> Collection<E> concatenate(final Collection<E> col1,
final Collection<? extends E> col2) {
@@ -496,8 +496,8 @@ final class ModelTransaction {
*
* @param map1 the first map
* @param map2 the second map
- * @param <K> the type of the keys
- * @param <V> the type of the values
+ * @param <K> The type of the keys
+ * @param <V> The type of the values
* @return the resulting map
*/
private static <K, V> Map<K, V> concatenate(final Map<K, V> map1, final
Map<? extends K, ? extends V> map2) {
@@ -515,7 +515,7 @@ final class ModelTransaction {
*
* @param set1 the first set
* @param set2 the second set
- * @param <E> the type of the elements involved
+ * @param <E> The type of the elements involved
* @return the resulting set
*/
private static <E> Set<E> concatenate(final Set<E> set1, final Set<?
extends E> set2) {
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/NodeAddData.java
b/src/main/java/org/apache/commons/configuration2/tree/NodeAddData.java
index e51f8c69f..ff9c9b9f7 100644
--- a/src/main/java/org/apache/commons/configuration2/tree/NodeAddData.java
+++ b/src/main/java/org/apache/commons/configuration2/tree/NodeAddData.java
@@ -42,7 +42,7 @@ import java.util.List;
* operation) and the new node</li>
* </ul>
*
- * @param <T> the type of nodes this class can handle
+ * @param <T> The type of nodes this class can handle
* @since 1.3
*/
public class NodeAddData<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/NodeHandler.java
b/src/main/java/org/apache/commons/configuration2/tree/NodeHandler.java
index 06af9356b..277c98dcf 100644
--- a/src/main/java/org/apache/commons/configuration2/tree/NodeHandler.java
+++ b/src/main/java/org/apache/commons/configuration2/tree/NodeHandler.java
@@ -29,7 +29,7 @@ import java.util.Set;
* internal state of a node in a read-only way.
* </p>
*
- * @param <T> the type of the nodes this handler deals with
+ * @param <T> The type of the nodes this handler deals with
*/
public interface NodeHandler<T> {
@@ -97,7 +97,7 @@ public interface NodeHandler<T> {
* @param node the node
* @param matcher the {@code NodeMatcher} defining filter criteria
* @param criterion the criterion to be matched against; this object is
passed to the {@code NodeMatcher}
- * @param <C> the type of the criterion
+ * @param <C> The type of the criterion
* @return a list with all children matched by the matcher
*/
<C> List<T> getMatchingChildren(T node, NodeMatcher<C> matcher, C
criterion);
@@ -110,7 +110,7 @@ public interface NodeHandler<T> {
* @param node the node
* @param matcher the {@code NodeMatcher}
* @param criterion the criterion to be passed to the {@code NodeMatcher}
- * @param <C> the type of the criterion
+ * @param <C> The type of the criterion
* @return the number of matched children
*/
<C> int getMatchingChildrenCount(T node, NodeMatcher<C> matcher, C
criterion);
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/NodeHandlerDecorator.java
b/src/main/java/org/apache/commons/configuration2/tree/NodeHandlerDecorator.java
index 96ed27f8f..5c75c41fc 100644
---
a/src/main/java/org/apache/commons/configuration2/tree/NodeHandlerDecorator.java
+++
b/src/main/java/org/apache/commons/configuration2/tree/NodeHandlerDecorator.java
@@ -29,7 +29,7 @@ import java.util.Set;
* classes have to implement the {@code getDecoratedNodeHandler()} method to
provide the underlying handler.
* </p>
*
- * @param <T> the type of the nodes supported by this handler
+ * @param <T> The type of the nodes supported by this handler
* @since 2.0
*/
public abstract class NodeHandlerDecorator<T> implements NodeHandler<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/NodeKeyResolver.java
b/src/main/java/org/apache/commons/configuration2/tree/NodeKeyResolver.java
index a3ac6cd21..44bf929fe 100644
--- a/src/main/java/org/apache/commons/configuration2/tree/NodeKeyResolver.java
+++ b/src/main/java/org/apache/commons/configuration2/tree/NodeKeyResolver.java
@@ -29,7 +29,7 @@ import java.util.Map;
* processing of complex update operations.
* </p>
*
- * @param <T> the type of the nodes supported by this resolver
+ * @param <T> The type of the nodes supported by this resolver
* @since 2.0
*/
public interface NodeKeyResolver<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/NodeMatcher.java
b/src/main/java/org/apache/commons/configuration2/tree/NodeMatcher.java
index a7b15b100..07fd0f325 100644
--- a/src/main/java/org/apache/commons/configuration2/tree/NodeMatcher.java
+++ b/src/main/java/org/apache/commons/configuration2/tree/NodeMatcher.java
@@ -33,7 +33,7 @@ package org.apache.commons.configuration2.tree;
* between multiple components.
* </p>
*
- * @param <C> the type of the criterion evaluated by this matcher
+ * @param <C> The type of the criterion evaluated by this matcher
* @since 2.0
*/
public interface NodeMatcher<C> {
@@ -44,7 +44,7 @@ public interface NodeMatcher<C> {
* @param node the node to be tested
* @param handler the corresponding {@code NodeHandler}
* @param criterion the criterion to match against
- * @param <T> the type of the node
+ * @param <T> The type of the node
* @return <strong>true</strong> if this node matches the criterion,
<strong>false</strong> otherwise
*/
<T> boolean matches(T node, NodeHandler<T> handler, C criterion);
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/NodeModel.java
b/src/main/java/org/apache/commons/configuration2/tree/NodeModel.java
index c0343279e..fb4eb1868 100644
--- a/src/main/java/org/apache/commons/configuration2/tree/NodeModel.java
+++ b/src/main/java/org/apache/commons/configuration2/tree/NodeModel.java
@@ -35,7 +35,7 @@ import java.util.Collection;
* which knows how to deal with keys.
* </p>
*
- * @param <T> the type of the nodes managed by this model
+ * @param <T> The type of the nodes managed by this model
* @since 2.0
*/
public interface NodeModel<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/NodeModelSupport.java
b/src/main/java/org/apache/commons/configuration2/tree/NodeModelSupport.java
index fbf619aa7..e3fa3c868 100644
--- a/src/main/java/org/apache/commons/configuration2/tree/NodeModelSupport.java
+++ b/src/main/java/org/apache/commons/configuration2/tree/NodeModelSupport.java
@@ -24,7 +24,7 @@ package org.apache.commons.configuration2.tree;
* This interface defines a single method for querying a {@code NodeModel}.
* </p>
*
- * @param <T> the type of the supported {@code NodeModel}
+ * @param <T> The type of the supported {@code NodeModel}
* @since 2.0
*/
public interface NodeModelSupport<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/NodeTreeWalker.java
b/src/main/java/org/apache/commons/configuration2/tree/NodeTreeWalker.java
index a9af06a00..2c7ad0b6e 100644
--- a/src/main/java/org/apache/commons/configuration2/tree/NodeTreeWalker.java
+++ b/src/main/java/org/apache/commons/configuration2/tree/NodeTreeWalker.java
@@ -50,7 +50,7 @@ public class NodeTreeWalker {
* @param root the root node to be navigated
* @param visitor the visitor
* @param handler the handler
- * @param <T> the type of the nodes involved
+ * @param <T> The type of the nodes involved
*/
private static <T> void bfs(final T root, final
ConfigurationNodeVisitor<T> visitor, final NodeHandler<T> handler) {
final List<T> pendingNodes = new LinkedList<>();
@@ -72,7 +72,7 @@ public class NodeTreeWalker {
* @param root the root node
* @param visitor the visitor
* @param handler the handler
- * @param <T> the type of the nodes involved
+ * @param <T> The type of the nodes involved
* @return <strong>true</strong> if a walk operation can be performed,
<strong>false</strong> otherwise
* @throws IllegalArgumentException if a required parameter is missing
*/
@@ -92,7 +92,7 @@ public class NodeTreeWalker {
* @param node the current node
* @param visitor the visitor
* @param handler the handler
- * @param <T> the type of the nodes involved
+ * @param <T> The type of the nodes involved
*/
private static <T> void dfs(final T node, final
ConfigurationNodeVisitor<T> visitor, final NodeHandler<T> handler) {
if (!visitor.terminate()) {
@@ -121,7 +121,7 @@ public class NodeTreeWalker {
* @param root the root node of the hierarchy to be processed (may be
<strong>null</strong>, then this call has no effect)
* @param visitor the {@code ConfigurationNodeVisitor} (must not be
<strong>null</strong>)
* @param handler the {@code NodeHandler} (must not be
<strong>null</strong>)
- * @param <T> the type of the nodes involved
+ * @param <T> The type of the nodes involved
* @throws IllegalArgumentException if a required parameter is
<strong>null</strong>
*/
public <T> void walkBFS(final T root, final ConfigurationNodeVisitor<T>
visitor, final NodeHandler<T> handler) {
@@ -139,7 +139,7 @@ public class NodeTreeWalker {
* @param root the root node of the hierarchy to be processed (may be
<strong>null</strong>, then this call has no effect)
* @param visitor the {@code ConfigurationNodeVisitor} (must not be
<strong>null</strong>)
* @param handler the {@code NodeHandler} (must not be
<strong>null</strong>)
- * @param <T> the type of the nodes involved
+ * @param <T> The type of the nodes involved
* @throws IllegalArgumentException if a required parameter is
<strong>null</strong>
*/
public <T> void walkDFS(final T root, final ConfigurationNodeVisitor<T>
visitor, final NodeHandler<T> handler) {
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/NodeUpdateData.java
b/src/main/java/org/apache/commons/configuration2/tree/NodeUpdateData.java
index 068a18930..abc99ae9c 100644
--- a/src/main/java/org/apache/commons/configuration2/tree/NodeUpdateData.java
+++ b/src/main/java/org/apache/commons/configuration2/tree/NodeUpdateData.java
@@ -36,7 +36,7 @@ import java.util.Map;
* update based on a passed in instance.
* </p>
*
- * @param <T> the type of nodes involved in this update operation
+ * @param <T> The type of nodes involved in this update operation
* @since 2.0
*/
public class NodeUpdateData<T> {
@@ -45,7 +45,7 @@ public class NodeUpdateData<T> {
* Creates an unmodifiable defensive copy of the passed in collection with
may be null.
*
* @param col the collection to be copied
- * @param <T> the element type of the collection
+ * @param <T> The element type of the collection
* @return the unmodifiable copy
*/
private static <T> Collection<T> copyCollection(final Collection<? extends
T> col) {
@@ -59,8 +59,8 @@ public class NodeUpdateData<T> {
* Creates an unmodifiable defensive copy of the passed in map which may
be null.
*
* @param map the map to be copied
- * @param <K> the type of the keys involved
- * @param <V> the type of the values involved
+ * @param <K> The type of the keys involved
+ * @param <V> The type of the values involved
* @return the unmodifiable copy
*/
private static <K, V> Map<K, V> copyMap(final Map<? extends K, ? extends
V> map) {
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/QueryResult.java
b/src/main/java/org/apache/commons/configuration2/tree/QueryResult.java
index 8117951fc..9f63c92be 100644
--- a/src/main/java/org/apache/commons/configuration2/tree/QueryResult.java
+++ b/src/main/java/org/apache/commons/configuration2/tree/QueryResult.java
@@ -34,7 +34,7 @@ import org.apache.commons.lang3.builder.ToStringBuilder;
* Implementation note: Instances are immutable. They are created using the
static factory methods.
* </p>
*
- * @param <T> the type of the result nodes
+ * @param <T> The type of the result nodes
* @since 2.0
*/
public final class QueryResult<T> {
@@ -45,7 +45,7 @@ public final class QueryResult<T> {
*
* @param parentNode the node which owns the attribute
* @param attrName the attribute name
- * @param <T> the type of the parent node
+ * @param <T> The type of the parent node
* @return the newly created instance
*/
public static <T> QueryResult<T> createAttributeResult(final T parentNode,
final String attrName) {
@@ -55,7 +55,7 @@ public final class QueryResult<T> {
/**
* Creates a {@code QueryResult} instance representing the specified
result node.
*
- * @param <T> the type of the result node
+ * @param <T> The type of the result node
* @param resultNode the result node
* @return the newly created instance
*/
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/xpath/AbstractConfigurationNodeIterator.java
b/src/main/java/org/apache/commons/configuration2/tree/xpath/AbstractConfigurationNodeIterator.java
index b04653774..3f5e36eba 100644
---
a/src/main/java/org/apache/commons/configuration2/tree/xpath/AbstractConfigurationNodeIterator.java
+++
b/src/main/java/org/apache/commons/configuration2/tree/xpath/AbstractConfigurationNodeIterator.java
@@ -31,7 +31,7 @@ import org.apache.commons.lang3.StringUtils;
* implement specific behavior based on the concrete node type (child node or
attribute node).
* </p>
*
- * @param <T> the type of the nodes this iterator deals with
+ * @param <T> The type of the nodes this iterator deals with
* @since 1.3
*/
abstract class AbstractConfigurationNodeIterator<T> implements NodeIterator {
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationAttributePointer.java
b/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationAttributePointer.java
index adcc5a1b5..6b855e2aa 100644
---
a/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationAttributePointer.java
+++
b/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationAttributePointer.java
@@ -29,7 +29,7 @@ import org.apache.commons.jxpath.ri.model.NodePointer;
* A specialized {@code NodePointer} implementation for the attributes of a
configuration node.
* </p>
*
- * @param <T> the type of the nodes this pointer deals with
+ * @param <T> The type of the nodes this pointer deals with
* @since 2.0
*/
final class ConfigurationAttributePointer<T> extends NodePointer {
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationNodeIteratorAttribute.java
b/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationNodeIteratorAttribute.java
index b247badef..77586f42a 100644
---
a/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationNodeIteratorAttribute.java
+++
b/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationNodeIteratorAttribute.java
@@ -28,7 +28,7 @@ import org.apache.commons.lang3.Strings;
/**
* A specialized node iterator implementation that deals with attribute nodes.
*
- * @param <T> the type of the nodes this iterator deals with
+ * @param <T> The type of the nodes this iterator deals with
*/
final class ConfigurationNodeIteratorAttribute<T> extends
AbstractConfigurationNodeIterator<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationNodeIteratorChildren.java
b/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationNodeIteratorChildren.java
index cc6cf7f62..ccbb240bc 100644
---
a/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationNodeIteratorChildren.java
+++
b/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationNodeIteratorChildren.java
@@ -31,7 +31,7 @@ import org.apache.commons.lang3.Strings;
/**
* A specialized iterator implementation for the child nodes of a
configuration node.
*
- * @param <T> the type of the nodes this iterator deals with
+ * @param <T> The type of the nodes this iterator deals with
* @since 1.3
*/
final class ConfigurationNodeIteratorChildren<T> extends
AbstractConfigurationNodeIterator<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationNodePointer.java
b/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationNodePointer.java
index 7c3c00ff4..652676dea 100644
---
a/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationNodePointer.java
+++
b/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationNodePointer.java
@@ -34,7 +34,7 @@ import org.apache.commons.jxpath.ri.model.NodePointer;
* This is needed for queries using JXPath.
* </p>
*
- * @param <T> the type of the nodes this pointer deals with
+ * @param <T> The type of the nodes this pointer deals with
* @since 1.3
*/
final class ConfigurationNodePointer<T> extends NodePointer {
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationNodePointerFactory.java
b/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationNodePointerFactory.java
index 00b29b406..fcd5d5e60 100644
---
a/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationNodePointerFactory.java
+++
b/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationNodePointerFactory.java
@@ -43,7 +43,7 @@ public class ConfigurationNodePointerFactory implements
NodePointerFactory {
/**
* An internally used wrapper class that holds all information for
processing a query for a specific node.
*
- * @param <T> the type of the nodes this class deals with
+ * @param <T> The type of the nodes this class deals with
*/
static class NodeWrapper<T> {
@@ -90,7 +90,7 @@ public class ConfigurationNodePointerFactory implements
NodePointerFactory {
* Creates a node wrapper for the specified node and its handler. This
wrapper has to be passed to the JXPath context
* instead of the original node.
*
- * @param <T> the type of the node
+ * @param <T> The type of the node
* @param node the node
* @param handler the corresponding node handler
* @return a wrapper for this node
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/xpath/XPathContextFactory.java
b/src/main/java/org/apache/commons/configuration2/tree/xpath/XPathContextFactory.java
index 164db9df0..1d44a73d3 100644
---
a/src/main/java/org/apache/commons/configuration2/tree/xpath/XPathContextFactory.java
+++
b/src/main/java/org/apache/commons/configuration2/tree/xpath/XPathContextFactory.java
@@ -34,7 +34,7 @@ class XPathContextFactory {
*
* @param root the root node
* @param handler the node handler
- * @param <T> the type of the nodes to be handled
+ * @param <T> The type of the nodes to be handled
* @return the newly created context
*/
<T> JXPathContext createContext(final T root, final NodeHandler<T>
handler) {
diff --git
a/src/main/java/org/apache/commons/configuration2/tree/xpath/XPathExpressionEngine.java
b/src/main/java/org/apache/commons/configuration2/tree/xpath/XPathExpressionEngine.java
index 7f3a7dd24..35460ae80 100644
---
a/src/main/java/org/apache/commons/configuration2/tree/xpath/XPathExpressionEngine.java
+++
b/src/main/java/org/apache/commons/configuration2/tree/xpath/XPathExpressionEngine.java
@@ -152,7 +152,7 @@ public class XPathExpressionEngine implements
ExpressionEngine {
* Converts the objects returned as query result from the JXPathContext to
query result objects.
*
* @param results the list with results from the context
- * @param <T> the type of results to be produced
+ * @param <T> The type of results to be produced
* @return the result list
*/
private static <T> List<QueryResult<T>> convertResults(final List<?>
results) {
@@ -170,7 +170,7 @@ public class XPathExpressionEngine implements
ExpressionEngine {
* functionality.
*
* @param resObj the query result object
- * @param <T> the type of the result to be produced
+ * @param <T> The type of the result to be produced
* @return the {@code QueryResult}
*/
@SuppressWarnings("unchecked")
@@ -187,7 +187,7 @@ public class XPathExpressionEngine implements
ExpressionEngine {
* @param parent the parent node
* @param child the child node
* @param handler the node handler
- * @param <T> the type of the nodes involved
+ * @param <T> The type of the nodes involved
* @return the index of this child node
*/
private static <T> int determineIndex(final T parent, final T child, final
NodeHandler<T> handler) {
@@ -289,7 +289,7 @@ public class XPathExpressionEngine implements
ExpressionEngine {
*
* @param path the path of the new node
* @param parentNodeResult the parent node
- * @param <T> the type of the nodes involved
+ * @param <T> The type of the nodes involved
*/
<T> NodeAddData<T> createNodeAddData(final String path, final
QueryResult<T> parentNodeResult) {
if (parentNodeResult.isAttributeResult()) {
diff --git
a/src/test/java/org/apache/commons/configuration2/DatabaseConfigurationTestHelper.java
b/src/test/java/org/apache/commons/configuration2/DatabaseConfigurationTestHelper.java
index 5fe6c71b9..cc6ad2382 100644
---
a/src/test/java/org/apache/commons/configuration2/DatabaseConfigurationTestHelper.java
+++
b/src/test/java/org/apache/commons/configuration2/DatabaseConfigurationTestHelper.java
@@ -86,7 +86,7 @@ public class DatabaseConfigurationTestHelper {
/**
* Creates a configuration instance of the specified class with the given
parameters.
*
- * @param <T> the type of the result configuration
+ * @param <T> The type of the result configuration
* @param configCls the configuration class
* @param params the parameters object
* @return the newly created configuration instance
@@ -155,7 +155,7 @@ public class DatabaseConfigurationTestHelper {
/**
* Creates a database configuration with default settings of the specified
class.
*
- * @param <T> the type of the result configuration
+ * @param <T> The type of the result configuration
* @param configCls the configuration class
* @return the newly created configuration instance
* @throws ConfigurationException if an error occurs
@@ -218,7 +218,7 @@ public class DatabaseConfigurationTestHelper {
/**
* Creates a configuration with support for multiple configuration
instances in a single table of the specified class.
*
- * @param <T> the type of the result configuration
+ * @param <T> The type of the result configuration
* @param configCls the configuration class
* @param configName the name of the configuration instance or
<strong>null</strong> for the default name
* @return the newly created configuration instance
diff --git
a/src/test/java/org/apache/commons/configuration2/builder/BuilderEventListenerImpl.java
b/src/test/java/org/apache/commons/configuration2/builder/BuilderEventListenerImpl.java
index 55d0dbbab..d191f38f6 100644
---
a/src/test/java/org/apache/commons/configuration2/builder/BuilderEventListenerImpl.java
+++
b/src/test/java/org/apache/commons/configuration2/builder/BuilderEventListenerImpl.java
@@ -63,7 +63,7 @@ public class BuilderEventListenerImpl implements
EventListener<ConfigurationBuil
* there are no more events or the next event is of a different event type.
*
* @param eventType the expected event type
- * @param <T> the type of the received event
+ * @param <T> The type of the received event
* @return the next received event
*/
public <T extends ConfigurationBuilderEvent> T nextEvent(final
EventType<T> eventType) {
diff --git
a/src/test/java/org/apache/commons/configuration2/event/AbstractEventListenerTestImpl.java
b/src/test/java/org/apache/commons/configuration2/event/AbstractEventListenerTestImpl.java
index bbe3d337a..10d411e46 100644
---
a/src/test/java/org/apache/commons/configuration2/event/AbstractEventListenerTestImpl.java
+++
b/src/test/java/org/apache/commons/configuration2/event/AbstractEventListenerTestImpl.java
@@ -28,7 +28,7 @@ import java.util.List;
* A base class for different types of event listeners which can be used in
unit tests. This class provides
* functionality for testing the received events.
*
- * @param <T> the type of events supported by this listener
+ * @param <T> The type of events supported by this listener
*/
public abstract class AbstractEventListenerTestImpl<T extends Event>
implements EventListener<T> {
