CVS Update: xmlpull-api-v1/doc

aslom       02/07/31 16:34:15

  Modified:    doc      features.html
  Log:
  added to featues optional one to request String interning for names
  
  Revision  Changes    Path
  1.8       +20 -1     xmlpull-api-v1/doc/features.html
  
  Index: features.html
  ===================================================================
  RCS file: /l/extreme/cvspub/xmlpull-api-v1/doc/features.html,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -b -t -w -r1.7 -r1.8
  --- features.html	2002/04/25 04:40:41	1.7
  +++ features.html	2002/07/31 21:34:14	1.8
  @@ -99,7 +99,26 @@
   <h2>
   Optional features</h2>
   <p>
  -They <b>MAY</b> be supported but are not part of XMLPULL API<p>
  +They <b>MAY</b> be supported but are not part of XMLPULL API<h3>
  +&nbsp;</h3>
  +<h3>
  +<a name="names-interned"></a>Optional feature: NAMES INTERNED<br>
  +&nbsp;</h3>
  +<p>This feature is identified by
  +<a href="http://xmlpull.org/v1/doc/features.html#names-interned">
  +http://xmlpull.org/v1/doc/features.html#names-interned</a> </p>
  +<p>If set to true then XMLPULL parser <b>MUST</b> intern all returned names 
  +using java.lang.String.intern that includes following functions: getName(), 
  +getPrefix(),&nbsp; getNamespace(), getNamespace(prefix), getNamespacePrefix(int),&nbsp; 
  +getNamespaceUri(int pos) , getAttributeName(), getAttributeNamespace(), 
  +getAttributePrefix(), getAttributeType(). However this feature provides no 
  +assurance about String values (like getText()) or attribute values 
  +(getAttributeValue()).&nbsp; </p>
  +
  +<p>NOTE: when enabled this feature allows for fast testing of equality against 
  +string constants (no need to use String.equals()). </p>
  +
  +<p>
   &nbsp;<h3>
   <a name="xml-roundtrip"></a>Optional feature: XML ROUNDTRIP<br>
   &nbsp;</h3>