CVS Update: xmlpull-api-v1/doc
Aleksander Andrzej Slominski <[email protected]>
| Newsgroups | gmane.text.xml.xmlpull.devel |
|---|---|
| Message-ID | <[email protected]> |
aslom 02/08/01 10:38:09 Modified: doc changes.html features.html Log: more explanation on potentially backward incompatible change to nextToken() Revision Changes Path 1.32 +9 -5 xmlpull-api-v1/doc/changes.html Index: changes.html =================================================================== RCS file: /l/extreme/cvspub/xmlpull-api-v1/doc/changes.html,v retrieving revision 1.31 retrieving revision 1.32 diff -u -b -t -w -r1.31 -r1.32 --- changes.html 2002/08/01 15:08:23 1.31 +++ changes.html 2002/08/01 15:38:09 1.32 @@ -22,14 +22,18 @@ XMLPULL API on J2SE (on J2ME typically factory is not used and only implementation of serializer or parser interface may be available). -<li><b>NOTE:</b> <b>backward incompatible change to nextToken</b>(): IGNORABLE_WHITESPACE -for content outside element root and end-of-line unnormalized content for -elements is only reported by nextToken() when +<li><b>NOTE:</b> <b>potentially backward incompatible change to nextToken</b>(): +IGNORABLE_WHITESPACE for content outside element root and end-of-line +unnormalized content for elements is not reported by nextToken() when optional <a href="http://xmlpull.org/v1/doc/features.html#unnormalized-content"> -UNNORMALIZED CONTENT feature</a> is true. This change is made to keep consistency with XML +UNNORMALIZED CONTENT feature</a> is false. However if this feature is true +parser behavior is exactly the same as in previous XmlPull API version . This change is made to keep consistency with XML infoset <a href="http://www.w3.org/TR/xml-infoset/#infoitem.document">Document Information Item properties</a> which only contain comments and processing -instructions but not white space content.<li>conformance tests can be now described in XML allowing to keep tests in +instructions but not white space content and element content has always +end-of-line normalized as described in +<a href="http://www.w3.org/TR/REC-xml#sec-line-ends">XML 1.0 End-of-Line +Handling</a>. <li>conformance tests can be now described in XML allowing to keep tests in format independent from Java (and potentially to use the same XML tests with other XmlPull API bindings such as C++ or PHP) XML files with tests are read from CLASSPATH<li>added newSerializer() method to XmlPullParserFactory 1.11 +6 -6 xmlpull-api-v1/doc/features.html Index: features.html =================================================================== RCS file: /l/extreme/cvspub/xmlpull-api-v1/doc/features.html,v retrieving revision 1.10 retrieving revision 1.11 diff -u -b -t -w -r1.10 -r1.11 --- features.html 2002/08/01 15:08:23 1.10 +++ features.html 2002/08/01 15:38:09 1.11 @@ -127,10 +127,6 @@ <p>This feature is identified by <a href="http://xmlpull.org/v1/doc/features.html#xml-roundtrip"> http://xmlpull.org/v1/doc/features.html#unnormalized-xml</a> </p> -<p>If the feature is true then parser <b>MUST</b> report exact white space -content outside of root element as IGNORABLE WHITESPACE events and <b>MUST</b> -report unnormalized (verbatim) element content TEXT and IGNORABLE_WHITESPACE -from nextToken().</p> <p>By default this feature is false and it means that IGNORABLE_WHITESPACE outside of root element <b>MUST NOT</b> be reported and that TEXT and IGNORABLE_WHITESPACE content returned from nextToken() <b>MUST</b> <b>NOT</b> @@ -140,8 +136,12 @@ consistent with XML infoset <a href="http://www.w3.org/TR/xml-infoset/#infoitem.document">Document Information Item properties</a> in which white spaces in prolog and part root -element are ignored<br> - </p> +element are ignored.</p> +<p>If this feature is true then parser <b>MUST</b> report exact white space +content outside of root element as IGNORABLE WHITESPACE events and <b>MUST</b> +report unnormalized (verbatim) element content TEXT and IGNORABLE_WHITESPACE +from nextToken().</p> +<p> </p> <h3> <a name="xml-roundtrip"></a>Optional feature: XML ROUNDTRIP<br> </h3>