(commons-digester) branch master updated: Javadoc

[ggregory]

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


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

commit 2bf53273d105cd47c3224b45a0c1754b940e8575
Author: Gary Gregory 
AuthorDate: Sun Jan 4 12:41:19 2026 -0500

Javadoc

Add an empty line before a Javadoc comment
---
 .../java/org/apache/commons/digester3/ObjectParamRule.java|  1 +
 .../commons/digester3/binder/NodeCreateRuleProvider.java  | 11 +++
 2 files changed, 12 insertions(+)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/ObjectParamRule.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/ObjectParamRule.java
index a9bb0580..d1d33957 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/ObjectParamRule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/ObjectParamRule.java
@@ -42,6 +42,7 @@ import org.xml.sax.Attributes;
 public class ObjectParamRule
 extends Rule
 {
+
 /**
  * The attribute which we are attempting to match
  */
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/NodeCreateRuleProvider.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/NodeCreateRuleProvider.java
index 468b302a..a9e2b584 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/NodeCreateRuleProvider.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/NodeCreateRuleProvider.java
@@ -56,46 +56,57 @@ public final class NodeCreateRuleProvider
  * @see org.w3c.dom.Node#ATTRIBUTE_NODE
  */
 ATTRIBUTE( ATTRIBUTE_NODE ),
+
 /**
  * @see org.w3c.dom.Node#CDATA_SECTION_NODE
  */
 CDATA( CDATA_SECTION_NODE ),
+
 /**
  * @see org.w3c.dom.Node#COMMENT_NODE
  */
 COMMENT( COMMENT_NODE ),
+
 /**
  * @see org.w3c.dom.Node#DOCUMENT_FRAGMENT_NODE
  */
 DOCUMENT_FRAGMENT( DOCUMENT_FRAGMENT_NODE ),
+
 /**
  * @see org.w3c.dom.Node#DOCUMENT_NODE
  */
 DOCUMENT( DOCUMENT_NODE ),
+
 /**
  * @see org.w3c.dom.Node#DOCUMENT_TYPE_NODE
  */
 DOCUMENT_TYPE( DOCUMENT_TYPE_NODE ),
+
 /**
  * @see org.w3c.dom.Node#ELEMENT_NODE
  */
 ELEMENT( ELEMENT_NODE ),
+
 /**
  * @see org.w3c.dom.Node#ENTITY_NODE
  */
 ENTITY( ENTITY_NODE ),
+
 /**
  * @see org.w3c.dom.Node#ENTITY_REFERENCE_NODE
  */
 ENTITY_REFERENCE( ENTITY_REFERENCE_NODE ),
+
 /**
  * @see org.w3c.dom.Node#NOTATION_NODE
  */
 NOTATION( NOTATION_NODE ),
+
 /**
  * @see org.w3c.dom.Node#PROCESSING_INSTRUCTION_NODE
  */
 PROCESSING_INSTRUCTION( PROCESSING_INSTRUCTION_NODE ),
+
 /**
  * @see org.w3c.dom.Node#TEXT_NODE
  */

(commons-digester) branch master updated: Javadoc

[ggregory]

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


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

commit 37b337fde13a5d3e3772f742f666476a32bbe93f
Author: Gary Gregory 
AuthorDate: Fri Jan 2 18:35:54 2026 -0500

Javadoc
---
 .../org/apache/commons/digester3/AbstractObjectCreationFactory.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/AbstractObjectCreationFactory.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/AbstractObjectCreationFactory.java
index da2bcfe2..a29e9a6d 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/AbstractObjectCreationFactory.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/AbstractObjectCreationFactory.java
@@ -22,7 +22,7 @@ package org.apache.commons.digester3;
 import org.xml.sax.Attributes;
 
 /**
- * Abstract class for {@code ObjectCreationFactory} implementations.
+ * Abstract classs for {@code ObjectCreationFactory} implementations.
  *
  * @param  The object type will be instantiate by this factory.
  */

(commons-digester) branch master updated: Javadoc

[ggregory]

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


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

commit ee1b6be7767326cd919e7c0eafcd0d717be43e8b
Author: Gary Gregory 
AuthorDate: Fri Jan 2 18:35:36 2026 -0500

Javadoc
---
 .../org/apache/commons/digester3/AbstractObjectCreationFactory.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/AbstractObjectCreationFactory.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/AbstractObjectCreationFactory.java
index dcd4e4a3..da2bcfe2 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/AbstractObjectCreationFactory.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/AbstractObjectCreationFactory.java
@@ -22,7 +22,7 @@ package org.apache.commons.digester3;
 import org.xml.sax.Attributes;
 
 /**
- * Abstrac class for {@code ObjectCreationFactory} implementations.
+ * Abstract class for {@code ObjectCreationFactory} implementations.
  *
  * @param  The object type will be instantiate by this factory.
  */

(commons-digester) branch master updated: Javadoc

[ggregory]

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


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

commit de24d49f0be2591d62d77755373e867f5d056d15
Author: Gary Gregory 
AuthorDate: Fri Jan 2 18:21:34 2026 -0500

Javadoc
---
 .../org/apache/commons/digester3/AbstractObjectCreationFactory.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/AbstractObjectCreationFactory.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/AbstractObjectCreationFactory.java
index c1d78277..dcd4e4a3 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/AbstractObjectCreationFactory.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/AbstractObjectCreationFactory.java
@@ -22,7 +22,7 @@ package org.apache.commons.digester3;
 import org.xml.sax.Attributes;
 
 /**
- * Abstract base class for {@code ObjectCreationFactory} implementations.
+ * Abstrac class for {@code ObjectCreationFactory} implementations.
  *
  * @param  The object type will be instantiate by this factory.
  */

(commons-digester) branch master updated: Javadoc

[ggregory]

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


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

commit 5d56300b81a0e1eb0967b97c7152ce13a9aa782b
Author: Gary Gregory 
AuthorDate: Sun Dec 21 15:33:08 2025 -0500

Javadoc
---
 .../src/main/java/org/apache/commons/digester3/plugins/Declaration.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/Declaration.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/Declaration.java
index 971f27d9..df3bdd1c 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/Declaration.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/Declaration.java
@@ -222,7 +222,7 @@ public class Declaration
 }
 
 /**
- * Copy all (key,value) pairs in the param into the properties member of 
this object.
+ * Copy all (key, value) pairs in the param into the properties member of 
this object.
  * 
  * The declaration properties cannot be explicit member variables, because 
the set of useful properties a user can
  * provide on a declaration depends on what RuleFinder classes are 
available - and extra RuleFinders can be added by

(commons-digester) branch master updated: Javadoc @since tag should be after @return and @throws

[ggregory]

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


The following commit(s) were added to refs/heads/master by this push:
 new 27adbc7d Javadoc @since tag should be after @return and @throws
27adbc7d is described below

commit 27adbc7d382a7d9ca1f3429f09cff109ddb570a1
Author: Gary D. Gregory 
AuthorDate: Sat Mar 22 09:32:08 2025 -0400

Javadoc @since tag should be after @return and @throws
---
 .../src/main/java/org/apache/commons/digester3/Digester.java| 2 +-
 .../main/java/org/apache/commons/digester3/binder/AddAliasBuilder.java  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/Digester.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/Digester.java
index 271927cb..ec96427d 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/Digester.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/Digester.java
@@ -1974,10 +1974,10 @@ public class Digester
 /**
  * Helps casting the input object to given type, avoiding NPEs.
  *
- * @since 3.0
  * @param  the type the input object has to be cast.
  * @param obj the object has to be cast.
  * @return the casted object, if input object is not null, null otherwise.
+ * @since 3.0
  */
 private  T npeSafeCast( final Object obj )
 {
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/AddAliasBuilder.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/AddAliasBuilder.java
index 9c04b2d1..982e35e2 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/AddAliasBuilder.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/AddAliasBuilder.java
@@ -22,8 +22,8 @@ package org.apache.commons.digester3.binder;
 import java.util.Map;
 
 /**
- * @since 3.2
  * @param  the parent builder type.
+ * @since 3.2
  */
 public final class AddAliasBuilder
 {

(commons-digester) branch master updated: Javadoc: Use semantic tag instead of style tag

[ggregory]

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


The following commit(s) were added to refs/heads/master by this push:
 new 605614d8 Javadoc: Use semantic tag  instead of style tag 
605614d8 is described below

commit 605614d8ca14bda5d047d4fcb86c481c8e718490
Author: Gary Gregory 
AuthorDate: Fri Nov 15 11:18:44 2024 -0500

Javadoc: Use semantic tag  instead of style tag 
---
 .../org/apache/commons/digester3/SetNestedPropertiesRule.java | 6 +++---
 .../main/java/org/apache/commons/digester3/SetPropertiesRule.java | 4 ++--
 .../java/org/apache/commons/digester3/binder/DigesterLoader.java  | 8 
 .../org/apache/commons/digester3/binder/LinkedRuleBuilder.java| 2 +-
 .../commons/digester3/examples/api/documentmarkup/Main.java   | 2 +-
 5 files changed, 11 insertions(+), 11 deletions(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/SetNestedPropertiesRule.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/SetNestedPropertiesRule.java
index 5e5a7f07..b24bfcbb 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/SetNestedPropertiesRule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/SetNestedPropertiesRule.java
@@ -75,7 +75,7 @@ import org.xml.sax.Attributes;
  * (or equivalent) to handle assigning the child object to the appropriate 
property instead.
  * 
  * 
- * Implementation Notes
+ * Implementation Notes
  * 
  * 
  * This class works by creating its own simple Rules implementation. When 
begin is invoked on this rule, the digester's
@@ -383,7 +383,7 @@ public class SetNestedPropertiesRule
  * If a property name is null or the XML element name has no matching 
property name due to the arrays being of
  * different lengths then this indicates that the XML element should be 
ignored.
  * 
- * Example One
+ * Example One
  * 
  * The following constructs a rule that maps the {@code alt-city} element 
to the {@code city} property and
  * the {@code alt-state} to the {@code state} property. All other child 
elements are mapped as usual using
@@ -394,7 +394,7 @@ public class SetNestedPropertiesRule
  *new String[] {"alt-city", "alt-state"},
  *new String[] {"city", "state"});
  * }
- * Example Two
+ * Example Two
  * 
  * The following constructs a rule that maps the {@code class} XML element 
to the {@code className}
  * property. The XML element {@code ignore-me} is not mapped, ie is 
ignored. All other elements are mapped as
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/SetPropertiesRule.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/SetPropertiesRule.java
index 09efae4d..062c7f98 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/SetPropertiesRule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/SetPropertiesRule.java
@@ -103,7 +103,7 @@ public class SetPropertiesRule
  * If a property name is null or the attribute name has no matching 
property name, then this indicates that the
  * attribute should be ignored.
  * 
- * Example One
+ * Example One
  * 
  * The following constructs a rule that maps the {@code alt-city} 
attribute to the {@code city} property
  * and the {@code alt-state} to the {@code state} property. All other 
attributes are mapped as usual using
@@ -114,7 +114,7 @@ public class SetPropertiesRule
  *new String[] {"alt-city", "alt-state"},
  *new String[] {"city", "state"});
  * }
- * Example Two
+ * Example Two
  * 
  * The following constructs a rule that maps the {@code class} attribute 
to the {@code className}
  * property. The attribute {@code ignore-me} is not mapped. All other 
attributes are mapped as usual using
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/DigesterLoader.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/DigesterLoader.java
index 2d674a12..1980de17 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/DigesterLoader.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/DigesterLoader.java
@@ -364,8 +364,8 @@ public final class DigesterLoader
  * Creates a new {@link XMLReader} instance that relies on the given 
{@code XMLReader}
  * and the default {@link Rules} implementation.
  *
- * WARNING Input {@link XMLReader} will be linked to built Digester 
instance so it is recommended
- * to NOT share same {@link XMLReader} instance to produce the 
Digester.
+ * WARNING Input {@link XMLReader} will be linked to 
built Digester insta

(commons-digester) branch master updated: Javadoc typo

[ggregory]

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


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

commit 6aa17747adbc5daa2214bd53f9ab087a255c1b28
Author: Gary Gregory 
AuthorDate: Fri Oct 18 18:06:18 2024 -0400

Javadoc typo
---
 .../src/main/java/org/apache/commons/digester3/CallMethodRule.java  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
index f6bab413..3f5db5ca 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
@@ -271,7 +271,7 @@ public class CallMethodRule
  * {@code paramTypes} is null or empty, in this case the rule will call 
the specified method with no arguments.
  *
  * @param methodName Method name of the parent method to call
- * @param paramCount The number of parameters to collect, or zero for a 
single argument from the body of ths element
+ * @param paramCount The number of parameters to collect, or zero for a 
single argument from the body of the element
  * @param paramTypes The Java class names of the arguments (if you wish to 
use a primitive type, specify the
  *corresonding Java wrapper class instead, such as {@link 
Boolean} for a
  *{@code boolean} parameter)

(commons-digester) branch master updated: Javadoc

[ggregory]

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


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

commit 0d5bd1a9bb71e2d40a38d48a2cdf51e9480e4b3b
Author: Gary Gregory 
AuthorDate: Sun Jul 21 11:33:36 2024 -0400

Javadoc

Use HTML 'em' tag instead of 'i' tag
---
 .../apache/commons/digester3/CallMethodRule.java   |  6 +++---
 .../apache/commons/digester3/CallParamRule.java|  2 +-
 .../org/apache/commons/digester3/Digester.java |  4 ++--
 .../digester3/binder/PluginCreateRuleBuilder.java  |  4 ++--
 .../apache/commons/digester3/plugins/LogUtils.java |  4 ++--
 .../digester3/plugins/PluginAssertionFailure.java  |  2 +-
 .../commons/digester3/plugins/PluginContext.java   |  8 
 .../digester3/plugins/PluginCreateRule.java| 22 +++---
 .../commons/digester3/plugins/PluginRules.java |  8 
 .../plugins/strategies/FinderSetProperties.java|  6 +++---
 .../OverlappingCallMethodRuleTestCase.java |  2 +-
 .../examples/api/catalog/BookFactory.java  |  2 +-
 .../examples/api/dbinsert/RowInserterRule.java |  2 +-
 .../examples/api/documentmarkup/Main.java  |  2 +-
 .../examples/xmlrules/addressbook/Main.java|  2 +-
 15 files changed, 38 insertions(+), 38 deletions(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
index c906371b..f6bab413 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
@@ -49,8 +49,8 @@ import org.xml.sax.SAXException;
  * Setting the {@code UseExactMatch} to true reverts to the use of this method.
  * 
  * 
- * Note that the target method is invoked when the end of the tag the 
CallMethodRule fired on is encountered,
- * not when the last parameter becomes available. This implies that 
rules which fire on tags nested within the
+ * Note that the target method is invoked when the end of the tag the 
CallMethodRule fired on is encountered,
+ * not when the last parameter becomes available. This implies that 
rules which fire on tags nested within the
  * one associated with the CallMethodRule will fire before the CallMethodRule 
invokes the target method. This behavior
  * is not configurable.
  * 
@@ -67,7 +67,7 @@ import org.xml.sax.SAXException;
  * 
  * 
  * Note that when a constructor is used with paramCount=0, indicating that the 
body of the element is to be passed to
- * the target method, an empty element will cause an empty string to be 
passed to the target method, not null.
+ * the target method, an empty element will cause an empty string to 
be passed to the target method, not null.
  * And if automatic type conversion is being applied (ie if the target 
function takes something other than a string as a
  * parameter) then the conversion will fail if the converter class does not 
accept an empty string as valid input.
  * 
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallParamRule.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallParamRule.java
index 9c5e9909..b5bd64b1 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallParamRule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallParamRule.java
@@ -70,7 +70,7 @@ public class CallParamRule
 /**
  * Constructs a "call parameter" rule that will save the body text of this 
element as the parameter value.
  * 
- * Note that if the element is empty the an empty string is passed 
to the target method, not null. And if
+ * Note that if the element is empty the an empty string is 
passed to the target method, not null. And if
  * automatic type conversion is being applied (ie if the target function 
takes something other than a string as a
  * parameter) then the conversion will fail if the converter class does 
not accept an empty string as valid input.
  * 
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/Digester.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/Digester.java
index 208d14a9..60efb30e 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/Digester.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/Digester.java
@@ -1051,13 +1051,13 @@ public class Digester
  * Clear the current contents of the default object stack, the param 
stack, all named stacks, and other internal
  * variables.
  * 
- * Calling this method might allow another document of the same 
type to be

(commons-digester) branch master updated: Javadoc

[ggregory]

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


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

commit b6d6a51178e8b4643d5fe58676edddc837f4002a
Author: Gary Gregory 
AuthorDate: Tue Jun 18 09:10:25 2024 -0400

Javadoc
---
 .../src/main/java/org/apache/commons/digester3/CallMethodRule.java| 4 ++--
 .../java/org/apache/commons/digester3/binder/CallMethodBuilder.java   | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
index 50609968..3baefcc7 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
@@ -176,7 +176,7 @@ public class CallMethodRule
  * @param paramCount The number of parameters to collect, or zero for a 
single argument from the body of the element
  * @param paramTypes The Java classes that represent the parameter types 
of the method arguments (if you wish to use
  *a primitive type, specify the corresponding Java wrapper 
class instead, such as
- *{@link java.lang.Boolean#TYPE} for a {@code boolean} 
parameter)
+ *{@link Boolean#TYPE} for a {@code boolean} parameter)
  */
 public CallMethodRule( final int targetOffset, final String methodName, 
final int paramCount, final Class[] paramTypes )
 {
@@ -258,7 +258,7 @@ public class CallMethodRule
  * @param paramCount The number of parameters to collect, or zero for a 
single argument from the body of the element
  * @param paramTypes The Java classes that represent the parameter types 
of the method arguments (if you wish to use
  *a primitive type, specify the corresponding Java wrapper 
class instead, such as
- *{@link java.lang.Boolean#TYPE} for a {@code boolean} 
parameter)
+ *{@link Boolean#TYPE} for a {@code boolean} parameter)
  */
 public CallMethodRule( final String methodName, final int paramCount, 
final Class paramTypes[] )
 {
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/CallMethodBuilder.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/CallMethodBuilder.java
index 4b42ee57..54743441 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/CallMethodBuilder.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/CallMethodBuilder.java
@@ -126,7 +126,7 @@ public final class CallMethodBuilder
  * Sets the Java classes that represent the parameter types of the method 
arguments.
  *
  * If you wish to use a primitive type, specify the corresonding Java 
wrapper class instead,
- * such as {@link java.lang.Boolean#TYPE} for a {@code boolean} parameter.
+ * such as {@link Boolean#TYPE} for a {@code boolean} parameter.
  *
  * @param paramTypes The Java classes that represent the parameter types 
of the method arguments
  * @return this builder instance
@@ -151,7 +151,7 @@ public final class CallMethodBuilder
  * Sets the Java class names that represent the parameter types of the 
method arguments.
  *
  * If you wish to use a primitive type, specify the corresonding Java 
wrapper class instead,
- * such as {@link java.lang.Boolean#TYPE} for a {@code boolean} parameter.
+ * such as {@link Boolean#TYPE} for a {@code boolean} parameter.
  *
  * @param paramTypeNames The Java classes names that represent the 
parameter types of the method arguments
  * @return this builder instance

(commons-digester) branch master updated: Javadoc

[ggregory]

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


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

commit d3d807d1e2be8678d1d9a7612fa584cdb46c9782
Author: Gary Gregory 
AuthorDate: Sat May 18 10:07:00 2024 -0400

Javadoc
---
 .../src/main/java/org/apache/commons/digester3/SimpleRegexMatcher.java  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/SimpleRegexMatcher.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/SimpleRegexMatcher.java
index 590e28a7..57aa8d83 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/SimpleRegexMatcher.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/SimpleRegexMatcher.java
@@ -74,7 +74,7 @@ public class SimpleRegexMatcher
 }
 
 /**
- * Implementation of regex matching algorithm. This calls itself 
recursively.
+ * Implements a regex matching algorithm. This calls itself recursively.
  *
  * @param basePattern the standard digester path representing the element
  * @param regexPattern the regex pattern the path will be tested against

(commons-digester) branch master updated: Javadoc

[ggregory]

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


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

commit b453223c1bb8abe240be062110f8dfa663568e22
Author: Gary Gregory 
AuthorDate: Sat May 18 09:47:57 2024 -0400

Javadoc
---
 .../src/main/java/org/apache/commons/digester3/rss/RSSDigester.java   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git 
a/commons-digester3-examples/rss/src/main/java/org/apache/commons/digester3/rss/RSSDigester.java
 
b/commons-digester3-examples/rss/src/main/java/org/apache/commons/digester3/rss/RSSDigester.java
index a3f7bb9f..4aeb8c04 100644
--- 
a/commons-digester3-examples/rss/src/main/java/org/apache/commons/digester3/rss/RSSDigester.java
+++ 
b/commons-digester3-examples/rss/src/main/java/org/apache/commons/digester3/rss/RSSDigester.java
@@ -27,8 +27,8 @@ import org.xml.sax.InputSource;
 import org.xml.sax.SAXException;
 
 /**
- * Implementation of org.apache.commons.digester3.Digester
- * designed to process input streams that conform to the Rich Site
+ * Implements {@link Digester}
+ * to process input streams that conform to the Rich Site
  * Summary DTD, version 0.91.  For more information about this format,
  * see the http://my.netscape.com/publish/";>My Netscape site.
  *

(commons-digester) branch master updated: Javadoc

[ggregory]

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


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

commit 89e0e1597dc7a51c90115a4ad13e05e6cde61c7d
Author: Gary Gregory 
AuthorDate: Wed Jan 17 10:33:10 2024 -0500

Javadoc
---
 .../org/apache/commons/digester3/Digester.java | 44 +++---
 .../commons/digester3/FactoryCreateRule.java   |  2 +-
 .../java/org/apache/commons/digester3/Rule.java|  4 +-
 .../java/org/apache/commons/digester3/RuleSet.java |  2 +-
 .../java/org/apache/commons/digester3/Rules.java   |  8 ++--
 .../commons/digester3/SetNestedPropertiesRule.java |  4 +-
 .../commons/digester3/binder/DigesterLoader.java   |  4 +-
 .../commons/digester3/plugins/Declaration.java |  4 +-
 .../commons/digester3/plugins/PluginContext.java   |  2 +-
 .../digester3/plugins/PluginCreateRule.java|  2 +-
 .../commons/digester3/plugins/PluginManager.java   |  4 +-
 .../commons/digester3/plugins/PluginRules.java | 12 +++---
 .../java/org/apache/commons/digester3/Box.java |  2 +-
 .../commons/digester3/CallMethodRuleTestCase.java  |  2 +-
 .../digester3/NamespaceSnapshotTestCase.java   |  2 +-
 .../commons/digester3/NodeCreateRuleTestCase.java  |  2 +-
 .../org/apache/commons/digester3/RuleTestCase.java |  2 +-
 .../apache/commons/digester3/XIncludeTestCase.java |  2 +-
 .../commons/digester3/XMLSchemaTestCase.java   |  2 +-
 .../apache/commons/digester3/plugins/Utils.java|  2 +-
 .../org/apache/commons/digester3/rss/Channel.java  | 12 +++---
 21 files changed, 60 insertions(+), 60 deletions(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/Digester.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/Digester.java
index 0acf1c55..c9e50111 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/Digester.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/Digester.java
@@ -1537,7 +1537,7 @@ public class Digester
 }
 
 /**
- * Return the class loader to be used for instantiating application 
objects when required. This is determined based
+ * Gets the class loader to be used for instantiating application objects 
when required. This is determined based
  * upon the following rules:
  * 
  * The class loader set by {@code setClassLoader()}, if any
@@ -1568,7 +1568,7 @@ public class Digester
 // --- Public Methods
 
 /**
- * Return the current depth of the element stack.
+ * Gets the current depth of the element stack.
  *
  * @return the current depth of the element stack.
  */
@@ -1578,7 +1578,7 @@ public class Digester
 }
 
 /**
- * Return the name of the XML element that is currently being processed.
+ * Gets the name of the XML element that is currently being processed.
  *
  * @return the name of the XML element that is currently being processed.
  */
@@ -1646,7 +1646,7 @@ public class Digester
 }
 
 /**
- * Return the Entity Resolver used by the SAX parser.
+ * Gets the Entity Resolver used by the SAX parser.
  *
  * @return the Entity Resolver used by the SAX parser.
  */
@@ -1656,7 +1656,7 @@ public class Digester
 }
 
 /**
- * Return the error handler for this Digester.
+ * Gets the error handler for this Digester.
  *
  * @return the error handler for this Digester.
  */
@@ -1677,7 +1677,7 @@ public class Digester
 }
 
 /**
- * Return the SAXParserFactory we will use, creating one if necessary.
+ * Gets the SAXParserFactory we will use, creating one if necessary.
  *
  * @return the SAXParserFactory we will use, creating one if necessary.
  */
@@ -1713,7 +1713,7 @@ public class Digester
 }
 
 /**
- * Return the current Logger associated with this instance of the Digester
+ * Gets the current Logger associated with this instance of the Digester
  *
  * @return the current Logger associated with this instance of the Digester
  */
@@ -1723,7 +1723,7 @@ public class Digester
 }
 
 /**
- * Return the current rule match path
+ * Gets the current rule match path
  *
  * @return the current rule match path
  */
@@ -1733,7 +1733,7 @@ public class Digester
 }
 
 /**
- * Return a Stack whose elements are List objects, each containing a list 
of
+ * Gets a Stack whose elements are List objects, each containing a list of
  * Rule objects as returned from Rules.getMatch().
  *
  * @return a Stack whose elements are List objects, each containing a list 
of
@@ -1746,7 +1746,7 @@ public class Digester
 }
 
 /**
- * Return the "namespace aware" f

(commons-digester) branch master updated: Javadoc and comments: Use an HTTPS URL

[ggregory]

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


The following commit(s) were added to refs/heads/master by this push:
 new 5e0137bf Javadoc and comments: Use an HTTPS URL
5e0137bf is described below

commit 5e0137bf2ba4f64829e5ff91dc8718022a835e5a
Author: Gary Gregory 
AuthorDate: Sun Jan 14 11:01:11 2024 -0500

Javadoc and comments: Use an HTTPS URL
---
 .../java/org/apache/commons/digester3/binder/AbstractRulesModule.java   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/AbstractRulesModule.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/AbstractRulesModule.java
index 257f0ffe..1137eaa6 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/AbstractRulesModule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/AbstractRulesModule.java
@@ -36,7 +36,7 @@ public abstract class AbstractRulesModule
  * Uses {@link String#format(String, Object...)} to insert the arguments 
into the message.
  *
  * @param messagePattern A
- *http://download.oracle.com/javase/6/docs/api/java/util/Formatter.html#syntax";>format
 string
+ *https://download.oracle.com/javase/6/docs/api/java/util/Formatter.html#syntax";>format
 string
  * @param arguments Arguments referenced by the format specifiers in the 
format string
  * @see RulesBinder#addError(String, Object...)
  */

(commons-digester) branch master updated: Javadoc

[ggregory]

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


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

commit 8b93e688af76de46042c6f417f807e5388e93de0
Author: Gary Gregory 
AuthorDate: Sun Dec 17 14:33:52 2023 -0500

Javadoc
---
 .../org/apache/commons/digester3/CallMethodRule.java |  4 ++--
 .../commons/digester3/binder/CallMethodBuilder.java  |  4 ++--
 .../commons/digester3/xmlrules/FromXmlRulesModule.java   | 16 
 3 files changed, 12 insertions(+), 12 deletions(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
index 99b08dfa..4a418694 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
@@ -180,7 +180,7 @@ public class CallMethodRule
  * @param paramCount The number of parameters to collect, or zero for a 
single argument from the body of the element
  * @param paramTypes The Java classes that represent the parameter types 
of the method arguments (if you wish to use
  *a primitive type, specify the corresponding Java wrapper 
class instead, such as
- *{@code java.lang.Boolean.TYPE} for a {@code boolean} 
parameter)
+ *{@link java.lang.Boolean#TYPE} for a {@code boolean} 
parameter)
  */
 public CallMethodRule( final int targetOffset, final String methodName, 
final int paramCount, final Class[] paramTypes )
 {
@@ -262,7 +262,7 @@ public class CallMethodRule
  * @param paramCount The number of parameters to collect, or zero for a 
single argument from the body of the element
  * @param paramTypes The Java classes that represent the parameter types 
of the method arguments (if you wish to use
  *a primitive type, specify the corresponding Java wrapper 
class instead, such as
- *{@code java.lang.Boolean.TYPE} for a {@code boolean} 
parameter)
+ *{@link java.lang.Boolean#TYPE} for a {@code boolean} 
parameter)
  */
 public CallMethodRule( final String methodName, final int paramCount, 
final Class paramTypes[] )
 {
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/CallMethodBuilder.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/CallMethodBuilder.java
index 676b00c4..4b42ee57 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/CallMethodBuilder.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/CallMethodBuilder.java
@@ -126,7 +126,7 @@ public final class CallMethodBuilder
  * Sets the Java classes that represent the parameter types of the method 
arguments.
  *
  * If you wish to use a primitive type, specify the corresonding Java 
wrapper class instead,
- * such as {@code java.lang.Boolean.TYPE} for a {@code boolean} parameter.
+ * such as {@link java.lang.Boolean#TYPE} for a {@code boolean} parameter.
  *
  * @param paramTypes The Java classes that represent the parameter types 
of the method arguments
  * @return this builder instance
@@ -151,7 +151,7 @@ public final class CallMethodBuilder
  * Sets the Java class names that represent the parameter types of the 
method arguments.
  *
  * If you wish to use a primitive type, specify the corresonding Java 
wrapper class instead,
- * such as {@code java.lang.Boolean.TYPE} for a {@code boolean} parameter.
+ * such as {@link java.lang.Boolean#TYPE} for a {@code boolean} parameter.
  *
  * @param paramTypeNames The Java classes names that represent the 
parameter types of the method arguments
  * @return this builder instance
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/xmlrules/FromXmlRulesModule.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/xmlrules/FromXmlRulesModule.java
index 8a95f7d4..e04f86fb 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/xmlrules/FromXmlRulesModule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/xmlrules/FromXmlRulesModule.java
@@ -93,9 +93,9 @@ public abstract class FromXmlRulesModule
 protected abstract void loadRules();
 
 /**
- * Opens a new {@code org.xml.sax.InputSource} given a {@code 
java.io.File}.
+ * Opens a new {@code org.xml.sax.InputSource} given a {@link 
java.io.File}.
  *
- * @param file The {@code java.io.File} where reading the XML rules from.
+ * @param file The {@link java.io.File} where reading the XML rules from.
   

(commons-digester) branch master updated: Javadoc

[ggregory]

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


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

commit 135e82165ef88605251dfe4b7003d5b2aa0c64d9
Author: Gary Gregory 
AuthorDate: Thu Dec 14 13:52:37 2023 -0500

Javadoc
---
 .../org/apache/commons/digester3/plugins/PluginDeclarationRule.java | 2 +-
 .../org/apache/commons/digester3/examples/api/addressbook/Person.java   | 2 +-
 .../apache/commons/digester3/examples/xmlrules/addressbook/Person.java  | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/PluginDeclarationRule.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/PluginDeclarationRule.java
index 8e894d7c..11c4d56b 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/PluginDeclarationRule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/PluginDeclarationRule.java
@@ -81,7 +81,7 @@ public class PluginDeclarationRule
 
 // --- methods 
 
-/** constructor */
+/** Constructor */
 public PluginDeclarationRule()
 {
 }
diff --git 
a/commons-digester3-examples/api/addressbook/src/main/java/org/apache/commons/digester3/examples/api/addressbook/Person.java
 
b/commons-digester3-examples/api/addressbook/src/main/java/org/apache/commons/digester3/examples/api/addressbook/Person.java
index e399cef1..9ec40c01 100644
--- 
a/commons-digester3-examples/api/addressbook/src/main/java/org/apache/commons/digester3/examples/api/addressbook/Person.java
+++ 
b/commons-digester3-examples/api/addressbook/src/main/java/org/apache/commons/digester3/examples/api/addressbook/Person.java
@@ -42,7 +42,7 @@ public class Person
 addresses.add( addr );
 }
 
-/** we assume only one email of each type... */
+/** We assume only one email of each type... */
 public void addEmail( final String type, final String address )
 {
 emails.put( type, address );
diff --git 
a/commons-digester3-examples/xmlrules/addressbook/src/main/java/org/apache/commons/digester3/examples/xmlrules/addressbook/Person.java
 
b/commons-digester3-examples/xmlrules/addressbook/src/main/java/org/apache/commons/digester3/examples/xmlrules/addressbook/Person.java
index 10089d9e..30a8b434 100644
--- 
a/commons-digester3-examples/xmlrules/addressbook/src/main/java/org/apache/commons/digester3/examples/xmlrules/addressbook/Person.java
+++ 
b/commons-digester3-examples/xmlrules/addressbook/src/main/java/org/apache/commons/digester3/examples/xmlrules/addressbook/Person.java
@@ -42,7 +42,7 @@ public class Person
 addresses.add( addr );
 }
 
-/** we assume only one email of each type... */
+/** We assume only one email of each type... */
 public void addEmail( final String type, final String address )
 {
 emails.put( type, address );

(commons-digester) branch master updated: Javadoc

[ggregory]

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


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

commit 6b23415e7f3e6c1e74a9e3c187175b4d159cc533
Author: Gary Gregory 
AuthorDate: Thu Dec 14 10:26:37 2023 -0500

Javadoc
---
 .../main/java/org/apache/commons/digester3/plugins/PluginManager.java   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/PluginManager.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/PluginManager.java
index 59c2805b..b2f735d9 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/PluginManager.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/PluginManager.java
@@ -44,7 +44,7 @@ public class PluginManager
 /** Map of id->Declaration */
 private final HashMap declarationsById = new 
HashMap();
 
-/** the parent manager to which this one may delegate lookups. */
+/** The parent manager to which this one may delegate lookups. */
 private PluginManager parent;
 
 /**

(commons-digester) branch master updated: Javadoc

[ggregory]

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


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

commit 1f7843f3c2759bc6781d853bfc23fb38c32c3924
Author: Gary Gregory 
AuthorDate: Thu Dec 14 09:46:01 2023 -0500

Javadoc
---
 .../main/java/org/apache/commons/digester3/NodeCreateRule.java| 8 
 .../java/org/apache/commons/digester3/plugins/Declaration.java| 4 ++--
 .../commons/digester3/plugins/strategies/FinderFromMethod.java| 2 +-
 .../commons/digester3/plugins/strategies/FinderFromResource.java  | 2 +-
 .../commons/digester3/plugins/strategies/LoaderFromClass.java | 4 ++--
 5 files changed, 10 insertions(+), 10 deletions(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/NodeCreateRule.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/NodeCreateRule.java
index 30f8cd5b..7dc36c75 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/NodeCreateRule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/NodeCreateRule.java
@@ -109,7 +109,7 @@ public class NodeCreateRule
 protected StringBuilder topText = new StringBuilder();
 
 /**
- * Constructor.
+ * Constructs a new instance.
  * 
  * Stores the content handler currently used by Digester so it can be 
reset when done, and initializes the DOM
  * objects needed to build the node.
@@ -323,7 +323,7 @@ public class NodeCreateRule
 }
 
 /**
- * Constructor. Creates an instance of this rule that will create a DOM 
{@link org.w3c.dom.Element Element}, but
+ * Constructs a new instance. Creates an instance of this rule that will 
create a DOM {@link org.w3c.dom.Element Element}, but
  * lets you specify the JAXP {@code DocumentBuilder} that should be used 
when constructing the node tree.
  *
  * @param documentBuilder the JAXP {@code DocumentBuilder} to use
@@ -336,7 +336,7 @@ public class NodeCreateRule
 // - Instance Variables
 
 /**
- * Constructor. Creates an instance of this rule that will create either a 
DOM {@link org.w3c.dom.Element Element}
+ * Constructs a new instance. Creates an instance of this rule that will 
create either a DOM {@link org.w3c.dom.Element Element}
  * or a DOM {@link org.w3c.dom.DocumentFragment DocumentFragment}, 
depending on the value of the
  * {@code nodeType} parameter.
  *
@@ -353,7 +353,7 @@ public class NodeCreateRule
 }
 
 /**
- * Constructor. Creates an instance of this rule that will create either a 
DOM {@link org.w3c.dom.Element Element}
+ * Constructs a new instance. Creates an instance of this rule that will 
create either a DOM {@link org.w3c.dom.Element Element}
  * or a DOM {@link org.w3c.dom.DocumentFragment DocumentFragment}, 
depending on the value of the
  * {@code nodeType} parameter. This constructor lets you specify the JAXP 
{@code DocumentBuilder} that
  * should be used when constructing the node tree.
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/Declaration.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/Declaration.java
index 2601a2d4..e7604a1f 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/Declaration.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/Declaration.java
@@ -56,7 +56,7 @@ public class Declaration
 // -- constructors --
 
 /**
- * Constructor.
+ * Constructs a new instance.
  *
  * @param pluginClass The class of the object to be instantiated (will be 
load in the init method)
  */
@@ -81,7 +81,7 @@ public class Declaration
 }
 
 /**
- * Constructor.
+ * Constructs a new instance.
  *
  * @param pluginClassName The name of the class of the object to be 
instantiated (will be load in the init method)
  */
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/strategies/FinderFromMethod.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/strategies/FinderFromMethod.java
index c0eab3c4..e6581600 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/strategies/FinderFromMethod.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/strategies/FinderFromMethod.java
@@ -45,7 +45,7 @@ public class FinderFromMethod
 /** See {@link #findLoader}. */
 private final String methodAttr;
 
-/** Constructor. */
+/** Constructs a new instance. */
 public FinderFromMethod()

(commons-digester) branch master updated: Javadoc: Remove redundant "java.lang" prefix

[ggregory]

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


The following commit(s) were added to refs/heads/master by this push:
 new eb1d9f33 Javadoc: Remove redundant "java.lang" prefix
eb1d9f33 is described below

commit eb1d9f33d00be61362ebd51dde025e0893bfa2a7
Author: Gary Gregory 
AuthorDate: Sat Dec 9 10:06:21 2023 -0500

Javadoc: Remove redundant "java.lang" prefix
---
 .../java/org/apache/commons/digester3/binder/AbstractRulesModule.java   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/AbstractRulesModule.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/AbstractRulesModule.java
index 1e8b46cf..257f0ffe 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/AbstractRulesModule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/AbstractRulesModule.java
@@ -33,7 +33,7 @@ public abstract class AbstractRulesModule
 /**
  * Records an error message which will be presented to the user at a later 
time.
  *
- * Uses {@link java.lang.String#format(String, Object...)} to insert the 
arguments into the message.
+ * Uses {@link String#format(String, Object...)} to insert the arguments 
into the message.
  *
  * @param messagePattern A
  *http://download.oracle.com/javase/6/docs/api/java/util/Formatter.html#syntax";>format
 string

(commons-digester) branch master updated: Javadoc spelling

[ggregory]

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


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

commit 571762dcf834f52e14588da38a8b735f7b517014
Author: Gary Gregory 
AuthorDate: Sun Nov 26 15:51:02 2023 -0500

Javadoc spelling
---
 .../java/org/apache/commons/digester3/SetNestedPropertiesRule.java  | 6 +++---
 .../java/org/apache/commons/digester3/binder/AddAliasBuilder.java   | 2 +-
 .../apache/commons/digester3/binder/NestedPropertiesBuilder.java| 2 +-
 .../org/apache/commons/digester3/binder/ObjectCreateBuilder.java| 2 +-
 .../org/apache/commons/digester3/binder/SetPropertiesBuilder.java   | 2 +-
 .../apache/commons/digester3/plugins/PluginAssertionFailure.java| 4 ++--
 .../commons/digester3/plugins/strategies/FinderSetProperties.java   | 2 +-
 .../apache/commons/digester3/SetNestedPropertiesRuleTestCase.java   | 2 +-
 .../org/apache/commons/digester3/examples/api/addressbook/Main.java | 2 +-
 .../org/apache/commons/digester3/examples/api/catalog/Main.java | 2 +-
 .../org/apache/commons/digester3/examples/api/dbinsert/Row.java | 2 +-
 .../commons/digester3/examples/xmlrules/addressbook/Main.java   | 2 +-
 12 files changed, 15 insertions(+), 15 deletions(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/SetNestedPropertiesRule.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/SetNestedPropertiesRule.java
index c684b888..c22dc7ad 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/SetNestedPropertiesRule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/SetNestedPropertiesRule.java
@@ -331,7 +331,7 @@ public class SetNestedPropertiesRule
 /**
  * Base constructor, which maps every child element into a bean property 
with the same name as the xml element.
  * 
- * It is an error if a child xml element exists but the target java bean 
has no such property (unless
+ * It is an error if a child xml element exists but the target Java bean 
has no such property (unless
  * {@link #setAllowUnknownChildElements(boolean)} has been set to true).
  * 
  */
@@ -366,7 +366,7 @@ public class SetNestedPropertiesRule
  * 
  *
  * @param elementName is the child xml element to match
- * @param propertyName is the java bean property to be assigned the value 
of the specified xml element. This may be
+ * @param propertyName is the Java bean property to be assigned the value 
of the specified xml element. This may be
  *null, in which case the specified xml element will be 
ignored.
  */
 public SetNestedPropertiesRule( final String elementName, final String 
propertyName )
@@ -379,7 +379,7 @@ public class SetNestedPropertiesRule
  * Constructor which allows element->property mapping to be overridden.
  * 
  * 
- * Two arrays are passed in. One contains xml element names and the other 
java bean property names. The element name
+ * Two arrays are passed in. One contains xml element names and the other 
Java bean property names. The element name
  * / property name pairs are matched by position; in order words, the 
first string in the element name array
  * corresponds to the first string in the property name array and so on.
  * 
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/AddAliasBuilder.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/AddAliasBuilder.java
index 6d0881d2..9c04b2d1 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/AddAliasBuilder.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/AddAliasBuilder.java
@@ -44,7 +44,7 @@ public final class AddAliasBuilder
 /**
  * Allows expressing the input property name alias.
  *
- * @param propertyName The java bean property to be assigned the value
+ * @param propertyName The Java bean property to be assigned the value
  * @return the parent builder to chain.
  */
 public B forProperty( /*@Nullable*/ final String propertyName )
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/NestedPropertiesBuilder.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/NestedPropertiesBuilder.java
index ab12445f..77d34d1b 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/NestedPropertiesBuilder.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/binder/NestedPropertiesBuilder.java
@@ -65,7 +65,7 @@ public final class NestedPropertiesBuilder
  * Allows element2property mapping to be overridden.
  *
  * @param el

(commons-digester) branch master updated: Javadoc

[ggregory]

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


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

commit 56ee149d2e4403c54528fba343add8be15922d32
Author: Gary Gregory 
AuthorDate: Sat Nov 11 16:13:41 2023 -0500

Javadoc
---
 .../apache/commons/digester3/AbstractMethodRule.java |  6 +++---
 .../commons/digester3/BeanPropertySetterRule.java|  4 ++--
 .../org/apache/commons/digester3/CallMethodRule.java | 16 
 .../org/apache/commons/digester3/CallParamRule.java  |  6 +++---
 .../java/org/apache/commons/digester3/Digester.java  |  6 +++---
 .../apache/commons/digester3/FactoryCreateRule.java  | 20 ++--
 .../apache/commons/digester3/ObjectCreateRule.java   |  8 
 .../apache/commons/digester3/ObjectParamRule.java|  4 ++--
 .../apache/commons/digester3/PathCallParamRule.java  |  2 +-
 .../org/apache/commons/digester3/RegexRules.java |  2 +-
 .../org/apache/commons/digester3/SetNextRule.java|  6 +++---
 .../apache/commons/digester3/SetPropertyRule.java|  2 +-
 .../org/apache/commons/digester3/SetRootRule.java|  6 +++---
 .../org/apache/commons/digester3/SetTopRule.java |  6 +++---
 .../digester3/binder/FactoryCreateBuilder.java   |  6 +++---
 .../commons/digester3/binder/LinkedRuleBuilder.java  |  6 +++---
 .../digester3/binder/ObjectCreateBuilder.java|  4 ++--
 .../commons/digester3/plugins/PluginManager.java |  4 ++--
 .../org/apache/commons/digester3/TestRuleSet.java|  6 +++---
 19 files changed, 60 insertions(+), 60 deletions(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/AbstractMethodRule.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/AbstractMethodRule.java
index 6e9b44be..94c651cd 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/AbstractMethodRule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/AbstractMethodRule.java
@@ -62,7 +62,7 @@ public abstract class AbstractMethodRule
 protected boolean fireOnBegin;
 
 /**
- * Construct a "set next" rule with the specified method name. The 
method's argument type is assumed to be the class
+ * Constructs a "set next" rule with the specified method name. The 
method's argument type is assumed to be the class
  * of the child object.
  *
  * @param methodName Method name of the parent method to call
@@ -73,7 +73,7 @@ public abstract class AbstractMethodRule
 }
 
 /**
- * Construct a "set next" rule with the specified method name.
+ * Constructs a "set next" rule with the specified method name.
  *
  * @param methodName Method name of the parent method to call
  * @param paramType Java class of the parent method's argument (if you 
wish to use a primitive type, specify the
@@ -87,7 +87,7 @@ public abstract class AbstractMethodRule
 }
 
 /**
- * Construct a "set next" rule with the specified method name.
+ * Constructs a "set next" rule with the specified method name.
  *
  * @param methodName Method name of the parent method to call
  * @param paramTypeName Java class of the parent method's argument (if you 
wish to use a primitive type, specify the
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/BeanPropertySetterRule.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/BeanPropertySetterRule.java
index cec63257..a76171a7 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/BeanPropertySetterRule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/BeanPropertySetterRule.java
@@ -70,7 +70,7 @@ public class BeanPropertySetterRule
 
 /**
  * 
- * Construct rule that automatically sets a property from the body text.
+ * Constructs rule that automatically sets a property from the body text.
  * 
  * This construct creates a rule that sets the property on the top object 
named the same as the current element.
  */
@@ -81,7 +81,7 @@ public class BeanPropertySetterRule
 
 /**
  * 
- * Construct rule that sets the given property from the body text.
+ * Constructs rule that sets the given property from the body text.
  * 
  *
  * @param propertyName name of property to set
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
index 606f7083..49b5d2db 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/CallMethodRule.java
@@ -127,7 +127,7 @@ public class CallMeth

[commons-digester] branch master updated: Javadoc

[ggregory]

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


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

commit 31db02fe6b0469c0fa0309d88f7cadd5d908bb1e
Author: Gary Gregory 
AuthorDate: Thu Oct 19 07:32:06 2023 -0400

Javadoc
---
 .../main/java/org/apache/commons/digester3/plugins/PluginManager.java   | 2 +-
 .../apache/commons/digester3/plugins/strategies/FinderFromClass.java| 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/PluginManager.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/PluginManager.java
index 35a20763..bf7b91d8 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/PluginManager.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/PluginManager.java
@@ -38,7 +38,7 @@ import org.apache.commons.logging.Log;
 public class PluginManager
 {
 
-/** Map of classname->Declaration */
+/** Map of class name->Declaration */
 private final HashMap declarationsByClass = new 
HashMap();
 
 /** Map of id->Declaration */
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/strategies/FinderFromClass.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/strategies/FinderFromClass.java
index 85719645..90ce5617 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/strategies/FinderFromClass.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/strategies/FinderFromClass.java
@@ -27,7 +27,7 @@ import org.apache.commons.digester3.plugins.RuleFinder;
 import org.apache.commons.digester3.plugins.RuleLoader;
 
 /**
- * A rule-finding algorithm which expects the caller to specify a classname 
and methodname as plugin properties.
+ * A rule-finding algorithm which expects the caller to specify a class name 
and methodname as plugin properties.
  *
  * @since 1.6
  */

[commons-digester] branch master updated: Javadoc: Convert package.html to package-info.java

[ggregory]

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


The following commit(s) were added to refs/heads/master by this push:
 new 109de0f2 Javadoc: Convert package.html to package-info.java
109de0f2 is described below

commit 109de0f24053e8e600f55bd04fc1419cd158f21e
Author: Gary Gregory 
AuthorDate: Sun Mar 19 16:01:48 2023 -0400

Javadoc: Convert package.html to package-info.java
---
 .../apache/commons/digester3/rss/package-info.java | 21 ++
 .../org/apache/commons/digester3/rss/package.html  | 25 --
 2 files changed, 21 insertions(+), 25 deletions(-)

diff --git 
a/examples/rss/src/main/resources/org/apache/commons/digester3/rss/package-info.java
 
b/examples/rss/src/main/resources/org/apache/commons/digester3/rss/package-info.java
new file mode 100644
index ..9c8180e1
--- /dev/null
+++ 
b/examples/rss/src/main/resources/org/apache/commons/digester3/rss/package-info.java
@@ -0,0 +1,21 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * Example usage of Digester to parse XML documents compatible with the 
Rich Site Summary format used by many newsfeeds.
+ */
+package org.apache.commons.digester3.rss;
diff --git 
a/examples/rss/src/main/resources/org/apache/commons/digester3/rss/package.html 
b/examples/rss/src/main/resources/org/apache/commons/digester3/rss/package.html
deleted file mode 100644
index 57351e49..
--- 
a/examples/rss/src/main/resources/org/apache/commons/digester3/rss/package.html
+++ /dev/null
@@ -1,25 +0,0 @@
-
-
-
-Package Documentation for org.apache.commons.digester.rss 
Package
-
-
-Example usage of Digester to parse XML documents compatible with the
-Rich Site Summary format used by many newsfeeds.
-
-

[commons-digester] branch master updated: Javadoc @see tags do not need to use a FQCN for classes in java.lang

[ggregory]

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


The following commit(s) were added to refs/heads/master by this push:
 new 717a9536 Javadoc @see tags do not need to use a FQCN for classes in 
java.lang
717a9536 is described below

commit 717a953621492ddd1124d1e002aafbbb1da0ea38
Author: Gary Gregory 
AuthorDate: Mon Aug 29 07:12:05 2022 -0400

Javadoc @see tags do not need to use a FQCN for classes in java.lang
---
 .../substitution/CompoundSubstitutorTestCase.java  | 338 ++---
 1 file changed, 169 insertions(+), 169 deletions(-)

diff --git 
a/core/src/test/java/org/apache/commons/digester3/substitution/CompoundSubstitutorTestCase.java
 
b/core/src/test/java/org/apache/commons/digester3/substitution/CompoundSubstitutorTestCase.java
index 74743e77..8f06d016 100644
--- 
a/core/src/test/java/org/apache/commons/digester3/substitution/CompoundSubstitutorTestCase.java
+++ 
b/core/src/test/java/org/apache/commons/digester3/substitution/CompoundSubstitutorTestCase.java
@@ -1,169 +1,169 @@
-package org.apache.commons.digester3.substitution;
-
-/*
- * Licensed to the Apache Software Foundation (ASF) under one
- * or more contributor license agreements.  See the NOTICE file
- * distributed with this work for additional information
- * regarding copyright ownership.  The ASF licenses this file
- * to you under the Apache License, Version 2.0 (the
- * "License"); you may not use this file except in compliance
- * with the License.  You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-import static org.junit.Assert.assertEquals;
-import static org.junit.Assert.assertTrue;
-import static org.junit.Assert.fail;
-
-import org.apache.commons.digester3.Substitutor;
-import org.junit.Before;
-import org.junit.Test;
-import org.xml.sax.Attributes;
-import org.xml.sax.helpers.AttributesImpl;
-
-public final class CompoundSubstitutorTestCase
-{
-
-
-private static class SubstitutorStub
-extends Substitutor
-{
-
-private final String newBodyText;
-
-private final String uri;
-
-private final String localName;
-
-private final String type;
-
-private final String value;
-
-public SubstitutorStub( final String bodyText, final String uri, final 
String localName, final String type, final String value )
-{
-this.newBodyText = bodyText;
-this.uri = uri;
-this.localName = localName;
-this.type = type;
-this.value = value;
-}
-
-/**
- * @see 
org.apache.commons.digester3.Substitutor#substitute(org.xml.sax.Attributes)
- */
-@Override
-public Attributes substitute( final Attributes attributes )
-{
-final AttributesImpl attribs = new AttributesImpl( attributes );
-attribs.addAttribute( uri, localName, uri + ":" + localName, type, 
value );
-return attribs;
-}
-
-/**
- * @see 
org.apache.commons.digester3.Substitutor#substitute(java.lang.String)
- */
-@Override
-public String substitute( final String bodyText )
-{
-return newBodyText;
-}
-
-}
-
-private Attributes attrib;
-
-private String bodyText;
-
-@Before
-public void setUp()
-{
-final AttributesImpl aImpl = new AttributesImpl();
-aImpl.addAttribute( "", "b", ":b", "", "bcd" );
-aImpl.addAttribute( "", "c", ":c", "", "cde" );
-aImpl.addAttribute( "", "d", ":d", "", "def" );
-
-attrib = aImpl;
-bodyText = "Amazing Body Text!";
-}
-
-@Test
-public void testConstructors()
-{
-try
-{
-new CompoundSubstitutor( null, null );
-fail();
-}
-catch ( final IllegalArgumentException e )
-{
-// OK
-}
-
-final Substitutor a = new SubstitutorStub( "XYZ", "", "a", "", "abc" );
-
-try
-{
-new CompoundSubstitutor( a, null );
-fail();
-}
-catch ( final IllegalArgumentException e )
-{
-// OK
-}
-
-try
-{
-new CompoundSubstitutor( null, a );
-fail();
-}
-catch ( final IllegalArgumentException e )
-{
-// OK
-}
-}
-
-@Test
-public void testChaining()
-{
-final Substitutor a = new SubstitutorStub( "XYZ", "", "a", "", "

[commons-digester] branch master updated: Javadoc and don't use FQCN in throws clause.

[ggregory]

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


The following commit(s) were added to refs/heads/master by this push:
 new b366c248 Javadoc and don't use FQCN in throws clause.
b366c248 is described below

commit b366c248b1edb29f46e469d7a22246738150f882
Author: Gary Gregory 
AuthorDate: Sat May 21 14:57:44 2022 -0400

Javadoc and don't use FQCN in throws clause.
---
 .../java/org/apache/commons/digester3/examples/api/catalog/Main.java  | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git 
a/examples/api/catalog/src/main/java/org/apache/commons/digester3/examples/api/catalog/Main.java
 
b/examples/api/catalog/src/main/java/org/apache/commons/digester3/examples/api/catalog/Main.java
index c3fdac7f..5e942f79 100644
--- 
a/examples/api/catalog/src/main/java/org/apache/commons/digester3/examples/api/catalog/Main.java
+++ 
b/examples/api/catalog/src/main/java/org/apache/commons/digester3/examples/api/catalog/Main.java
@@ -1,5 +1,7 @@
 package org.apache.commons.digester3.examples.api.catalog;
 
+import java.io.IOException;
+
 /*
  * Licensed to the Apache Software Foundation (ASF) under one or more
  * contributor license agreements.  See the NOTICE file distributed with
@@ -202,7 +204,7 @@ public class Main
  * takes a File object would be more sensible (see AddressBook example).
  */
 private static java.io.Reader getInputData( final String filename )
-throws java.io.IOException
+throws IOException
 {
 final java.io.File srcfile = new java.io.File( filename );