This is an automated email from the ASF dual-hosted git repository.

garydgregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-digester.git


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

commit 6ea0e286f397abaea7bf002a8c8ee29edf03bb79
Author: Gary Gregory <[email protected]>
AuthorDate: Sun Aug 2 15:37:42 2026 -0400

    Javadoc
---
 .../commons/digester3/AbstractMethodRule.java      |  2 +-
 .../org/apache/commons/digester3/Digester.java     | 30 +++++++++++-----------
 .../commons/digester3/FactoryCreateRule.java       |  2 +-
 .../apache/commons/digester3/NodeCreateRule.java   | 10 ++++----
 .../java/org/apache/commons/digester3/Rule.java    |  8 +++---
 .../annotations/AnnotationHandlerFactory.java      |  2 +-
 .../digester3/plugins/PluginCreateRule.java        |  8 +++---
 .../digester3/plugins/PluginDeclarationRule.java   |  2 +-
 .../plugins/strategies/LoaderFromStream.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 +-
 .../annotations/AbstractAnnotatedPojoTestCase.java |  2 +-
 .../apache/commons/digester3/plugins/Utils.java    |  2 +-
 .../api/documentmarkup/MarkupDigester.java         |  6 ++---
 .../apache/commons/digester3/rss/RSSDigester.java  | 16 ++++++------
 19 files changed, 52 insertions(+), 52 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 8a9c26b0..f891b56b 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
@@ -137,7 +137,7 @@ public abstract class AbstractMethodRule
     /**
      * Just performs the method execution.
      *
-     * @throws Exception if any error occurs.
+     * @throws Exception Thrown if any error occurs.
      */
     private void invoke()
         throws Exception
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 7c3e5cf8..5aa17f36 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
@@ -1100,7 +1100,7 @@ public class Digester
      *
      * @param url URL for which to create an {@code InputSource}
      * @return The InputSource that reads from the input URL
-     * @throws IOException if any error occurs while reading the input URL
+     * @throws IOException Thrown if any error occurs while reading the input 
URL
      * @since 1.8
      */
     public InputSource createInputSourceFromURL( final String url )
@@ -1139,7 +1139,7 @@ public class Digester
      *
      * @param url The URL has to be read
      * @return The InputSource that reads from the input URL
-     * @throws IOException if any error occurs while reading the input URL
+     * @throws IOException Thrown if any error occurs while reading the input 
URL
      * @since 1.8
      */
     public InputSource createInputSourceFromURL( final URL url )
@@ -1852,7 +1852,7 @@ public class Digester
      * FIXME: there is a bug in JAXP/XERCES that prevent the use of a parser 
that contains a schema with a DTD.
      *
      * @return The XMLReader to be used for parsing the input document.
-     * @throws SAXException if no XMLReader can be instantiated
+     * @throws SAXException Thrown if no XMLReader can be instantiated
      */
     public XMLReader getXMLReader()
         throws SAXException
@@ -1999,8 +1999,8 @@ public class Digester
      * @param <T> The type used to auto-cast the returned object to the 
assigned variable type
      * @param file File containing the XML data to be parsed
      * @return The root element from the object stack (if any)
-     * @throws IOException if an input/output error occurs
-     * @throws SAXException if a parsing exception occurs
+     * @throws IOException Thrown if an input/output error occurs
+     * @throws SAXException Thrown if a parsing exception occurs
      */
     public <T> T parse( final File file )
         throws IOException, SAXException
@@ -2023,8 +2023,8 @@ public class Digester
      * @param <T> The type used to auto-cast the returned object to the 
assigned variable type
      * @param input Input source containing the XML data to be parsed
      * @return The root element from the object stack (if any)
-     * @throws IOException if an input/output error occurs
-     * @throws SAXException if a parsing exception occurs
+     * @throws IOException Thrown if an input/output error occurs
+     * @throws SAXException Thrown if a parsing exception occurs
      */
     public <T> T parse( final InputSource input )
         throws IOException, SAXException
@@ -2063,8 +2063,8 @@ public class Digester
      * @param <T> The type used to auto-cast the returned object to the 
assigned variable type
      * @param input Input stream containing the XML data to be parsed
      * @return The root element from the object stack (if any)
-     * @throws IOException if an input/output error occurs
-     * @throws SAXException if a parsing exception occurs
+     * @throws IOException Thrown if an input/output error occurs
+     * @throws SAXException Thrown if a parsing exception occurs
      */
     public <T> T parse( final InputStream input )
         throws IOException, SAXException
@@ -2084,8 +2084,8 @@ public class Digester
      * @param <T> The type used to auto-cast the returned object to the 
assigned variable type
      * @param reader Reader containing the XML data to be parsed
      * @return The root element from the object stack (if any)
-     * @throws IOException if an input/output error occurs
-     * @throws SAXException if a parsing exception occurs
+     * @throws IOException Thrown if an input/output error occurs
+     * @throws SAXException Thrown if a parsing exception occurs
      */
     public <T> T parse( final Reader reader )
         throws IOException, SAXException
@@ -2105,8 +2105,8 @@ public class Digester
      * @param <T> The type used to auto-cast the returned object to the 
assigned variable type
      * @param uri URI containing the XML data to be parsed
      * @return The root element from the object stack (if any)
-     * @throws IOException if an input/output error occurs
-     * @throws SAXException if a parsing exception occurs
+     * @throws IOException Thrown if an input/output error occurs
+     * @throws SAXException Thrown if a parsing exception occurs
      */
     public <T> T parse( final String uri )
         throws IOException, SAXException
@@ -2126,8 +2126,8 @@ public class Digester
      * @param <T> The type used to auto-cast the returned object to the 
assigned variable type
      * @param url URL containing the XML data to be parsed
      * @return The root element from the object stack (if any)
-     * @throws IOException if an input/output error occurs
-     * @throws SAXException if a parsing exception occurs
+     * @throws IOException Thrown if an input/output error occurs
+     * @throws SAXException Thrown if a parsing exception occurs
      * @since 1.8
      */
     public <T> T parse( final URL url )
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/FactoryCreateRule.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/FactoryCreateRule.java
index a475d6dd..41ddf1a7 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/FactoryCreateRule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/FactoryCreateRule.java
@@ -320,7 +320,7 @@ public class FactoryCreateRule
      *
      * @param attributes Attributes passed to our factory creation element
      * @return An instance of our associated object creation factory, creating 
one if necessary
-     * @throws Exception if any error occurs
+     * @throws Exception Thrown if any error occurs
      */
     protected ObjectCreationFactory<?> getFactory( final Attributes attributes 
)
         throws Exception
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 cfe046db..87bd7ef2 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
@@ -112,7 +112,7 @@ public class NodeCreateRule
          * @param doc The document to use to create nodes
          * @param root The root node
          * @throws ParserConfigurationException if the DocumentBuilderFactory 
could not be instantiated
-         * @throws SAXException if the XMLReader could not be instantiated by 
Digester (should not happen)
+         * @throws SAXException Thrown if the XMLReader could not be 
instantiated by Digester (should not happen)
          */
         NodeBuilder( final Document doc, final Node root )
             throws ParserConfigurationException, SAXException
@@ -171,7 +171,7 @@ public class NodeCreateRule
          * @param ch The characters from the XML document
          * @param start The start position in the array
          * @param length The number of characters to read from the array
-         * @throws SAXException if the DOM implementation throws an exception
+         * @throws SAXException Thrown if the DOM implementation throws an 
exception
          */
         @Override
         public void characters( final char[] ch, final int start, final int 
length )
@@ -186,7 +186,7 @@ public class NodeCreateRule
          * @param namespaceURI The namespace URI
          * @param localName The local name
          * @param qName The qualified (prefixed) name
-         * @throws SAXException if the DOM implementation throws an exception
+         * @throws SAXException Thrown if the DOM implementation throws an 
exception
          */
         @Override
         public void endElement( final String namespaceURI, final String 
localName, final String qName )
@@ -217,7 +217,7 @@ public class NodeCreateRule
          *
          * @param target The processing instruction target
          * @param data The processing instruction data, or null if none was 
supplied
-         * @throws SAXException if the DOM implementation throws an exception
+         * @throws SAXException Thrown if the DOM implementation throws an 
exception
          */
         @Override
         public void processingInstruction( final String target, final String 
data )
@@ -240,7 +240,7 @@ public class NodeCreateRule
          * @param localName The local name
          * @param qName The qualified (prefixed) name
          * @param atts The list of attributes
-         * @throws SAXException if the DOM implementation throws an exception
+         * @throws SAXException Thrown if the DOM implementation throws an 
exception
          */
         @Override
         public void startElement( final String namespaceURI, final String 
localName, final String qName, final Attributes atts )
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/Rule.java 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/Rule.java
index 329e3cbb..7767d62c 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/Rule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/Rule.java
@@ -69,7 +69,7 @@ import org.xml.sax.Attributes;
      *            aware or the element has no namespace
      * @param name The local name if the parser is namespace aware, or just 
the element name otherwise
      * @param attributes The attribute list of this element
-     * @throws Exception if any error occurs
+     * @throws Exception Thrown if any error occurs
      * @since 1.4
      */
     public void begin( final String namespace, final String name, final 
Attributes attributes )
@@ -86,7 +86,7 @@ import org.xml.sax.Attributes;
      *            aware or the element has no namespace
      * @param name The local name if the parser is namespace aware, or just 
the element name otherwise
      * @param text The text of the body of this element
-     * @throws Exception if any error occurs
+     * @throws Exception Thrown if any error occurs
      * @since 1.4
      */
     public void body( final String namespace, final String name, final String 
text )
@@ -101,7 +101,7 @@ import org.xml.sax.Attributes;
      * @param namespace The namespace URI of the matching element, or an empty 
string if the parser is not namespace
      *            aware or the element has no namespace
      * @param name The local name if the parser is namespace aware, or just 
the element name otherwise
-     * @throws Exception if any error occurs
+     * @throws Exception Thrown if any error occurs
      * @since 1.4
      */
     public void end( final String namespace, final String name )
@@ -113,7 +113,7 @@ import org.xml.sax.Attributes;
     /**
      * This method is called after all parsing methods have been called, to 
allow Rules to remove temporary data.
      *
-     * @throws Exception if any error occurs
+     * @throws Exception Thrown if any error occurs
      */
     public void finish()
         throws Exception
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/annotations/AnnotationHandlerFactory.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/annotations/AnnotationHandlerFactory.java
index a1739b44..70d33ebc 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/annotations/AnnotationHandlerFactory.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/annotations/AnnotationHandlerFactory.java
@@ -36,7 +36,7 @@ public interface AnnotationHandlerFactory
      * @param <H> The {@link AnnotationHandler} type has to be created
      * @param type The class of the object to be returned.
      * @return An instance of the specified class.
-     * @throws Exception if any error occurs while creating the {@link 
AnnotationHandler} instance.
+     * @throws Exception Thrown if any error occurs while creating the {@link 
AnnotationHandler} instance.
      */
     <H extends AnnotationHandler<? extends Annotation, ? extends 
AnnotatedElement>> H newInstance( Class<H> type )
         throws Exception;
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/PluginCreateRule.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/PluginCreateRule.java
index 6cb7bdba..2cc5b529 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/PluginCreateRule.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/PluginCreateRule.java
@@ -126,7 +126,7 @@ public class PluginCreateRule
      *            aware or the element has no namespace
      * @param name The local name if the parser is namespace aware, or just 
the element name otherwise
      * @param attributes The attribute list of this element
-     * @throws Exception if any error occurs
+     * @throws Exception Thrown if any error occurs
      */
     @Override
     public void begin( final String namespace, final String name, final 
Attributes attributes )
@@ -310,7 +310,7 @@ public class PluginCreateRule
      *            aware or the element has no namespace
      * @param name The local name if the parser is namespace aware, or just 
the element name otherwise
      * @param list The attribute list of this element
-     * @throws Exception if any error occurs
+     * @throws Exception Thrown if any error occurs
      */
     public void fireBeginMethods( final List<Rule> rules, final String 
namespace, final String name, final Attributes list )
         throws Exception
@@ -349,7 +349,7 @@ public class PluginCreateRule
      *            aware or the element has no namespace
      * @param name The local name if the parser is namespace aware, or just 
the element name otherwise
      * @param text The text of the body of this element
-     * @throws Exception if any error occurs
+     * @throws Exception Thrown if any error occurs
      */
     private void fireBodyMethods( final List<Rule> rules, final String 
namespaceURI, final String name, final String text )
         throws Exception
@@ -385,7 +385,7 @@ public class PluginCreateRule
      * @param namespaceURI The namespace URI of the matching element, or an 
empty string if the parser is not namespace
      *            aware or the element has no namespace
      * @param name The local name if the parser is namespace aware, or just 
the element name otherwise
-     * @throws Exception if any error occurs
+     * @throws Exception Thrown if any error occurs
      */
     public void fireEndMethods( final List<Rule> rules, final String 
namespaceURI, final String name )
         throws Exception
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 eef0ba25..c195a0f8 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
@@ -92,7 +92,7 @@ public class PluginDeclarationRule
      * @param namespace The XML namespace in which the XML element which 
triggered this rule resides.
      * @param name The name of the XML element which triggered this rule.
      * @param attributes The set of attributes on the XML element which 
triggered this rule.
-     * @throws Exception if any error occurs
+     * @throws Exception Thrown if any error occurs
      */
     @Override
     public void begin( final String namespace, final String name, final 
Attributes attributes )
diff --git 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/strategies/LoaderFromStream.java
 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/strategies/LoaderFromStream.java
index 59136052..bc864b54 100644
--- 
a/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/strategies/LoaderFromStream.java
+++ 
b/commons-digester3-core/src/main/java/org/apache/commons/digester3/plugins/strategies/LoaderFromStream.java
@@ -52,7 +52,7 @@ public class LoaderFromStream
      * The caller is responsible for closing the input stream after this 
method has returned.
      *
      * @param s The input stream has to be loaded into memory
-     * @throws Exception if any error occurs while reading the input stream
+     * @throws Exception Thrown if any error occurs while reading the input 
stream
      */
     public LoaderFromStream( final InputStream s )
         throws Exception
diff --git 
a/commons-digester3-core/src/test/java/org/apache/commons/digester3/CallMethodRuleTestCase.java
 
b/commons-digester3-core/src/test/java/org/apache/commons/digester3/CallMethodRuleTestCase.java
index 5906b697..f6700bde 100644
--- 
a/commons-digester3-core/src/test/java/org/apache/commons/digester3/CallMethodRuleTestCase.java
+++ 
b/commons-digester3-core/src/test/java/org/apache/commons/digester3/CallMethodRuleTestCase.java
@@ -50,7 +50,7 @@ public class CallMethodRuleTestCase
      * Gets an appropriate InputStream for the specified test file (which must 
be inside our current package.
      *
      * @param name Name of the test file we want
-     * @throws IOException if an input/output error occurs
+     * @throws IOException Thrown if an input/output error occurs
      */
     protected InputStream getInputStream( final String name )
     {
diff --git 
a/commons-digester3-core/src/test/java/org/apache/commons/digester3/NamespaceSnapshotTestCase.java
 
b/commons-digester3-core/src/test/java/org/apache/commons/digester3/NamespaceSnapshotTestCase.java
index 0a7be606..5e4ea1b8 100644
--- 
a/commons-digester3-core/src/test/java/org/apache/commons/digester3/NamespaceSnapshotTestCase.java
+++ 
b/commons-digester3-core/src/test/java/org/apache/commons/digester3/NamespaceSnapshotTestCase.java
@@ -72,7 +72,7 @@ public class NamespaceSnapshotTestCase
      * Gets an appropriate InputStream for the specified test file (which must 
be inside our current package.
      *
      * @param name Name of the test file we want
-     * @throws IOException if an input/output error occurs
+     * @throws IOException Thrown if an input/output error occurs
      */
     protected InputStream getInputStream( final String name )
     {
diff --git 
a/commons-digester3-core/src/test/java/org/apache/commons/digester3/NodeCreateRuleTestCase.java
 
b/commons-digester3-core/src/test/java/org/apache/commons/digester3/NodeCreateRuleTestCase.java
index 37d86a3a..5bc6b863 100644
--- 
a/commons-digester3-core/src/test/java/org/apache/commons/digester3/NodeCreateRuleTestCase.java
+++ 
b/commons-digester3-core/src/test/java/org/apache/commons/digester3/NodeCreateRuleTestCase.java
@@ -61,7 +61,7 @@ public class NodeCreateRuleTestCase
      * Gets an appropriate InputStream for the specified test file (which must 
be inside our current package.
      *
      * @param name Name of the test file we want
-     * @throws IOException if an input/output error occurs
+     * @throws IOException Thrown if an input/output error occurs
      */
     protected InputStream getInputStream( final String name )
     {
diff --git 
a/commons-digester3-core/src/test/java/org/apache/commons/digester3/RuleTestCase.java
 
b/commons-digester3-core/src/test/java/org/apache/commons/digester3/RuleTestCase.java
index 9240da1a..788135d8 100644
--- 
a/commons-digester3-core/src/test/java/org/apache/commons/digester3/RuleTestCase.java
+++ 
b/commons-digester3-core/src/test/java/org/apache/commons/digester3/RuleTestCase.java
@@ -49,7 +49,7 @@ public class RuleTestCase
      * Gets an appropriate InputStream for the specified test file (which must 
be inside our current package.
      *
      * @param name Name of the test file we want
-     * @throws IOException if an input/output error occurs
+     * @throws IOException Thrown if an input/output error occurs
      */
     protected InputStream getInputStream( final String name )
     {
diff --git 
a/commons-digester3-core/src/test/java/org/apache/commons/digester3/XIncludeTestCase.java
 
b/commons-digester3-core/src/test/java/org/apache/commons/digester3/XIncludeTestCase.java
index a5fcd09e..e604970b 100644
--- 
a/commons-digester3-core/src/test/java/org/apache/commons/digester3/XIncludeTestCase.java
+++ 
b/commons-digester3-core/src/test/java/org/apache/commons/digester3/XIncludeTestCase.java
@@ -40,7 +40,7 @@ public class XIncludeTestCase
      * Gets an appropriate InputStream for the specified test file (which must 
be inside our current package.
      *
      * @param name Name of the test file we want
-     * @throws IOException if an input/output error occurs
+     * @throws IOException Thrown if an input/output error occurs
      */
     protected InputStream getInputStream( final String name )
     {
diff --git 
a/commons-digester3-core/src/test/java/org/apache/commons/digester3/XMLSchemaTestCase.java
 
b/commons-digester3-core/src/test/java/org/apache/commons/digester3/XMLSchemaTestCase.java
index 11d49e31..82ed1c67 100644
--- 
a/commons-digester3-core/src/test/java/org/apache/commons/digester3/XMLSchemaTestCase.java
+++ 
b/commons-digester3-core/src/test/java/org/apache/commons/digester3/XMLSchemaTestCase.java
@@ -81,7 +81,7 @@ public class XMLSchemaTestCase
      * Gets an appropriate InputStream for the specified test file (which must 
be inside our current package.
      *
      * @param name Name of the test file we want
-     * @throws IOException if an input/output error occurs
+     * @throws IOException Thrown if an input/output error occurs
      */
     protected InputStream getInputStream( final String name )
     {
diff --git 
a/commons-digester3-core/src/test/java/org/apache/commons/digester3/annotations/AbstractAnnotatedPojoTestCase.java
 
b/commons-digester3-core/src/test/java/org/apache/commons/digester3/annotations/AbstractAnnotatedPojoTestCase.java
index 93a30947..0beaeea4 100644
--- 
a/commons-digester3-core/src/test/java/org/apache/commons/digester3/annotations/AbstractAnnotatedPojoTestCase.java
+++ 
b/commons-digester3-core/src/test/java/org/apache/commons/digester3/annotations/AbstractAnnotatedPojoTestCase.java
@@ -42,7 +42,7 @@ public abstract class AbstractAnnotatedPojoTestCase
      * XML and verify the digester produces the same result.
      *
      * @param expected The expected object
-     * @throws Exception if any error occurs
+     * @throws Exception Thrown if any error occurs
      */
     public final void verifyExpectedEqualsToParsed(final Object expected) 
throws Exception {
         final Class<?> clazz = expected.getClass();
diff --git 
a/commons-digester3-core/src/test/java/org/apache/commons/digester3/plugins/Utils.java
 
b/commons-digester3-core/src/test/java/org/apache/commons/digester3/plugins/Utils.java
index 59057d24..9528648b 100644
--- 
a/commons-digester3-core/src/test/java/org/apache/commons/digester3/plugins/Utils.java
+++ 
b/commons-digester3-core/src/test/java/org/apache/commons/digester3/plugins/Utils.java
@@ -31,7 +31,7 @@ public class Utils
      *
      * @param caller is always "this" for the calling object.
      * @param name is the test file we want
-     * @throws IOException if an input/output error occurs
+     * @throws IOException Thrown if an input/output error occurs
      */
     public static InputStream getInputStream( final Object caller, final 
String name )
     {
diff --git 
a/commons-digester3-examples/api/document-markup/src/main/java/org/apache/commons/digester3/examples/api/documentmarkup/MarkupDigester.java
 
b/commons-digester3-examples/api/document-markup/src/main/java/org/apache/commons/digester3/examples/api/documentmarkup/MarkupDigester.java
index 08de2014..66b31e96 100644
--- 
a/commons-digester3-examples/api/document-markup/src/main/java/org/apache/commons/digester3/examples/api/documentmarkup/MarkupDigester.java
+++ 
b/commons-digester3-examples/api/document-markup/src/main/java/org/apache/commons/digester3/examples/api/documentmarkup/MarkupDigester.java
@@ -69,7 +69,7 @@ public class MarkupDigester
      * @param buffer The characters from the XML document
      * @param start Starting offset into the buffer
      * @param length Number of characters from the buffer
-     * @throws SAXException if a parsing error is to be reported
+     * @throws SAXException Thrown if a parsing error is to be reported
      */
     @Override
     public void characters( final char[] buffer, final int start, final int 
length )
@@ -89,7 +89,7 @@ public class MarkupDigester
      *   string if Namespace processing is not being performed.
      * @param qName   The qualified XML 1.0 name (with prefix), or the
      *   empty string if qualified names are not available.
-     * @throws SAXException if a parsing error is to be reported
+     * @throws SAXException Thrown if a parsing error is to be reported
      */
     @Override
     public void endElement( final String namespaceURI, final String localName, 
final String qName )
@@ -142,7 +142,7 @@ public class MarkupDigester
      *   string if qualified names are not available.
      * @param list The attributes attached to the element. If there are
      *   no attributes, it shall be an empty Attributes object.
-     * @throws SAXException if a parsing error is to be reported
+     * @throws SAXException Thrown if a parsing error is to be reported
      */
     @Override
     public void startElement( final String namespaceURI, final String 
localName, final String qName, final Attributes list )
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 097da5bf..319a05c3 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
@@ -190,8 +190,8 @@ public class RSSDigester
      * the root element from the object stack (which will be the Channel).
      *
      * @param file File containing the XML data to be parsed
-     * @throws IOException if an input/output error occurs
-     * @throws SAXException if a parsing exception occurs
+     * @throws IOException Thrown if an input/output error occurs
+     * @throws SAXException Thrown if a parsing exception occurs
      */
     @Override
     public <T> T parse( final File file )
@@ -207,8 +207,8 @@ public class RSSDigester
      * Channel).
      *
      * @param input Input source containing the XML data to be parsed
-     * @throws IOException if an input/output error occurs
-     * @throws SAXException if a parsing exception occurs
+     * @throws IOException Thrown if an input/output error occurs
+     * @throws SAXException Thrown if a parsing exception occurs
      */
     @Override
     public <T> T parse( final InputSource input )
@@ -224,8 +224,8 @@ public class RSSDigester
      * the Channel).
      *
      * @param input Input stream containing the XML data to be parsed
-     * @throws IOException if an input/output error occurs
-     * @throws SAXException if a parsing exception occurs
+     * @throws IOException Thrown if an input/output error occurs
+     * @throws SAXException Thrown if a parsing exception occurs
      */
     @Override
     public <T> T parse( final InputStream input )
@@ -241,8 +241,8 @@ public class RSSDigester
      * the Channel).
      *
      * @param uri URI containing the XML data to be parsed
-     * @throws IOException if an input/output error occurs
-     * @throws SAXException if a parsing exception occurs
+     * @throws IOException Thrown if an input/output error occurs
+     * @throws SAXException Thrown if a parsing exception occurs
      */
     @Override
     public <T> T parse( final String uri )

Reply via email to