mrglavas 2004/07/13 21:42:35
Modified: java/docs properties.xml features.xml
java/docs/dtd settings.dtd
Log:
Adding documentation for most of the SAX 2.0.2 and
SAX2 Extensions 1.1 features and properties.
Revision Changes Path
1.16 +16 -0 xml-xerces/java/docs/properties.xml
Index: properties.xml
===================================================================
RCS file: /home/cvs/xml-xerces/java/docs/properties.xml,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- properties.xml 4 Jun 2004 04:40:10 -0000 1.15
+++ properties.xml 14 Jul 2004 04:42:34 -0000 1.16
@@ -130,6 +130,7 @@
</desc>
<type>java.lang.Integer</type>
<access general='read-write'/>
+ <since value='&ParserName; 2.1.0'/>
<note>
Some tests indicate that a bigger buffer size can improve the parsing
performance for relatively large files. The default buffer size
@@ -157,6 +158,7 @@
</desc>
<type>org.apache.xerces.util.SecurityManager</type>
<access general='read-write'/>
+ <since value='&ParserName; 2.3.0'/>
<note>
The <code>org.apache.xerces.util.SecurityManager</code> class
contains a number of methods that allow applications to tailor Xerces's
@@ -225,6 +227,20 @@
This property is only for SAX parser implementations used as
DOM tree walkers. Currently, Xerces does not have this
functionality.
+ </note>
+ </property>
+ <property name='http://xml.org/sax/properties/document-xml-version'
+ id='document-xml-version'>
+ <desc>
+ A literal string describing the actual XML version
+ of the document, such as "1.0" or "1.1".
+ </desc>
+ <type>java.lang.String</type>
+ <access general='read-only'/>
+ <since value='&ParserName; 2.7.0'/>
+ <note>
+ This property may only be examined during a parse after the
+ startDocument callback has been completed.
</note>
</property>
</pcategory>
1.40 +79 -1 xml-xerces/java/docs/features.xml
Index: features.xml
===================================================================
RCS file: /home/cvs/xml-xerces/java/docs/features.xml,v
retrieving revision 1.39
retrieving revision 1.40
diff -u -r1.39 -r1.40
--- features.xml 14 Jul 2004 03:21:28 -0000 1.39
+++ features.xml 14 Jul 2004 04:42:34 -0000 1.40
@@ -320,6 +320,7 @@
</true>
<false>DOCTYPE declaration is allowed.</false>
<default value='false'/>
+ <since value='&ParserName; 2.3.0'/>
</feature>
<feature name='http://apache.org/xml/features/standard-uri-conformant'
@@ -332,6 +333,7 @@
invalid URI characters (space, for example).
</false>
<default value='false'/>
+ <since value='&ParserName; 2.3.0'/>
<note>
It's recommended to set this feature to true if you want your
application/documents to be truly portable across different XML processors.
@@ -444,8 +446,83 @@
Do not report the beginning and end of parameter entities to a registered
LexicalHandler.
</false>
<default value='true'/>
- <since value='Xerces-J 2.7.0'/>
+ <since value='&ParserName; 2.7.0'/>
</feature>
+ <feature name='http://xml.org/sax/features/is-standalone'
+ id='is-standalone'>
+ <true>
+ The document specified standalone="yes" in its XML declaration.
+ </true>
+ <false>
+ The document specified standalone="no" in its XML declaration or the
+ standalone document declaration was absent.
+ </false>
+ <access parsing='read-only' not-parsing='none'/>
+ <since value='&ParserName; 2.7.0'/>
+ </feature>
+ <feature name='http://xml.org/sax/features/resolve-dtd-uris'
+ id='resolve-dtd-uris'>
+ <true>
+ The system identifiers passed to the notationDecl, unparsedEntityDecl, and
+ externalEntityDecl events will be absolutized relative to their base URIs
before reporting.
+ </true>
+ <false>
+ System identifiers in declarations will not be absolutized before reporting.
+ </false>
+ <default value='true'/>
+ <since value='&ParserName; 2.7.0'/>
+ <note>
+ This feature does not apply to EntityResolver.resolveEntity(), which is not
used to report declarations,
+ or to LexicalHandler.startDTD(), which already provides the non-absolutized URI.
+ </note>
+ </feature>
+ <feature name='http://xml.org/sax/features/unicode-normalization-checking'
+ id='unicode-normalization-checking'>
+ <true>
+ Perform Unicode normalization checking (as described in section 2.13 and
Appendix B
+ of the XML 1.1 Recommendation) and report normalization errors.
+ </true>
+ <false>
+ Do not report Unicode normalization errors.
+ </false>
+ <default value='false'/>
+ <since value='&ParserName; 2.7.0'/>
+ <note>
+ As there is currently no support for Unicode normalization checking, this
+ feature can only be set to false.
+ </note>
+ </feature>
+ <feature name='http://xml.org/sax/features/xmlns-uris'
+ id='xmlns-uris'>
+ <true>
+ When the namespace-prefixes feature is set to true, namespace declaration
attributes
+ will be reported as being in the http://www.w3.org/2000/xmlns/ namespace.
+ </true>
+ <false>
+ Namespace declaration attributes are reported as having no namespace.
+ </false>
+ <default value='false'/>
+ <since value='&ParserName; 2.7.0'/>
+ <see idref='namespaces'/>
+ <see idref='namespace-prefixes'/>
+ </feature>
+ <feature name='http://xml.org/sax/features/xml-1.1'
+ id='xml-1.1'>
+ <true>
+ The parser supports both XML 1.1 and XML 1.0.
+ </true>
+ <false>
+ The parser supports only XML 1.0.
+ </false>
+ <access general='read-only'/>
+ <since value='&ParserName; 2.7.0'/>
+ <note>
+ The value of this feature will depend on whether the
+ parser configuration owned by the SAX parser is known
+ to support XML 1.1.
+ </note>
+ </feature>
+
</fcategory>
<fcategory name='XInclude Features (Experimental)'>
<feature name='http://xml.org/sax/features/allow-dtd-events-after-endDTD'
@@ -459,6 +536,7 @@
are not sent after the <code>endDTD</code> event has been sent (default SAX
behaviour).
</false>
<default value='true**'/>
+ <since value='&ParserName; 2.5.0'/>
<note>
The default value for this feature is true, except when using SAX,
because SAX requires that no DTD events be sent after the <code>endDTD</code>
1.5 +1 -1 xml-xerces/java/docs/dtd/settings.dtd
Index: settings.dtd
===================================================================
RCS file: /home/cvs/xml-xerces/java/docs/dtd/settings.dtd,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- settings.dtd 14 Jul 2004 03:21:28 -0000 1.4
+++ settings.dtd 14 Jul 2004 04:42:35 -0000 1.5
@@ -3,7 +3,7 @@
%include.blocks;
<!ENTITY % boolean '(true|false)'>
-<!ENTITY % access-options '(read-only|read-write|write-only)'>
+<!ENTITY % access-options '(read-only|read-write|write-only|none)'>
<!ELEMENT settings (features,properties)>
<!ELEMENT features (desc?,(fcategory+|feature+)?)>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
