This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-configuration.git
The following commit(s) were added to refs/heads/master by this push:
new c45d05e6 Javadoc @since tag should be after @return and @throws
c45d05e6 is described below
commit c45d05e6e1cab02344e2e318292110d2f5cfcf92
Author: Gary D. Gregory <[email protected]>
AuthorDate: Sat Mar 22 09:30:49 2025 -0400
Javadoc @since tag should be after @return and @throws
---
.../commons/configuration2/AbstractHierarchicalConfiguration.java | 2 +-
.../org/apache/commons/configuration2/HierarchicalConfiguration.java | 2 +-
.../apache/commons/configuration2/builder/BasicBuilderProperties.java | 2 +-
.../commons/configuration2/builder/BasicConfigurationBuilder.java | 2 +-
.../org/apache/commons/configuration2/builder/ConfigurationBuilder.java | 2 +-
.../commons/configuration2/builder/DatabaseBuilderProperties.java | 2 +-
.../apache/commons/configuration2/builder/DefaultParametersHandler.java | 2 +-
.../commons/configuration2/builder/FileBasedConfigurationBuilder.java | 2 +-
.../commons/configuration2/builder/HierarchicalBuilderProperties.java | 2 +-
.../org/apache/commons/configuration2/builder/INIBuilderProperties.java | 2 +-
.../apache/commons/configuration2/builder/JndiBuilderProperties.java | 2 +-
.../commons/configuration2/builder/PropertiesBuilderProperties.java | 2 +-
.../configuration2/builder/ReloadingFileBasedConfigurationBuilder.java | 2 +-
.../org/apache/commons/configuration2/builder/XMLBuilderProperties.java | 2 +-
.../configuration2/builder/combined/CombinedBuilderProperties.java | 2 +-
.../configuration2/builder/combined/MultiFileBuilderProperties.java | 2 +-
.../configuration2/builder/combined/MultiFileConfigurationBuilder.java | 2 +-
.../builder/combined/ReloadingMultiFileConfigurationBuilder.java | 2 +-
.../java/org/apache/commons/configuration2/event/EventListener.java | 2 +-
.../commons/configuration2/event/EventListenerRegistrationData.java | 2 +-
src/main/java/org/apache/commons/configuration2/event/EventType.java | 2 +-
.../apache/commons/configuration2/tree/ConfigurationNodeVisitor.java | 2 +-
src/main/java/org/apache/commons/configuration2/tree/NodeAddData.java | 2 +-
.../org/apache/commons/configuration2/tree/NodeHandlerDecorator.java | 2 +-
.../java/org/apache/commons/configuration2/tree/NodeKeyResolver.java | 2 +-
src/main/java/org/apache/commons/configuration2/tree/NodeMatcher.java | 2 +-
src/main/java/org/apache/commons/configuration2/tree/NodeModel.java | 2 +-
.../java/org/apache/commons/configuration2/tree/NodeModelSupport.java | 2 +-
.../java/org/apache/commons/configuration2/tree/NodeUpdateData.java | 2 +-
src/main/java/org/apache/commons/configuration2/tree/QueryResult.java | 2 +-
.../configuration2/tree/xpath/AbstractConfigurationNodeIterator.java | 2 +-
.../configuration2/tree/xpath/ConfigurationAttributePointer.java | 2 +-
.../configuration2/tree/xpath/ConfigurationNodeIteratorChildren.java | 2 +-
.../commons/configuration2/tree/xpath/ConfigurationNodePointer.java | 2 +-
34 files changed, 34 insertions(+), 34 deletions(-)
diff --git
a/src/main/java/org/apache/commons/configuration2/AbstractHierarchicalConfiguration.java
b/src/main/java/org/apache/commons/configuration2/AbstractHierarchicalConfiguration.java
index 3b25df97..a56be2aa 100644
---
a/src/main/java/org/apache/commons/configuration2/AbstractHierarchicalConfiguration.java
+++
b/src/main/java/org/apache/commons/configuration2/AbstractHierarchicalConfiguration.java
@@ -148,8 +148,8 @@ import org.apache.commons.configuration2.tree.QueryResult;
* undesired effects. For concrete subclasses dealing with specific node
structures, this situation may be different.
* </p>
*
- * @since 2.0
* @param <T> the type of the nodes managed by this hierarchical configuration
+ * @since 2.0
*/
public abstract class AbstractHierarchicalConfiguration<T> extends
AbstractConfiguration
implements Cloneable, NodeKeyResolver<T>, HierarchicalConfiguration<T> {
diff --git
a/src/main/java/org/apache/commons/configuration2/HierarchicalConfiguration.java
b/src/main/java/org/apache/commons/configuration2/HierarchicalConfiguration.java
index b4e72637..e6117fbe 100644
---
a/src/main/java/org/apache/commons/configuration2/HierarchicalConfiguration.java
+++
b/src/main/java/org/apache/commons/configuration2/HierarchicalConfiguration.java
@@ -36,8 +36,8 @@ import
org.apache.commons.configuration2.tree.NodeModelSupport;
* structures.
* </p>
*
- * @since 2.0
* @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/builder/BasicBuilderProperties.java
b/src/main/java/org/apache/commons/configuration2/builder/BasicBuilderProperties.java
index ec841717..e30b4887 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/BasicBuilderProperties.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/BasicBuilderProperties.java
@@ -42,8 +42,8 @@ import org.apache.commons.configuration2.sync.Synchronizer;
* available properties and may be extended even in minor releases.
* </p>
*
- * @since 2.0
* @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 29364453..91b50dcc 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/BasicConfigurationBuilder.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/BasicConfigurationBuilder.java
@@ -85,8 +85,8 @@ import
org.apache.commons.configuration2.reloading.ReloadingController;
* {@code ImmutableConfiguration} instance is returned until the builder is
reset.
* </p>
*
- * @since 2.0
* @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> {
/**
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 e00bc89e..9812b7ae 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/ConfigurationBuilder.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/ConfigurationBuilder.java
@@ -36,8 +36,8 @@ import
org.apache.commons.configuration2.ex.ConfigurationException;
* configurations can be created.
* </p>
*
- * @since 2.0
* @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 e9318698..5b15b207 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/DatabaseBuilderProperties.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/DatabaseBuilderProperties.java
@@ -32,8 +32,8 @@ import javax.sql.DataSource;
* available properties and may be extended even in minor releases.
* </p>
*
- * @since 2.0
* @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 a58adbf2..f605dfff 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/DefaultParametersHandler.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/DefaultParametersHandler.java
@@ -28,8 +28,8 @@ package org.apache.commons.configuration2.builder;
* initialization.
* </p>
*
- * @since 2.0
* @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/FileBasedConfigurationBuilder.java
b/src/main/java/org/apache/commons/configuration2/builder/FileBasedConfigurationBuilder.java
index 6f570c63..3db30f4b 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/FileBasedConfigurationBuilder.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/FileBasedConfigurationBuilder.java
@@ -47,8 +47,8 @@ import org.apache.commons.lang3.StringUtils;
* location is reset, too.
* </p>
*
- * @since 2.0
* @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> {
/** A map for storing default encodings for specific configuration
classes. */
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 8990b0f4..95b861fc 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/HierarchicalBuilderProperties.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/HierarchicalBuilderProperties.java
@@ -30,8 +30,8 @@ import
org.apache.commons.configuration2.tree.ExpressionEngine;
* available properties and may be extended even in minor releases.
* </p>
*
- * @since 2.0
* @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 1fd9aa25..3cefb5c7 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/INIBuilderProperties.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/INIBuilderProperties.java
@@ -28,8 +28,8 @@ package org.apache.commons.configuration2.builder;
* available properties and may be extended even in minor releases.
* </p>
*
- * @since 2.2
* @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 654dfc1d..9021c535 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/JndiBuilderProperties.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/JndiBuilderProperties.java
@@ -30,8 +30,8 @@ import javax.naming.Context;
* available properties and may be extended even in minor releases.
* </p>
*
- * @since 2.0
* @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 b336894c..6e65d188 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/PropertiesBuilderProperties.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/PropertiesBuilderProperties.java
@@ -34,8 +34,8 @@ import
org.apache.commons.configuration2.ex.ConfigurationException;
* available properties and may be extended even in minor releases.
* </p>
*
- * @since 2.0
* @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 3768fc1d..dc61f587 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/ReloadingFileBasedConfigurationBuilder.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/ReloadingFileBasedConfigurationBuilder.java
@@ -48,8 +48,8 @@ import
org.apache.commons.configuration2.reloading.ReloadingDetector;
* by an external component, for example a timer.
* </p>
*
- * @since 2.0
* @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>
implements ReloadingControllerSupport {
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 6c329b56..cdf0fd0c 100644
---
a/src/main/java/org/apache/commons/configuration2/builder/XMLBuilderProperties.java
+++
b/src/main/java/org/apache/commons/configuration2/builder/XMLBuilderProperties.java
@@ -32,8 +32,8 @@ import org.xml.sax.EntityResolver;
* available properties and may be extended even in minor releases.
* </p>
*
- * @since 2.0
* @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 124c18b5..5751d481 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,8 +35,8 @@ import
org.apache.commons.configuration2.builder.DefaultParametersManager;
* available properties and may be extended even in minor releases.
* </p>
*
- * @since 2.0
* @param <T> the return type of all methods for allowing method chaining
+ * @since 2.0
*/
public interface CombinedBuilderProperties<T> {
/**
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 78617709..e15f8e81 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,8 +31,8 @@ import
org.apache.commons.configuration2.builder.BuilderParameters;
* available properties and may be extended even in minor releases.
* </p>
*
- * @since 2.0
* @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 905fec04..9dce5b56 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,8 +66,8 @@ import org.apache.commons.lang3.concurrent.ConcurrentUtils;
* builders for managed configurations.
* </p>
*
- * @since 2.0
* @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 3b631457..bada1297 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,8 +52,8 @@ import
org.apache.commons.configuration2.reloading.ReloadingControllerSupport;
* configuration, but occur for each of the managed configuration.
* </p>
*
- * @since 2.0
* @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>
implements ReloadingControllerSupport {
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 611c14b1..998c89c7 100644
--- a/src/main/java/org/apache/commons/configuration2/event/EventListener.java
+++ b/src/main/java/org/apache/commons/configuration2/event/EventListener.java
@@ -27,8 +27,8 @@ package org.apache.commons.configuration2.event;
* Java 8 ({@code EventListener} is a functional interface and thus can be
represented by a Lambda expression).
* </p>
*
- * @since 2.0
* @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/EventListenerRegistrationData.java
b/src/main/java/org/apache/commons/configuration2/event/EventListenerRegistrationData.java
index 81f20f86..6f927585 100644
---
a/src/main/java/org/apache/commons/configuration2/event/EventListenerRegistrationData.java
+++
b/src/main/java/org/apache/commons/configuration2/event/EventListenerRegistrationData.java
@@ -30,8 +30,8 @@ package org.apache.commons.configuration2.event;
* components.
* </p>
*
- * @since 2.0
* @param <T> the type of events processed by the listener
+ * @since 2.0
*/
public final class EventListenerRegistrationData<T extends Event> {
/** Constant for the factor used by the calculation of the hash code. */
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 40cc1990..b89aded6 100644
--- a/src/main/java/org/apache/commons/configuration2/event/EventType.java
+++ b/src/main/java/org/apache/commons/configuration2/event/EventType.java
@@ -36,8 +36,8 @@ import java.util.Set;
* listener interfaces and a natural selection of events to be processed.
* </p>
*
- * @since 2.0
* @param <T> the event associated with this type
+ * @since 2.0
*/
public class EventType<T extends Event> implements Serializable {
/** Serial version UID. */
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 caedc83e..fc120c5b 100644
---
a/src/main/java/org/apache/commons/configuration2/tree/ConfigurationNodeVisitor.java
+++
b/src/main/java/org/apache/commons/configuration2/tree/ConfigurationNodeVisitor.java
@@ -30,8 +30,8 @@ package org.apache.commons.configuration2.tree;
* traversal process.
* </p>
*
- * @since 1.3
* @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/NodeAddData.java
b/src/main/java/org/apache/commons/configuration2/tree/NodeAddData.java
index 7fa838c1..abcef5dc 100644
--- a/src/main/java/org/apache/commons/configuration2/tree/NodeAddData.java
+++ b/src/main/java/org/apache/commons/configuration2/tree/NodeAddData.java
@@ -42,8 +42,8 @@ import java.util.List;
* operation) and the new node</li>
* </ul>
*
- * @since 1.3
* @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/NodeHandlerDecorator.java
b/src/main/java/org/apache/commons/configuration2/tree/NodeHandlerDecorator.java
index 3052cf34..91c70a58 100644
---
a/src/main/java/org/apache/commons/configuration2/tree/NodeHandlerDecorator.java
+++
b/src/main/java/org/apache/commons/configuration2/tree/NodeHandlerDecorator.java
@@ -29,8 +29,8 @@ import java.util.Set;
* classes have to implement the {@code getDecoratedNodeHandler()} method to
provide the underlying handler.
* </p>
*
- * @since 2.0
* @param <T> the type of the nodes supported by this handler
+ * @since 2.0
*/
public abstract class NodeHandlerDecorator<T> implements NodeHandler<T> {
@Override
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 a0462e4d..f8f8eab6 100644
--- a/src/main/java/org/apache/commons/configuration2/tree/NodeKeyResolver.java
+++ b/src/main/java/org/apache/commons/configuration2/tree/NodeKeyResolver.java
@@ -29,8 +29,8 @@ import java.util.Map;
* processing of complex update operations.
* </p>
*
- * @since 2.0
* @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 d94c3e9f..f2d693d5 100644
--- a/src/main/java/org/apache/commons/configuration2/tree/NodeMatcher.java
+++ b/src/main/java/org/apache/commons/configuration2/tree/NodeMatcher.java
@@ -33,8 +33,8 @@ package org.apache.commons.configuration2.tree;
* between multiple components.
* </p>
*
- * @since 2.0
* @param <C> the type of the criterion evaluated by this matcher
+ * @since 2.0
*/
public interface NodeMatcher<C> {
/**
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 857707b2..130c2bab 100644
--- a/src/main/java/org/apache/commons/configuration2/tree/NodeModel.java
+++ b/src/main/java/org/apache/commons/configuration2/tree/NodeModel.java
@@ -35,8 +35,8 @@ import java.util.Collection;
* which knows how to deal with keys.
* </p>
*
- * @since 2.0
* @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 603340be..4fef7151 100644
--- a/src/main/java/org/apache/commons/configuration2/tree/NodeModelSupport.java
+++ b/src/main/java/org/apache/commons/configuration2/tree/NodeModelSupport.java
@@ -24,8 +24,8 @@ package org.apache.commons.configuration2.tree;
* This interface defines a single method for querying a {@code NodeModel}.
* </p>
*
- * @since 2.0
* @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/NodeUpdateData.java
b/src/main/java/org/apache/commons/configuration2/tree/NodeUpdateData.java
index 90ca0fdb..f031cef4 100644
--- a/src/main/java/org/apache/commons/configuration2/tree/NodeUpdateData.java
+++ b/src/main/java/org/apache/commons/configuration2/tree/NodeUpdateData.java
@@ -36,8 +36,8 @@ import java.util.Map;
* update based on a passed in instance.
* </p>
*
- * @since 2.0
* @param <T> the type of nodes involved in this update operation
+ * @since 2.0
*/
public class NodeUpdateData<T> {
/**
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 641f8111..c3c391e7 100644
--- a/src/main/java/org/apache/commons/configuration2/tree/QueryResult.java
+++ b/src/main/java/org/apache/commons/configuration2/tree/QueryResult.java
@@ -34,8 +34,8 @@ import org.apache.commons.lang3.builder.ToStringBuilder;
* Implementation note: Instances are immutable. They are created using the
static factory methods.
* </p>
*
- * @since 2.0
* @param <T> the type of the result nodes
+ * @since 2.0
*/
public final class QueryResult<T> {
/**
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 8d743f1a..eed02735 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,8 +31,8 @@ import org.apache.commons.lang3.StringUtils;
* implement specific behavior based on the concrete node type (child node or
attribute node).
* </p>
*
- * @since 1.3
* @param <T> the type of the nodes this iterator deals with
+ * @since 1.3
*/
abstract class AbstractConfigurationNodeIterator<T> implements NodeIterator {
/** Constant for the prefix separator. */
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 92be53be..3f0680d6 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,8 +29,8 @@ import org.apache.commons.jxpath.ri.model.NodePointer;
* A specialized {@code NodePointer} implementation for the attributes of a
configuration node.
* </p>
*
- * @since 2.0
* @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/ConfigurationNodeIteratorChildren.java
b/src/main/java/org/apache/commons/configuration2/tree/xpath/ConfigurationNodeIteratorChildren.java
index f0c3176a..3ee79049 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,8 +31,8 @@ import org.apache.commons.lang3.StringUtils;
/**
* A specialized iterator implementation for the child nodes of a
configuration node.
*
- * @since 1.3
* @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 67d1f72a..3efd605c 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,8 +34,8 @@ import org.apache.commons.jxpath.ri.model.NodePointer;
* This is needed for queries using JXPath.
* </p>
*
- * @since 1.3
* @param <T> the type of the nodes this pointer deals with
+ * @since 1.3
*/
final class ConfigurationNodePointer<T> extends NodePointer {
/**