---- On Tue, 10 Aug 2010 01:45:42 -0700 Stéphane Ducasse  wrote ---- 

>Just an api point 
> 
>why preservesC... 
>and not 
>    preserverC 
> 
>I'm always confuse with the infinitive and third person singular situation. 
> 
>Stef 

The infinitive in English is two words with possibly other words separating 
them, the word "to" and then the verb lacking any "s" or "es" or other tense, 
number or person modifiers: "to program" or "to code."

I choose preservesCDataSections because it is more obvious that it returns a 
boolean and that the corresponding preservesCDataSections: accepts a boolean. 
If you call the testing message preserveCDataSections, it sounds more like you 
are commanding the receiver to do so rather than asking if it already does..

Also, my mail client ate the example code, so here it is again:
doc :=
        (XMLDOMParser on: '<root><![CDATA[&foo;&bar;]]></root>')
                preservesCDataSections: true;
                parseDocument.
doc root firstNode
produces:
 <![CDATA[&foo;&bar;]]>


_______________________________________________
Pharo-project mailing list
[email protected]
http://lists.gforge.inria.fr/cgi-bin/mailman/listinfo/pharo-project

Reply via email to