Re: CVS Update: xmlpull-api-v1/doc

Alek,

I am a bit concerned about adding lots of property constants
for optional features.

In my opinion, optional features should not have an additional
java constant, the unique name is sufficient and does
not cost memory for implementations not supporting that feature.

Best,
Stefan



Aleksander Andrzej Slominski wrote:
> aslom       02/08/14 14:06:15
> 
>   Modified:    doc      features.html properties.html
>   Log:
>   added optional serializer feature to specify AttValue quotation char
>   clarified description of optional serializer propeties controlling indentation
>   
>   Revision  Changes    Path
>   1.15      +24 -0     xmlpull-api-v1/doc/features.html
>   
>   Index: features.html
>   ===================================================================
>   RCS file: /l/extreme/cvspub/xmlpull-api-v1/doc/features.html,v
>   retrieving revision 1.14
>   retrieving revision 1.15
>   diff -u -b -t -w -r1.14 -r1.15
>   --- features.html	2002/08/08 05:04:02	1.14
>   +++ features.html	2002/08/14 19:06:15	1.15
>   @@ -206,6 +206,30 @@
>    
>    <p>&nbsp;</p>
>    
>   +<h3>
>   +<a name="serializer-attvalue-use-apostrophe"></a>Optional feature: SERIALIZER 
>   +ATTVALUE USE APOSTROPHE<br>
>   +&nbsp;</h3>
>   +<p>This feature is identified by
>   +<a href="http://xmlpull.org/v1/doc/features.html#serializer-attvalue-use-apostrophe">
>   +http://xmlpull.org/v1/doc/features.html#serializer-attvalue-use-apostrophe</a> </p>
>   +<p>If this feature is supported that means that XmlSerializer output for 
>   +attribute value quotation can be controlled (when serializing XML 1.0 it allows 
>   +to chose one of <a href="http://www.w3.org/TR/REC-xml#NT-AttValue">alternative 
>   +representations for AttValue</a>).</p>
>   +
>   +<p>If the feature is set to true it means than XmlSerializer parser <b>MUST</b> 
>   +use apostrophe (') to quote attribute value.</p>
>   +
>   +<p>If the feature is set to false it means than XmlSerializer parser <b>MUST</b> 
>   +use quotation mark (&quot;) to quote attribute value.</p>
>   +
>   +<p>&nbsp;</p>
>   +
>   +<p>&nbsp;</p>
>   +
>   +<p>&nbsp;</p>
>   +
>    <HR>
>    <address><a href="http://www.extreme.indiana.edu/~aslom/">Aleksander Slominski</a><address>
>    </address>
>   
>   
>   
>   1.3       +16 -7     xmlpull-api-v1/doc/properties.html
>   
>   Index: properties.html
>   ===================================================================
>   RCS file: /l/extreme/cvspub/xmlpull-api-v1/doc/properties.html,v
>   retrieving revision 1.2
>   retrieving revision 1.3
>   diff -u -b -t -w -r1.2 -r1.3
>   --- properties.html	2002/08/08 05:04:02	1.2
>   +++ properties.html	2002/08/14 19:06:15	1.3
>   @@ -35,26 +35,35 @@
>    http://xmlpull.org/v1/doc/properties.html#serializer-indentation</a> </p>
>    <p>OPTIONAL property with String value </p>
>    
>   -<p>if length() &gt; 0 it is used otherwise if null or length() == 0 no indentation 
>   +<p>If passed string is not empty that it is used to indent output by one level.</p>
>   +
>   +<p>If passed string is empty only line separator (depending on
>   +<a href="#serializer-line-separator">LINE SEPARATOR property</a>) will be 
>   +written for indentation (if any).</p>
>   +
>   +<p>Otherwise if string is null no indentation 
>    is not done</p>
>    
>   -<p>For example use TAB (&quot;\t&quot;) or few spaces (&quot;&nbsp;&nbsp;&nbsp; &quot;)</p>
>   +<p>For example use TAB (&quot;\t&quot;) or few spaces (&quot;&nbsp;&nbsp;&nbsp; &quot;) 
>   +as string value.</p>
>    
>    <p>&nbsp;</p>
>    
>    <h3>
>   -<a name="serializer-indentation"></a>Optional property: SERIALIZER LINE 
>   +<a name="serializer-line-separator"></a>Optional property: SERIALIZER LINE 
>    SEPARATOR</h3>
>    <p>This property is identified by
>    <a href="http://xmlpull.org/v1/doc/properties.html#serializer-line-separator">
>    http://xmlpull.org/v1/doc/properties.html#serializer-line-separator</a> </p>
>    <p>OPTIONAL property with String value </p>
>   +
>   +<p>If indentation is enabled passed string will be used as line separator.</p>
>    
>   -<p>by default it SHOULD be initialized to platform dependent values (on Windows 
>   -&quot;\r\n&quot; on Unix &quot;\n&quot;);</p>
>   +<p>It should be initialized to platform dependent values (on Windows &quot;\r\n&quot; on 
>   +Unix &quot;\n&quot;).</p>
>    
>   -<p>if value of property is null or String of length() == 0 no line separator 
>   -will be written</p>
>   +<p>If value of property is null or String of length() == 0 no line separator 
>   +will be written.</p>
>    
>    <p>&nbsp;</p>
>    
>   
>   
>   
> 
>