[e] (0) editorial cleanup; reference collection

git-svn-id: http://svn.whatwg.org/webapps@3248 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Jun 15, 2009 · 06fd1e5 · 06fd1e5
1 parent 8bf2df0
commit 06fd1e5
Show file tree

Hide file tree

Showing 2 changed files with 15 additions and 17 deletions.
diff --git a/index b/index
@@ -39,7 +39,7 @@
   <div class=head>
    <p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
    <h1>HTML 5</h1>
-   <h2 class="no-num no-toc" id=draft-standard-&mdash;-date:-01-jan-1901>Draft Standard &mdash; 14 June 2009</h2>
+   <h2 class="no-num no-toc" id=draft-standard-&mdash;-date:-01-jan-1901>Draft Standard &mdash; 15 June 2009</h2>
    <p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
    <p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
    <dl><dt>Multiple-page version:</dt>
@@ -5140,7 +5140,7 @@
   </ol><p>On setting, if the given element has an <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute, then the content attribute must
   be set to the value of that <code title=attr-id><a href=#the-id-attribute>id</a></code>
   attribute. Otherwise, the DOM attribute must be set to the empty
-  string.</p><!-- XXX or raise an exception? -->
+  string.</p>
 
   </div>
 
@@ -5186,7 +5186,8 @@
   <p>The <code><a href=#htmlcollection-0>HTMLCollection</a></code> interface represents a generic
   <a href=#collections-0 title=collections>collection</a> of elements.</p>
 
-  <!-- XXX IE does [Callable] with magic that calls item() or namedItem() as appropriate as if it were a regular [[Get]] -->
+  <!-- IE does [Callable] with magic that calls item() or namedItem() as appropriate as if it were a regular [[Get]],
+       so we might need to change this for compat. However, WebIDL doesn't support that for now. -->
   <pre class=idl>[Callable=<a href=#dom-htmlcollection-nameditem title=dom-HTMLCollection-namedItem>namedItem</a>]
 interface <dfn id=htmlcollection-0>HTMLCollection</dfn> {
   readonly attribute unsigned long <a href=#dom-htmlcollection-length title=dom-HTMLCollection-length>length</a>;
@@ -5512,7 +5513,7 @@ interface <dfn id=htmloptionscollection-0>HTMLOptionsCollection</dfn> {
    <li>Otherwise, if there are no nodes in the collection that have
    either an <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute or a <code title=attr-option-name>name</code> attribute equal to <var title="">name</var>, then return null and stop the algorithm.</li>
 
-   <!-- XXX should we return an HTMLCollection instead, like IE? -->
+   <!-- IE returns an HTMLCollection instead; we may need to change to that for compat -->
    <li>Otherwise, create a <code>NodeList</code> object representing a
    live view of the <code><a href=#htmloptionscollection-0>HTMLOptionsCollection</a></code> object, further
    filtered so that the only nodes in the <code>NodeList</code> object
@@ -6102,8 +6103,6 @@ interface <dfn id=domstringmap-0>DOMStringMap</dfn> {};</pre>
   <p>The following <code>DOMException</code> codes are defined in DOM
   Core. <a href=#refsDOMCORE>[DOMCORE]</a></p>
 
-  <!-- XXX xref all these exceptions to DOM3CORE -->
-
   <ol class=brief><li value=1><dfn id=index_size_err><code>INDEX_SIZE_ERR</code></dfn></li>
    <li value=2><dfn id=domstring_size_err><code>DOMSTRING_SIZE_ERR</code></dfn></li>
    <li value=3><dfn id=hierarchy_request_err><code>HIERARCHY_REQUEST_ERR</code></dfn></li>
@@ -6550,8 +6549,7 @@ interface <dfn id=htmldocument>HTMLDocument</dfn> {
   encoding">character encoding</dfn>. When a <code>Document</code>
   object is created, the <a href="#document's-character-encoding">document's character encoding</a>
   must be initialized to UTF-16. Various algorithms during page
-  loading affect this value, as does the <code title=dom-document-charset><a href=#dom-document-charset>charset</a></code> setter. <a href=#refsIANACHARSET>[IANACHARSET]</a> <!-- XXX
-  http://www.iana.org/assignments/character-sets --></p>
+  loading affect this value, as does the <code title=dom-document-charset><a href=#dom-document-charset>charset</a></code> setter. <a href=#refsIANACHARSET>[IANACHARSET]</a></p>
 
   <p>The <dfn id=dom-document-charset title=dom-document-charset><code>charset</code></dfn>
   DOM attribute must, on getting, return the preferred MIME name of
@@ -69938,14 +69936,15 @@ S SPACER STRIKE TT U -->
 
   <!-- REFS
 
-  [BIG5] http://en.wikipedia.org/wiki/Big5
+  [BIG5] Institute for Information Industry, "Chinese Coded Character Set in Computer ", March, 1984
   [COMPUTABLE] On computable numbers, with an application to the Entscheidungsproblem. Alan M. Turing. In Proceedings of the London Mathematical Society, series 2, volume 42, pages 230-265. London Mathematical Society, 1937. http://www.turingarchive.org/browse.php/B/12 (referenced: 2007-03-03)
   [EUCKR] Korea Industrial Standards Association, "Hangul Unix Environment," Korean Industrial Standard, 1992, Ref. No. KS C 5861-1992.
   [GBK] http://www.iana.org/assignments/charset-reg/GBK
 
   <dd id="refsGREGORIAN">[GREGORIAN]</dd>
   <dd>(Non-normative) <cite>Inter Gravissimas</cite>, A. Lilius, C. Clavius. Gregory XIII Papal Bulls, February 1582.</dd>
 
+  [IANACHARSET] http://www.iana.org/assignments/character-sets
   [ISO885911] http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=28263
   [RFC1345] Simonsen, K., "Character Mnemonics & Character Sets", RFC 1345, Rationel Almen Planlaegning, Rationel Almen Planlaegning, June 1992.
   [SHIFTJIS] JIS X0208:1997

diff --git a/source b/source
@@ -4797,7 +4797,7 @@
   title="attr-id">id</code> attribute, then the content attribute must
   be set to the value of that <code title="attr-id">id</code>
   attribute. Otherwise, the DOM attribute must be set to the empty
-  string.</p><!-- XXX or raise an exception? -->
+  string.</p>
 
   </div>
 
@@ -4845,7 +4845,8 @@
   <p>The <code>HTMLCollection</code> interface represents a generic
   <span title="collections">collection</span> of elements.</p>
 
-  <!-- XXX IE does [Callable] with magic that calls item() or namedItem() as appropriate as if it were a regular [[Get]] -->
+  <!-- IE does [Callable] with magic that calls item() or namedItem() as appropriate as if it were a regular [[Get]],
+       so we might need to change this for compat. However, WebIDL doesn't support that for now. -->
   <pre class="idl">[Callable=<span title="dom-HTMLCollection-namedItem">namedItem</span>]
 interface <dfn>HTMLCollection</dfn> {
   readonly attribute unsigned long <span title="dom-HTMLCollection-length">length</span>;
@@ -5249,7 +5250,7 @@ interface <dfn>HTMLOptionsCollection</dfn> {
    title="attr-option-name">name</code> attribute equal to <var
    title="">name</var>, then return null and stop the algorithm.</li>
 
-   <!-- XXX should we return an HTMLCollection instead, like IE? -->
+   <!-- IE returns an HTMLCollection instead; we may need to change to that for compat -->
    <li>Otherwise, create a <code>NodeList</code> object representing a
    live view of the <code>HTMLOptionsCollection</code> object, further
    filtered so that the only nodes in the <code>NodeList</code> object
@@ -5953,8 +5954,6 @@ interface <dfn>DOMStringMap</dfn> {};</pre>
   <p>The following <code>DOMException</code> codes are defined in DOM
   Core. <a href="#refsDOMCORE">[DOMCORE]</a></p>
 
-  <!-- XXX xref all these exceptions to DOM3CORE -->
-
   <ol class="brief">
    <li value="1"><dfn><code>INDEX_SIZE_ERR</code></dfn></li>
    <li value="2"><dfn><code>DOMSTRING_SIZE_ERR</code></dfn></li>
@@ -6464,8 +6463,7 @@ interface <dfn>HTMLDocument</dfn> {
   must be initialized to UTF-16. Various algorithms during page
   loading affect this value, as does the <code
   title="dom-document-charset">charset</code> setter. <a
-  href="#refsIANACHARSET">[IANACHARSET]</a> <!-- XXX
-  http://www.iana.org/assignments/character-sets --></p>
+  href="#refsIANACHARSET">[IANACHARSET]</a></p>
 
   <p>The <dfn title="dom-document-charset"><code>charset</code></dfn>
   DOM attribute must, on getting, return the preferred MIME name of
@@ -82484,14 +82482,15 @@ S SPACER STRIKE TT U -->
 
   <!-- REFS
 
-  [BIG5] http://en.wikipedia.org/wiki/Big5
+  [BIG5] Institute for Information Industry, "Chinese Coded Character Set in Computer ", March, 1984
   [COMPUTABLE] On computable numbers, with an application to the Entscheidungsproblem. Alan M. Turing. In Proceedings of the London Mathematical Society, series 2, volume 42, pages 230-265. London Mathematical Society, 1937. http://www.turingarchive.org/browse.php/B/12 (referenced: 2007-03-03)
   [EUCKR] Korea Industrial Standards Association, "Hangul Unix Environment," Korean Industrial Standard, 1992, Ref. No. KS C 5861-1992.
   [GBK] http://www.iana.org/assignments/charset-reg/GBK
 
   <dd id="refsGREGORIAN">[GREGORIAN]</dd>
   <dd>(Non-normative) <cite>Inter Gravissimas</cite>, A. Lilius, C. Clavius. Gregory XIII Papal Bulls, February 1582.</dd>
 
+  [IANACHARSET] http://www.iana.org/assignments/character-sets
   [ISO885911] http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=28263
   [RFC1345] Simonsen, K., "Character Mnemonics & Character Sets", RFC 1345, Rationel Almen Planlaegning, Rationel Almen Planlaegning, June 1992.
   [SHIFTJIS] JIS X0208:1997