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 )