This is an automated email from the ASF dual-hosted git repository.
elharo pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/xerces-j.git
The following commit(s) were added to refs/heads/main by this push:
new 9f22b8bf8 [XERCES-1781] fix incorrect Javadoc re
SAXNotRecognizedException (#61)
9f22b8bf8 is described below
commit 9f22b8bf8134d16f23a42e6aad70706a52d8ebc1
Author: Samael <[email protected]>
AuthorDate: Thu Nov 20 11:52:11 2025 +0000
[XERCES-1781] fix incorrect Javadoc re SAXNotRecognizedException (#61)
* [XERCES-1781] fix incorrect Javadoc re SAXNotRecognizedException
* [XERCES-1781] fix incorrect Javadoc re SAXNotRecognizedException
---
.../impl/XMLDocumentFragmentScannerImpl.java | 16 +++-----
.../apache/xerces/impl/XMLDocumentScannerImpl.java | 10 +----
src/org/apache/xerces/impl/XMLEntityManager.java | 10 +----
src/org/apache/xerces/impl/XMLErrorReporter.java | 10 +----
src/org/apache/xerces/impl/XMLNamespaceBinder.java | 5 +--
src/org/apache/xerces/impl/dtd/XMLDTDLoader.java | 26 +++++--------
.../apache/xerces/impl/dtd/XMLDTDProcessor.java | 10 +----
.../apache/xerces/impl/dtd/XMLDTDValidator.java | 10 +----
src/org/apache/xerces/impl/xs/XMLSchemaLoader.java | 24 +++++-------
.../apache/xerces/impl/xs/XMLSchemaValidator.java | 18 +++------
.../xerces/parsers/BasicParserConfiguration.java | 10 ++---
.../xerces/util/ParserConfigurationSettings.java | 10 ++---
.../apache/xerces/xinclude/XIncludeHandler.java | 20 +++-------
.../xerces/xni/grammars/XMLGrammarLoader.java | 44 ++++++++++------------
.../xerces/xni/parser/XMLComponentManager.java | 8 ++--
.../xerces/xni/parser/XMLParserConfiguration.java | 30 +++++++--------
16 files changed, 92 insertions(+), 169 deletions(-)
diff --git a/src/org/apache/xerces/impl/XMLDocumentFragmentScannerImpl.java
b/src/org/apache/xerces/impl/XMLDocumentFragmentScannerImpl.java
index 4086cbe71..b7b165417 100644
--- a/src/org/apache/xerces/impl/XMLDocumentFragmentScannerImpl.java
+++ b/src/org/apache/xerces/impl/XMLDocumentFragmentScannerImpl.java
@@ -398,10 +398,7 @@ public class XMLDocumentFragmentScannerImpl
* @param featureId The feature identifier.
* @param state The state of the feature.
*
- * @throws SAXNotRecognizedException The component should not throw
- * this exception.
- * @throws SAXNotSupportedException The component should not throw
- * this exception.
+ * @throws XMLConfigurationException when a feature is not recognized or
cannot be set
*/
public void setFeature(String featureId, boolean state)
throws XMLConfigurationException {
@@ -434,14 +431,11 @@ public class XMLDocumentFragmentScannerImpl
* <p>
* <strong>Note:</strong> Components should silently ignore properties
* that do not affect the operation of the component.
- *
- * @param propertyId The property identifier.
- * @param value The value of the property.
*
- * @throws SAXNotRecognizedException The component should not throw
- * this exception.
- * @throws SAXNotSupportedException The component should not throw
- * this exception.
+ * @param propertyId the property identifier
+ * @param value the value of the property
+ *
+ * @throws XMLConfigurationException when a property is not recognized or
cannot be set
*/
public void setProperty(String propertyId, Object value)
throws XMLConfigurationException {
diff --git a/src/org/apache/xerces/impl/XMLDocumentScannerImpl.java
b/src/org/apache/xerces/impl/XMLDocumentScannerImpl.java
index 8dca6b544..6e62b553c 100644
--- a/src/org/apache/xerces/impl/XMLDocumentScannerImpl.java
+++ b/src/org/apache/xerces/impl/XMLDocumentScannerImpl.java
@@ -338,10 +338,7 @@ public class XMLDocumentScannerImpl
* @param featureId The feature identifier.
* @param state The state of the feature.
*
- * @throws SAXNotRecognizedException The component should not throw
- * this exception.
- * @throws SAXNotSupportedException The component should not throw
- * this exception.
+ * @throws XMLConfigurationException when a feature is not recognized or
cannot be set
*/
public void setFeature(String featureId, boolean state)
throws XMLConfigurationException {
@@ -392,10 +389,7 @@ public class XMLDocumentScannerImpl
* @param propertyId The property identifier.
* @param value The value of the property.
*
- * @throws SAXNotRecognizedException The component should not throw
- * this exception.
- * @throws SAXNotSupportedException The component should not throw
- * this exception.
+ * @throws XMLConfigurationException when a property is not recognized or
cannot be set
*/
public void setProperty(String propertyId, Object value)
throws XMLConfigurationException {
diff --git a/src/org/apache/xerces/impl/XMLEntityManager.java
b/src/org/apache/xerces/impl/XMLEntityManager.java
index 8df84a7b7..872681f87 100644
--- a/src/org/apache/xerces/impl/XMLEntityManager.java
+++ b/src/org/apache/xerces/impl/XMLEntityManager.java
@@ -1450,10 +1450,7 @@ public class XMLEntityManager
* @param featureId The feature identifier.
* @param state The state of the feature.
*
- * @throws SAXNotRecognizedException The component should not throw
- * this exception.
- * @throws SAXNotSupportedException The component should not throw
- * this exception.
+ * @throws XMLConfigurationException when a feature is not recognized or
cannot be set
*/
public void setFeature(String featureId, boolean state)
throws XMLConfigurationException {
@@ -1488,10 +1485,7 @@ public class XMLEntityManager
* @param propertyId The property identifier.
* @param value The value of the property.
*
- * @throws SAXNotRecognizedException The component should not throw
- * this exception.
- * @throws SAXNotSupportedException The component should not throw
- * this exception.
+ * @throws XMLConfigurationException when a property is not recognized or
cannot be set
*/
public void setProperty(String propertyId, Object value)
throws XMLConfigurationException {
diff --git a/src/org/apache/xerces/impl/XMLErrorReporter.java
b/src/org/apache/xerces/impl/XMLErrorReporter.java
index f6e9e61e8..f101a2cee 100644
--- a/src/org/apache/xerces/impl/XMLErrorReporter.java
+++ b/src/org/apache/xerces/impl/XMLErrorReporter.java
@@ -448,10 +448,7 @@ public class XMLErrorReporter
* @param featureId The feature identifier.
* @param state The state of the feature.
*
- * @throws SAXNotRecognizedException The component should not throw
- * this exception.
- * @throws SAXNotSupportedException The component should not throw
- * this exception.
+ * @throws XMLConfigurationException when a feature is not recognized or
cannot be set
*/
public void setFeature(String featureId, boolean state)
throws XMLConfigurationException {
@@ -520,10 +517,7 @@ public class XMLErrorReporter
* @param propertyId The property identifier.
* @param value The value of the property.
*
- * @throws SAXNotRecognizedException The component should not throw
- * this exception.
- * @throws SAXNotSupportedException The component should not throw
- * this exception.
+ * @throws XMLConfigurationException when a property is not recognized or
cannot be set
*/
public void setProperty(String propertyId, Object value)
throws XMLConfigurationException {
diff --git a/src/org/apache/xerces/impl/XMLNamespaceBinder.java
b/src/org/apache/xerces/impl/XMLNamespaceBinder.java
index 1f20bca16..88ed9f6f8 100644
--- a/src/org/apache/xerces/impl/XMLNamespaceBinder.java
+++ b/src/org/apache/xerces/impl/XMLNamespaceBinder.java
@@ -220,10 +220,7 @@ public class XMLNamespaceBinder
* @param featureId The feature identifier.
* @param state The state of the feature.
*
- * @throws SAXNotRecognizedException The component should not throw
- * this exception.
- * @throws SAXNotSupportedException The component should not throw
- * this exception.
+ * @throws XMLConfigurationException when a feature is not recognized or
cannot be set
*/
public void setFeature(String featureId, boolean state)
throws XMLConfigurationException {
diff --git a/src/org/apache/xerces/impl/dtd/XMLDTDLoader.java
b/src/org/apache/xerces/impl/dtd/XMLDTDLoader.java
index 4273c1a26..0856f131b 100644
--- a/src/org/apache/xerces/impl/dtd/XMLDTDLoader.java
+++ b/src/org/apache/xerces/impl/dtd/XMLDTDLoader.java
@@ -203,10 +203,7 @@ public class XMLDTDLoader
* @param featureId The feature identifier.
* @param state The state of the feature.
*
- * @throws SAXNotRecognizedException The component should not throw
- * this exception.
- * @throws SAXNotSupportedException The component should not throw
- * this exception.
+ * @throws XMLConfigurationException when a feature is not recognized or
cannot be set
*/
public void setFeature(String featureId, boolean state)
throws XMLConfigurationException {
@@ -244,10 +241,10 @@ public class XMLDTDLoader
/**
* Returns the state of a property.
- *
- * @param propertyId The property identifier.
- *
- * @throws XMLConfigurationException Thrown on configuration error.
+ *
+ * @param propertyId the property identifier
+ *
+ * @throws XMLConfigurationException when a property is not recognized
*/
public Object getProperty(String propertyId)
throws XMLConfigurationException {
@@ -285,10 +282,7 @@ public class XMLDTDLoader
* @param propertyId The property identifier.
* @param value The value of the property.
*
- * @throws SAXNotRecognizedException The component should not throw
- * this exception.
- * @throws SAXNotSupportedException The component should not throw
- * this exception.
+ * @throws XMLConfigurationException when a property is not recognized or
cannot be set
*/
public void setProperty(String propertyId, Object value)
throws XMLConfigurationException {
@@ -328,10 +322,10 @@ public class XMLDTDLoader
/**
* Returns the state of a feature.
- *
- * @param featureId The feature identifier.
- *
- * @throws XMLConfigurationException Thrown on configuration error.
+ *
+ * @param featureId the feature identifier
+ *
+ * @throws XMLConfigurationException when a featureId is not recognized
*/
public boolean getFeature(String featureId)
throws XMLConfigurationException {
diff --git a/src/org/apache/xerces/impl/dtd/XMLDTDProcessor.java
b/src/org/apache/xerces/impl/dtd/XMLDTDProcessor.java
index 7673cb039..3c5131933 100644
--- a/src/org/apache/xerces/impl/dtd/XMLDTDProcessor.java
+++ b/src/org/apache/xerces/impl/dtd/XMLDTDProcessor.java
@@ -391,10 +391,7 @@ public class XMLDTDProcessor
* @param featureId The feature identifier.
* @param state The state of the feature.
*
- * @throws SAXNotRecognizedException The component should not throw
- * this exception.
- * @throws SAXNotSupportedException The component should not throw
- * this exception.
+ * @throws XMLConfigurationException when a feature is not recognized or
cannot be set
*/
public void setFeature(String featureId, boolean state)
throws XMLConfigurationException {
@@ -419,10 +416,7 @@ public class XMLDTDProcessor
* @param propertyId The property identifier.
* @param value The value of the property.
*
- * @throws SAXNotRecognizedException The component should not throw
- * this exception.
- * @throws SAXNotSupportedException The component should not throw
- * this exception.
+ * @throws XMLConfigurationException when a property is not recognized or
cannot be set
*/
public void setProperty(String propertyId, Object value)
throws XMLConfigurationException {
diff --git a/src/org/apache/xerces/impl/dtd/XMLDTDValidator.java
b/src/org/apache/xerces/impl/dtd/XMLDTDValidator.java
index de906ca97..ab5ccd6bb 100644
--- a/src/org/apache/xerces/impl/dtd/XMLDTDValidator.java
+++ b/src/org/apache/xerces/impl/dtd/XMLDTDValidator.java
@@ -527,10 +527,7 @@ public class XMLDTDValidator
* @param featureId The feature identifier.
* @param state The state of the feature.
*
- * @throws SAXNotRecognizedException The component should not throw
- * this exception.
- * @throws SAXNotSupportedException The component should not throw
- * this exception.
+ * @throws XMLConfigurationException when a feature is not recognized or
cannot be set
*/
public void setFeature(String featureId, boolean state)
throws XMLConfigurationException {
@@ -555,10 +552,7 @@ public class XMLDTDValidator
* @param propertyId The property identifier.
* @param value The value of the property.
*
- * @throws SAXNotRecognizedException The component should not throw
- * this exception.
- * @throws SAXNotSupportedException The component should not throw
- * this exception.
+ * @throws XMLConfigurationException when a property is not recognized or
cannot be set
*/
public void setProperty(String propertyId, Object value)
throws XMLConfigurationException {
diff --git a/src/org/apache/xerces/impl/xs/XMLSchemaLoader.java
b/src/org/apache/xerces/impl/xs/XMLSchemaLoader.java
index 36465d424..8339876d4 100644
--- a/src/org/apache/xerces/impl/xs/XMLSchemaLoader.java
+++ b/src/org/apache/xerces/impl/xs/XMLSchemaLoader.java
@@ -358,9 +358,9 @@ XSLoader, DOMConfiguration {
/**
* Returns the state of a feature.
*
- * @param featureId The feature identifier.
+ * @param featureId the feature identifier
*
- * @throws XMLConfigurationException Thrown on configuration error.
+ * @throws XMLConfigurationException when a featureId is not recognized
*/
public boolean getFeature(String featureId)
throws XMLConfigurationException {
@@ -373,11 +373,9 @@ XSLoader, DOMConfiguration {
* @param featureId The feature identifier.
* @param state The state of the feature.
*
- * @throws XMLConfigurationException Thrown when a feature is not
- * recognized or cannot be set.
+ * @throws XMLConfigurationException when a feature is not recognized or
cannot be set
*/
- public void setFeature(String featureId,
- boolean state) throws XMLConfigurationException {
+ public void setFeature(String featureId, boolean state) throws
XMLConfigurationException {
fSettingsChanged = true;
if(featureId.equals(CONTINUE_AFTER_FATAL_ERROR)) {
fErrorReporter.setFeature(CONTINUE_AFTER_FATAL_ERROR, state);
@@ -400,9 +398,9 @@ XSLoader, DOMConfiguration {
/**
* Returns the state of a property.
*
- * @param propertyId The property identifier.
+ * @param propertyId the property identifier
*
- * @throws XMLConfigurationException Thrown on configuration error.
+ * @throws XMLConfigurationException when a property is not recognized
*/
public Object getProperty(String propertyId)
throws XMLConfigurationException {
@@ -412,14 +410,12 @@ XSLoader, DOMConfiguration {
/**
* Sets the state of a property.
*
- * @param propertyId The property identifier.
- * @param state The state of the property.
+ * @param propertyId the property identifier
+ * @param state the state of the property
*
- * @throws XMLConfigurationException Thrown when a property is not
- * recognized or cannot be set.
+ * @throws XMLConfigurationException when a property is not recognized or
cannot be set
*/
- public void setProperty(String propertyId,
- Object state) throws XMLConfigurationException {
+ public void setProperty(String propertyId, Object state) throws
XMLConfigurationException {
fSettingsChanged = true;
fLoaderConfig.setProperty(propertyId, state);
if (propertyId.equals(JAXP_SCHEMA_SOURCE)) {
diff --git a/src/org/apache/xerces/impl/xs/XMLSchemaValidator.java
b/src/org/apache/xerces/impl/xs/XMLSchemaValidator.java
index c1522cdaf..f639ebd2e 100644
--- a/src/org/apache/xerces/impl/xs/XMLSchemaValidator.java
+++ b/src/org/apache/xerces/impl/xs/XMLSchemaValidator.java
@@ -552,13 +552,10 @@ public class XMLSchemaValidator
* <strong>Note:</strong> Components should silently ignore features
* that do not affect the operation of the component.
*
- * @param featureId The feature identifier.
- * @param state The state of the feature.
+ * @param featureId the feature identifier
+ * @param state the state of the feature
*
- * @throws SAXNotRecognizedException The component should not throw
- * this exception.
- * @throws SAXNotSupportedException The component should not throw
- * this exception.
+ * @throws XMLConfigurationException when a feature is not recognized or
cannot be set
*/
public void setFeature(String featureId, boolean state) throws
XMLConfigurationException {
} // setFeature(String,boolean)
@@ -579,13 +576,10 @@ public class XMLSchemaValidator
* <strong>Note:</strong> Components should silently ignore properties
* that do not affect the operation of the component.
*
- * @param propertyId The property identifier.
- * @param value The value of the property.
+ * @param propertyId the property identifier
+ * @param value the value of the property
*
- * @throws SAXNotRecognizedException The component should not throw
- * this exception.
- * @throws SAXNotSupportedException The component should not throw
- * this exception.
+ * @throws XMLConfigurationException when a property is not recognized or
cannot be set
*/
public void setProperty(String propertyId, Object value) throws
XMLConfigurationException {
if (propertyId.equals(ROOT_TYPE_DEF)) {
diff --git a/src/org/apache/xerces/parsers/BasicParserConfiguration.java
b/src/org/apache/xerces/parsers/BasicParserConfiguration.java
index a3b9ff134..a93bb1f7a 100644
--- a/src/org/apache/xerces/parsers/BasicParserConfiguration.java
+++ b/src/org/apache/xerces/parsers/BasicParserConfiguration.java
@@ -437,10 +437,9 @@ public abstract class BasicParserConfiguration
* @param featureId the unique identifier (URI) of the feature
* @param state the requested state of the feature (true or false)
*
- * @throws XMLConfigurationException if the requested feature is not known
+ * @throws XMLConfigurationException when a feature is not recognized and
cannot be set
*/
- public void setFeature(String featureId, boolean state)
- throws XMLConfigurationException {
+ public void setFeature(String featureId, boolean state) throws
XMLConfigurationException {
// forward to every component
int count = fComponents.size();
@@ -459,10 +458,9 @@ public abstract class BasicParserConfiguration
* @param propertyId the unique identifier of the property
* @param value the requested value of the property
*
- * @throws XMLConfigurationException if the requested property is not known
+ * @throws XMLConfigurationException when a property is not recognized and
cannot be set
*/
- public void setProperty(String propertyId, Object value)
- throws XMLConfigurationException {
+ public void setProperty(String propertyId, Object value) throws
XMLConfigurationException {
// forward to every component
int count = fComponents.size();
diff --git a/src/org/apache/xerces/util/ParserConfigurationSettings.java
b/src/org/apache/xerces/util/ParserConfigurationSettings.java
index 54f25e861..96e6b93ce 100644
--- a/src/org/apache/xerces/util/ParserConfigurationSettings.java
+++ b/src/org/apache/xerces/util/ParserConfigurationSettings.java
@@ -129,10 +129,9 @@ public class ParserConfigurationSettings
* @param featureId the unique identifier (URI) of the feature
* @param state the requested state of the feature (true or false)
*
- * @throws XMLConfigurationException if the requested feature is not known
+ * @throws XMLConfigurationException when a feature is not recognized and
cannot be set
*/
- public void setFeature(String featureId, boolean state)
- throws XMLConfigurationException {
+ public void setFeature(String featureId, boolean state) throws
XMLConfigurationException {
// check and store
checkFeature(featureId);
@@ -166,10 +165,9 @@ public class ParserConfigurationSettings
* @param propertyId the unique identifier of the property
* @param value the requested value of the property
*
- * @throws XMLConfigurationException if the requested property is not known
+ * @throws XMLConfigurationException when a property is not recognized and
cannot be set
*/
- public void setProperty(String propertyId, Object value)
- throws XMLConfigurationException {
+ public void setProperty(String propertyId, Object value) throws
XMLConfigurationException {
// check and store
checkProperty(propertyId);
diff --git a/src/org/apache/xerces/xinclude/XIncludeHandler.java
b/src/org/apache/xerces/xinclude/XIncludeHandler.java
index 9cce2aedd..70d023be8 100644
--- a/src/org/apache/xerces/xinclude/XIncludeHandler.java
+++ b/src/org/apache/xerces/xinclude/XIncludeHandler.java
@@ -611,13 +611,9 @@ public class XIncludeHandler
* @param featureId The feature identifier.
* @param state The state of the feature.
*
- * @throws SAXNotRecognizedException The component should not throw
- * this exception.
- * @throws SAXNotSupportedException The component should not throw
- * this exception.
+ * @throws XMLConfigurationException when a feature is not recognized or
cannot be set
*/
- public void setFeature(String featureId, boolean state)
- throws XMLConfigurationException {
+ public void setFeature(String featureId, boolean state) throws
XMLConfigurationException {
if (featureId.equals(ALLOW_UE_AND_NOTATION_EVENTS)) {
fSendUEAndNotationEvents = state;
}
@@ -643,16 +639,12 @@ public class XIncludeHandler
* <strong>Note:</strong> Components should silently ignore properties
* that do not affect the operation of the component.
*
- * @param propertyId The property identifier.
- * @param value The value of the property.
+ * @param propertyId the property identifier
+ * @param value the value of the property
*
- * @throws SAXNotRecognizedException The component should not throw
- * this exception.
- * @throws SAXNotSupportedException The component should not throw
- * this exception.
+ * @throws XMLConfigurationException when a property is not recognized or
cannot be set
*/
- public void setProperty(String propertyId, Object value)
- throws XMLConfigurationException {
+ public void setProperty(String propertyId, Object value) throws
XMLConfigurationException {
if (propertyId.equals(SYMBOL_TABLE)) {
fSymbolTable = (SymbolTable)value;
if (fChildConfig != null) {
diff --git a/src/org/apache/xerces/xni/grammars/XMLGrammarLoader.java
b/src/org/apache/xerces/xni/grammars/XMLGrammarLoader.java
index 1379b931c..33ab0df63 100644
--- a/src/org/apache/xerces/xni/grammars/XMLGrammarLoader.java
+++ b/src/org/apache/xerces/xni/grammars/XMLGrammarLoader.java
@@ -48,25 +48,22 @@ public interface XMLGrammarLoader {
/**
* Returns the state of a feature.
- *
- * @param featureId The feature identifier.
- *
- * @throws XMLConfigurationException Thrown on configuration error.
+ *
+ * @param featureId the feature identifier
+ *
+ * @throws XMLConfigurationException when a feature is not recognized
*/
- public boolean getFeature(String featureId)
- throws XMLConfigurationException;
+ public boolean getFeature(String featureId) throws
XMLConfigurationException;
/**
* Sets the state of a feature.
*
- * @param featureId The feature identifier.
- * @param state The state of the feature.
+ * @param featureId the feature identifier
+ * @param state the state of the feature
*
- * @throws XMLConfigurationException Thrown when a feature is not
- * recognized or cannot be set.
+ * @throws XMLConfigurationException when a feature is not recognized and
cannot be set
*/
- public void setFeature(String featureId,
- boolean state) throws XMLConfigurationException;
+ public void setFeature(String featureId, boolean state) throws
XMLConfigurationException;
/**
* Returns a list of property identifiers that are recognized by
@@ -77,25 +74,22 @@ public interface XMLGrammarLoader {
/**
* Returns the state of a property.
- *
- * @param propertyId The property identifier.
- *
- * @throws XMLConfigurationException Thrown on configuration error.
+ *
+ * @param propertyId the property identifier
+ *
+ * @throws XMLConfigurationException when a property is not recognized
*/
- public Object getProperty(String propertyId)
- throws XMLConfigurationException;
+ public Object getProperty(String propertyId) throws
XMLConfigurationException;
/**
* Sets the state of a property.
- *
- * @param propertyId The property identifier.
- * @param state The state of the property.
*
- * @throws XMLConfigurationException Thrown when a property is not
- * recognized or cannot be set.
+ * @param propertyId the property identifier
+ * @param state the state of the property
+ *
+ * @throws XMLConfigurationException when a property is not recognized and
cannot be set
*/
- public void setProperty(String propertyId,
- Object state) throws XMLConfigurationException;
+ public void setProperty(String propertyId, Object state) throws
XMLConfigurationException;
/**
* Set the locale to use for messages.
diff --git a/src/org/apache/xerces/xni/parser/XMLComponentManager.java
b/src/org/apache/xerces/xni/parser/XMLComponentManager.java
index e50184bbd..f1bb7136d 100644
--- a/src/org/apache/xerces/xni/parser/XMLComponentManager.java
+++ b/src/org/apache/xerces/xni/parser/XMLComponentManager.java
@@ -44,8 +44,8 @@ public interface XMLComponentManager {
* @param featureId The feature identifier
*
* @return the state of a feature
- *
- * @throws XMLConfigurationException on configuration error
+ *
+ * @throws XMLConfigurationException when a feature is not recognized
*/
public boolean getFeature(String featureId) throws
XMLConfigurationException;
@@ -55,8 +55,8 @@ public interface XMLComponentManager {
* @param propertyId the property identifier
*
* @return the value of a property
- *
- * @throws XMLConfigurationException on configuration error
+ *
+ * @throws XMLConfigurationException when a property is not recognized
*/
public Object getProperty(String propertyId) throws
XMLConfigurationException;
diff --git a/src/org/apache/xerces/xni/parser/XMLParserConfiguration.java
b/src/org/apache/xerces/xni/parser/XMLParserConfiguration.java
index 469ed6f61..1c1840cd7 100644
--- a/src/org/apache/xerces/xni/parser/XMLParserConfiguration.java
+++ b/src/org/apache/xerces/xni/parser/XMLParserConfiguration.java
@@ -127,24 +127,22 @@ public interface XMLParserConfiguration
/**
* Sets the state of a feature. This method is called by the parser
* and gets propagated to components in this parser configuration.
- *
+ *
* @param featureId the unique identifier of the feature
* @param state the requested state of the feature (true or false)
*
- * @throws XMLConfigurationException if there is a configuration error
+ * @throws XMLConfigurationException when a feature is not recognized and
cannot be set
*/
- public void setFeature(String featureId, boolean state)
- throws XMLConfigurationException;
+ public void setFeature(String featureId, boolean state) throws
XMLConfigurationException;
/**
* Returns the state of a feature.
- *
+ *
* @param featureId the feature identifier
- *
- * @throws XMLConfigurationException if there is a configuration error
+ *
+ * @throws XMLConfigurationException when a feature is not recognized
*/
- public boolean getFeature(String featureId)
- throws XMLConfigurationException;
+ public boolean getFeature(String featureId) throws
XMLConfigurationException;
/**
* Allows a parser to add parser specific properties to be recognized
@@ -162,20 +160,18 @@ public interface XMLParserConfiguration
* @param propertyId the unique identifier of the property
* @param value the requested value of the property
*
- * @throws XMLConfigurationException if the requested property is not known
+ * @throws XMLConfigurationException when a property is not recognized and
cannot be set
*/
- public void setProperty(String propertyId, Object value)
- throws XMLConfigurationException;
+ public void setProperty(String propertyId, Object value) throws
XMLConfigurationException;
/**
* Returns the value of a property.
- *
+ *
* @param propertyId the property identifier
- *
- * @throws XMLConfigurationException if there is a configuration error
+ *
+ * @throws XMLConfigurationException when a property is not recognized
*/
- public Object getProperty(String propertyId)
- throws XMLConfigurationException;
+ public Object getProperty(String propertyId) throws
XMLConfigurationException;
// handlers
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
