W3C home > Mailing lists > Public > public-html-commits@w3.org > June 2009

html5/spec Overview.html,1.2401,1.2402

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Mon, 15 Jun 2009 19:24:12 +0000
To: public-html-commits@w3.org
Message-Id: <E1MGHmu-0004qI-EX@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv18580

Modified Files:
	Overview.html 
Log Message:
Make DOMTokenList be sorted by the underlying string only. (whatwg r3254)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2401
retrieving revision 1.2402
diff -u -d -r1.2401 -r1.2402
--- Overview.html	15 Jun 2009 18:54:32 -0000	1.2401
+++ Overview.html	15 Jun 2009 19:24:09 -0000	1.2402
@@ -5113,7 +5113,7 @@
   to an underlying string that consists of an <a href="#unordered-set-of-unique-space-separated-tokens">unordered set of
   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
-  exposes the tokens in a well-defined order for consistency between
+  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> {
   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);
@@ -5173,13 +5173,15 @@
   there are no <span>supported indexed properties</span>.</p>
 
   <p>The <dfn id="dom-tokenlist-item" title="dom-tokenlist-item"><code>item(<var title="">index</var>)</code></dfn> method must <a href="#split-a-string-on-spaces" title="split a
-  string on spaces">split the underlying string on spaces</a>, sort
-  the resulting list of tokens by Unicode code point<!-- XXX that's
-  basically nonsense. What sort order do we want here? It should be
-  the cheapest one possible that is well-defined for all Unicode. -->,
-  remove exact duplicates, and then return the <var title="">index</var>th item in this list. If <var title="">index</var> is equal to or greater than the number of
+  string on spaces">split the underlying string on spaces</a>,
+  preserving the order of the tokens as found in the underlying
+  string, remove instances of exact duplicates other than the first
+  instance in each case, and then return the <var title="">index</var>th item in this list. If <var title="">index</var> is equal to or greater than the number of
   tokens, then the method must return null.</p>
 
+  <p class="example">For example, if the string is "<code title="">a b
+  a c</code>" then there are three tokens: the token with index 0 is
+  "<code title="">a</code>", the token with index 1 is "<code title="">b</code>", and the token with index 2 is "<code title="">c</code>".</p>
 
   <p>The <dfn id="dom-tokenlist-has" title="dom-tokenlist-has"><code>has(<var title="">token</var>)</code></dfn> method must run the following
   algorithm:</p>
Received on Monday, 15 June 2009 19:24:17 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 15 June 2009 19:24:18 GMT