hixie: Clarify DOMTokenList's case-sensitivity. (whatwg r3388)

hixie: Clarify DOMTokenList's case-sensitivity. (whatwg r3388)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.2518&r2=1.2519&f=h
http://html5.org/tools/web-apps-tracker?from=3387&to=3388

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2518
retrieving revision 1.2519
diff -u -d -r1.2518 -r1.2519
--- Overview.html 12 Jul 2009 06:58:16 -0000 1.2518
+++ Overview.html 13 Jul 2009 03:15:21 -0000 1.2519
@@ -63,6 +63,7 @@
    a .diff-new { border-bottom: 1px blue solid; }
 
    h2 { page-break-before: always; }
+   h1, h2, h3, h4, h5, h6 { page-break-after: avoid; }
    h1 + h2, hr + h2.no-toc { page-break-before: auto; }
 
    p > span:not([title=""]):not([class="XXX"]):not([class="impl"]), li > span:not([title=""]):not([class="XXX"]):not([class="impl"]) { border-bottom: solid #9999CC; }
@@ -174,7 +175,7 @@
    <h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
    <!--ZZZ:-->
    <!--<h2 class="no-num no-toc">W3C Working Draft 23 April 2009</h2>-->
-   <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 12 July 2009</h2>
+   <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 13 July 2009</h2>
    <!--:ZZZ-->
    <dl><!-- ZZZ: update the month/day (twice), (un)comment out
     <dt>This Version:</dt>
@@ -267,7 +268,7 @@
   track.
   <!--ZZZ:-->
   <!--This specification is the 23 April 2009 Working Draft.-->
-  This specification is the 12 July 2009 Editor's Draft.
+  This specification is the 13 July 2009 Editor's Draft.
   <!--:ZZZ-->
   </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>This specification is also being produced by the <a href="http://www.whatwg.org/">WHATWG</a>. The two specifications are
   identical from the table of contents onwards.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- context and rationale (required) --><p>This specification is intended to replace (be a new version of)
@@ -5231,7 +5232,9 @@
   unique space-separated tokens</a>.<p class="note">While the order of the tokens in the underlying
   string is not important, the <code><a href="#domtokenlist-0">DOMTokenList</a></code> interfaces
   preserves the underlying order for consistency between
-  implementations.<pre class="idl">[<a href="#dom-tokenlist-tostring" title="dom-tokenlist-toString">Stringifies</a>] interface <dfn id="domtokenlist-0">DOMTokenList</dfn> {
+  implementations.<p class="note"><code><a href="#domtokenlist-0">DOMTokenList</a></code> objects are always
+  <a href="#case-sensitive">case-sensitive</a>, even when the underlying string might
+  ordinarily be treated in a case-insensitive manner.<pre class="idl">[<a href="#dom-tokenlist-tostring" title="dom-tokenlist-toString">Stringifies</a>] interface <dfn id="domtokenlist-0">DOMTokenList</dfn> {
   readonly attribute unsigned long <a href="#dom-tokenlist-length" title="dom-tokenlist-length">length</a>;
   [IndexGetter] DOMString <a href="#dom-tokenlist-item" title="dom-tokenlist-item">item</a>(in unsigned long index);
   boolean <a href="#dom-tokenlist-contains" title="dom-tokenlist-contains">contains</a>(in DOMString token);
@@ -5246,7 +5249,7 @@
    <dt><var title="">element</var> = <var title="">tokenlist</var> . <code title="dom-tokenlist-item"><a href="#dom-tokenlist-item">item</a></code>(<var title="">index</var>)</dt>
    <dt><var title="">tokenlist</var>[<var title="">index</var>]</dt>
    <dd>
-    <p>Returns the token with index <var title="">index</var>. The tokens are sorted alphabetically.</p>
+    <p>Returns the token with index <var title="">index</var>. The tokens are returned in the order they are found in the underlying string, with duplicates removed.</p>
     <p>Returns null if <var title="">index</var> is out of range.</p>
    </dd>
 
@@ -5307,9 +5310,10 @@
    underlying string on spaces</a> to get the list of tokens in the
    object's underlying string.</li>
 
-   <li>If the token indicated by <var title="">token</var> is one of
-   the tokens in the object's underlying string then return true and
-   stop this algorithm.</li>
+   <li>If the token indicated by <var title="">token</var> is a
+   <a href="#case-sensitive">case-sensitive</a> match for one of the tokens in the
+   object's underlying string then return true and stop this
+   algorithm.</li>
 
    <li>Otherwise, return false.</li>
 
@@ -5324,9 +5328,10 @@
    underlying string on spaces</a> to get the list of tokens in the
    object's underlying string.</li>
 
-   <li>If the given <var title="">token</var> is already one of the
-   tokens in the <code><a href="#domtokenlist-0">DOMTokenList</a></code> object's underlying string
-   then stop the algorithm.</li>
+   <li>If the given <var title="">token</var> is a
+   <a href="#case-sensitive">case-sensitive</a> match for one of the tokens in the
+   <code><a href="#domtokenlist-0">DOMTokenList</a></code> object's underlying string then stop the
+   algorithm.</li>
 
    <li>Otherwise, if the <code><a href="#domtokenlist-0">DOMTokenList</a></code> object's underlying
    string is not the empty string and the last character of that
@@ -5358,11 +5363,10 @@
    underlying string on spaces</a> to get the list of tokens in the
    object's underlying string.</li>
 
-   <li>If the given <var title="">token</var> is already one of the
-   tokens in the <code><a href="#domtokenlist-0">DOMTokenList</a></code> object's underlying string
-   then <a href="#remove-a-token-from-a-string" title="remove a token from a string">remove the given
-   <var title="">token</var> from the underlying string</a>, and
-   stop the algorithm, returning false.</li>
+   <li>If the given <var title="">token</var> is a
+   <a href="#case-sensitive">case-sensitive</a> match for one of the tokens in the
+   <code><a href="#domtokenlist-0">DOMTokenList</a></code> object's underlying string then <a href="#remove-a-token-from-a-string" title="remove a token from a string">remove the given <var title="">token</var> from the underlying string</a> and stop the
+   algorithm, returning false.</li>
 
    <li>Otherwise, if the <code><a href="#domtokenlist-0">DOMTokenList</a></code> object's underlying
    string is not the empty string and the last character of that

Received on Monday, 13 July 2009 03:16:31 UTC