CVS Update: xmlpull-api-v1/doc

aslom       02/08/01 10:08:24

  Modified:    doc      features.html changes.html
  Log:
  new property UNNORMLIZED XML to better describe
  what is required for round tripping and distinguish it
  from XML 1.0 compliance
  
  Revision  Changes    Path
  1.10      +23 -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.9
  retrieving revision 1.10
  diff -u -b -t -w -r1.9 -r1.10
  --- features.html	2002/08/01 02:52:48	1.9
  +++ features.html	2002/08/01 15:08:23	1.10
  @@ -122,6 +122,27 @@
   
   <p>
   &nbsp;<h3>
  +<a name="unnormalized-xml"></a>Optional feature: UNNORMALIZED XML<br>
  +&nbsp;</h3>
  +<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> 
  +report end-of-line unnormalized content but apply algorithm defined in
  +<a href="http://www.w3.org/TR/REC-xml#sec-line-ends">XML 1.0 End-of-Line 
  +Handling</a>. The content outside of root element is not reported to make it 
  +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>
  +&nbsp;</p>
  +<h3>
   <a name="xml-roundtrip"></a>Optional feature: XML ROUNDTRIP<br>
   &nbsp;</h3>
   <p>This feature is identified by
  @@ -129,12 +150,8 @@
   http://xmlpull.org/v1/doc/features.html#xml-roundtrip</a> </p>
   <p>If set to true then XMLPULL parser <b>MUST</b> make available original XML 
   value for START_TAG and END_TAG events with getText() and getTextCharacters() 
  -functions and must report exact white space content outside of root element as 
  -IGNORABLE WHITESPACE events (otherwise such content is not reported to make it 
  -consistent with XML infoset
  -<a href="http://www.w3.org/TR/xml-infoset/#infoitem.document">Document 
  -Information Item properties</a> (white spaces in prolog and part root element 
  -are ignored). <br>
  +functions and implicitly&nbsp; <a href="#unnormalized-xml">UNNORMALIZED XML</a> 
  +feature is set to true.<br>
   &nbsp;</p>
   
   <h3>
  
  
  
  1.31      +15 -8     xmlpull-api-v1/doc/changes.html
  
  Index: changes.html
  ===================================================================
  RCS file: /l/extreme/cvspub/xmlpull-api-v1/doc/changes.html,v
  retrieving revision 1.30
  retrieving revision 1.31
  diff -u -b -t -w -r1.30 -r1.31
  --- changes.html	2002/08/01 02:52:48	1.30
  +++ changes.html	2002/08/01 15:08:23	1.31
  @@ -9,23 +9,30 @@
   
   <H1>Changes to XMLPULL V1 API</H1><P>
   
  -<h3>IN PROGRESS: <a name="XMLPULL_1_0_9"></a>2002-00 (XMLPULL_1_0_9)</h3>
  +<h3>IN PROGRESS: <a name="XMLPULL_1_0_9"></a>2002-08 (XMLPULL_1_1_1)</h3>
   <ul>
  +<li>this will be next official stable release (based on last of 1.0.x) to 
  +incorporate all changes especially XmlSerailizer</ul>
  +
  +<h3>&nbsp;</h3>
  +
  +<h3>IN PROGRESS INTERIM RELEASE: <a name="XMLPULL_1_0_9"></a>2002-08 (XMLPULL_1_0_9)</h3>
  +<ul>
   <li><strong>NEW! XmlSerializer API</strong> that is now required part of
   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> backward incompatible change to reporting IGNORABLE_WHITESPACE 
  -for content outside element root - such content is now only reported when 
  -optional <a href="http://xmlpull.org/v1/doc/features.html#xml-roundtrip">XML 
  -ROUNDTRIP feature</a> is true. This change is made to keep consistency with XML 
  +<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 
  +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 
   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 
   format independent from Java (and potentially to use the same XML tests with 
  -other XmlPull API bindings such as C++ or PHP)
  -
  -<li>added newSerializer() method to XmlPullParserFactory
  +other XmlPull API bindings such as C++ or PHP) XML files with tests are read 
  +from CLASSPATH<li>added newSerializer() method to XmlPullParserFactory
   
   <li>added new FAQ entries: