[html5] r7307 - [e] (0) Clean up the Collections section, e.g. avoid the normatively-significant [...]
whatwg at whatwg.org
whatwg at whatwg.org
Fri Aug 31 17:10:23 PDT 2012
Author: ianh
Date: 2012-08-31 17:10:22 -0700 (Fri, 31 Aug 2012)
New Revision: 7307
Modified:
complete.html
index
source
Log:
[e] (0) Clean up the Collections section, e.g. avoid the normatively-significant word 'represents'.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=17194
Affected topics: DOM APIs, Microdata
Modified: complete.html
===================================================================
--- complete.html 2012-08-31 23:57:08 UTC (rev 7306)
+++ complete.html 2012-09-01 00:10:22 UTC (rev 7307)
@@ -246,7 +246,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 31 August 2012</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 1 September 2012</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -9117,13 +9117,13 @@
<h5 id=htmlallcollection-0><span class=secno>2.8.2.1 </span>HTMLAllCollection</h5>
- <p>The <code><a href=#htmlallcollection>HTMLAllCollection</a></code> interface represents a generic
- <a href=#collections title=collections>collection</a> of elements just like
+ <p>The <code><a href=#htmlallcollection>HTMLAllCollection</a></code> interface is used for generic
+ <a href=#collections>collections</a> of elements just like
<code><a href=#htmlcollection>HTMLCollection</a></code>, with the exception that its <code title=dom-HTMLAllCollection-namedItem><a href=#dom-htmlallcollection-nameditem>namedItem()</a></code> method
returns an <code><a href=#htmlallcollection>HTMLAllCollection</a></code> object when there are
multiple matching elements, and that its <code title=dom-HTMLAllCollection-item>item()</code> method can be used
- as a synonym for its <code title=dom-HTMLAllCollection-namedItem><a href=#dom-htmlallcollection-nameditem>namedItem()</a></code>
- method.</p>
+ as a synonym for its <code title=dom-HTMLAllCollection-namedItem><a href=#dom-htmlallcollection-nameditem>namedItem()</a></code> method.
+ It is intended only for the legacy <code title=dom-document-all><a href=#dom-document-all>document.all</a></code> attribute.</p>
<pre class=idl>interface <dfn id=htmlallcollection>HTMLAllCollection</dfn> : <a href=#htmlcollection>HTMLCollection</a> {
// inherits <span title=dom-HTMLCollection-length>length</span> and <span title=dom-HTMLCollection-item>item</span>(unsigned long index)
@@ -9223,9 +9223,10 @@
<h5 id=htmlformcontrolscollection-0><span class=secno>2.8.2.2 </span>HTMLFormControlsCollection</h5>
- <p>The <code><a href=#htmlformcontrolscollection>HTMLFormControlsCollection</a></code> interface represents
- a <a href=#collections title=collections>collection</a> of <a href=#category-listed title=category-listed>listed elements</a> in <code><a href=#the-form-element>form</a></code>
- and <code><a href=#the-fieldset-element>fieldset</a></code> elements.</p>
+ <p>The <code><a href=#htmlformcontrolscollection>HTMLFormControlsCollection</a></code> interface is used for
+ <a href=#collections>collections</a> of <a href=#category-listed title=category-listed>listed
+ elements</a> in <code><a href=#the-form-element>form</a></code> and <code><a href=#the-fieldset-element>fieldset</a></code>
+ elements.</p>
<pre class=idl>interface <dfn id=htmlformcontrolscollection>HTMLFormControlsCollection</dfn> : <a href=#htmlcollection>HTMLCollection</a> {
// inherits <span title=dom-HTMLCollection-length>length</span> and <span title=dom-HTMLCollection-item>item</span>()
@@ -9337,10 +9338,10 @@
<h5 id=htmloptionscollection-0><span class=secno>2.8.2.3 </span>HTMLOptionsCollection</h5>
- <p>The <code><a href=#htmloptionscollection>HTMLOptionsCollection</a></code> interface represents a
- list of <code><a href=#the-option-element>option</a></code> elements. It is always rooted on a
- <code><a href=#the-select-element>select</a></code> element and has attributes and methods that
- manipulate that element's descendants.</p>
+ <p>The <code><a href=#htmloptionscollection>HTMLOptionsCollection</a></code> interface is used for
+ <a href=#collections>collections</a> of <code><a href=#the-option-element>option</a></code> elements. It is
+ always rooted on a <code><a href=#the-select-element>select</a></code> element and has attributes
+ and methods that manipulate that element's descendants.</p>
<pre class=idl>interface <dfn id=htmloptionscollection>HTMLOptionsCollection</dfn> : <a href=#htmlcollection>HTMLCollection</a> {
// inherits <span title=dom-HTMLCollection-item>item</span>()
@@ -9531,14 +9532,13 @@
</div>
-<!--MD-->
- <div data-component="HTML Microdata (editor: Ian Hickson)"><!--TOPIC:Microdata-->
+<!--TOPIC:Microdata-->
<h5 id=htmlpropertiescollection-0><span class=secno>2.8.2.4 </span>HTMLPropertiesCollection</h5>
- <p>The <code><a href=#htmlpropertiescollection>HTMLPropertiesCollection</a></code> interface represents a
- <a href=#collections title=collections>collection</a> of elements that add
- name-value pairs to a particular <a href=#concept-item title=concept-item>item</a> in the <a href=#microdata>microdata</a>
+ <p>The <code><a href=#htmlpropertiescollection>HTMLPropertiesCollection</a></code> interface is used for
+ <a href=#collections>collections</a> of elements that add <a href=#the-properties-of-an-item title="the
+ properties of an item">name-value pairs</a> to a particular <a href=#concept-item title=concept-item>item</a> in the <a href=#microdata>microdata</a>
model.</p>
<pre class=idl>interface <dfn id=htmlpropertiescollection>HTMLPropertiesCollection</dfn> : <a href=#htmlcollection>HTMLCollection</a> {
@@ -9621,9 +9621,7 @@
</div>
- </div><!--data-component-->
-
<!--TOPIC:DOM APIs-->
<h4 id=domstringmap-0><span class=secno>2.8.3 </span>DOMStringMap</h4>
Modified: index
===================================================================
--- index 2012-08-31 23:57:08 UTC (rev 7306)
+++ index 2012-09-01 00:10:22 UTC (rev 7307)
@@ -246,7 +246,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 31 August 2012</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 1 September 2012</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -9117,13 +9117,13 @@
<h5 id=htmlallcollection-0><span class=secno>2.8.2.1 </span>HTMLAllCollection</h5>
- <p>The <code><a href=#htmlallcollection>HTMLAllCollection</a></code> interface represents a generic
- <a href=#collections title=collections>collection</a> of elements just like
+ <p>The <code><a href=#htmlallcollection>HTMLAllCollection</a></code> interface is used for generic
+ <a href=#collections>collections</a> of elements just like
<code><a href=#htmlcollection>HTMLCollection</a></code>, with the exception that its <code title=dom-HTMLAllCollection-namedItem><a href=#dom-htmlallcollection-nameditem>namedItem()</a></code> method
returns an <code><a href=#htmlallcollection>HTMLAllCollection</a></code> object when there are
multiple matching elements, and that its <code title=dom-HTMLAllCollection-item>item()</code> method can be used
- as a synonym for its <code title=dom-HTMLAllCollection-namedItem><a href=#dom-htmlallcollection-nameditem>namedItem()</a></code>
- method.</p>
+ as a synonym for its <code title=dom-HTMLAllCollection-namedItem><a href=#dom-htmlallcollection-nameditem>namedItem()</a></code> method.
+ It is intended only for the legacy <code title=dom-document-all><a href=#dom-document-all>document.all</a></code> attribute.</p>
<pre class=idl>interface <dfn id=htmlallcollection>HTMLAllCollection</dfn> : <a href=#htmlcollection>HTMLCollection</a> {
// inherits <span title=dom-HTMLCollection-length>length</span> and <span title=dom-HTMLCollection-item>item</span>(unsigned long index)
@@ -9223,9 +9223,10 @@
<h5 id=htmlformcontrolscollection-0><span class=secno>2.8.2.2 </span>HTMLFormControlsCollection</h5>
- <p>The <code><a href=#htmlformcontrolscollection>HTMLFormControlsCollection</a></code> interface represents
- a <a href=#collections title=collections>collection</a> of <a href=#category-listed title=category-listed>listed elements</a> in <code><a href=#the-form-element>form</a></code>
- and <code><a href=#the-fieldset-element>fieldset</a></code> elements.</p>
+ <p>The <code><a href=#htmlformcontrolscollection>HTMLFormControlsCollection</a></code> interface is used for
+ <a href=#collections>collections</a> of <a href=#category-listed title=category-listed>listed
+ elements</a> in <code><a href=#the-form-element>form</a></code> and <code><a href=#the-fieldset-element>fieldset</a></code>
+ elements.</p>
<pre class=idl>interface <dfn id=htmlformcontrolscollection>HTMLFormControlsCollection</dfn> : <a href=#htmlcollection>HTMLCollection</a> {
// inherits <span title=dom-HTMLCollection-length>length</span> and <span title=dom-HTMLCollection-item>item</span>()
@@ -9337,10 +9338,10 @@
<h5 id=htmloptionscollection-0><span class=secno>2.8.2.3 </span>HTMLOptionsCollection</h5>
- <p>The <code><a href=#htmloptionscollection>HTMLOptionsCollection</a></code> interface represents a
- list of <code><a href=#the-option-element>option</a></code> elements. It is always rooted on a
- <code><a href=#the-select-element>select</a></code> element and has attributes and methods that
- manipulate that element's descendants.</p>
+ <p>The <code><a href=#htmloptionscollection>HTMLOptionsCollection</a></code> interface is used for
+ <a href=#collections>collections</a> of <code><a href=#the-option-element>option</a></code> elements. It is
+ always rooted on a <code><a href=#the-select-element>select</a></code> element and has attributes
+ and methods that manipulate that element's descendants.</p>
<pre class=idl>interface <dfn id=htmloptionscollection>HTMLOptionsCollection</dfn> : <a href=#htmlcollection>HTMLCollection</a> {
// inherits <span title=dom-HTMLCollection-item>item</span>()
@@ -9531,14 +9532,13 @@
</div>
-<!--MD-->
- <div data-component="HTML Microdata (editor: Ian Hickson)"><!--TOPIC:Microdata-->
+<!--TOPIC:Microdata-->
<h5 id=htmlpropertiescollection-0><span class=secno>2.8.2.4 </span>HTMLPropertiesCollection</h5>
- <p>The <code><a href=#htmlpropertiescollection>HTMLPropertiesCollection</a></code> interface represents a
- <a href=#collections title=collections>collection</a> of elements that add
- name-value pairs to a particular <a href=#concept-item title=concept-item>item</a> in the <a href=#microdata>microdata</a>
+ <p>The <code><a href=#htmlpropertiescollection>HTMLPropertiesCollection</a></code> interface is used for
+ <a href=#collections>collections</a> of elements that add <a href=#the-properties-of-an-item title="the
+ properties of an item">name-value pairs</a> to a particular <a href=#concept-item title=concept-item>item</a> in the <a href=#microdata>microdata</a>
model.</p>
<pre class=idl>interface <dfn id=htmlpropertiescollection>HTMLPropertiesCollection</dfn> : <a href=#htmlcollection>HTMLCollection</a> {
@@ -9621,9 +9621,7 @@
</div>
- </div><!--data-component-->
-
<!--TOPIC:DOM APIs-->
<h4 id=domstringmap-0><span class=secno>2.8.3 </span>DOMStringMap</h4>
Modified: source
===================================================================
--- source 2012-08-31 23:57:08 UTC (rev 7306)
+++ source 2012-09-01 00:10:22 UTC (rev 7307)
@@ -9125,16 +9125,17 @@
<h5>HTMLAllCollection</h5>
- <p>The <code>HTMLAllCollection</code> interface represents a generic
- <span title="collections">collection</span> of elements just like
+ <p>The <code>HTMLAllCollection</code> interface is used for generic
+ <span>collections</span> of elements just like
<code>HTMLCollection</code>, with the exception that its <code
title="dom-HTMLAllCollection-namedItem">namedItem()</code> method
returns an <code>HTMLAllCollection</code> object when there are
multiple matching elements, and that its <code
title="dom-HTMLAllCollection-item">item()</code> method can be used
as a synonym for its <code
- title="dom-HTMLAllCollection-namedItem">namedItem()</code>
- method.</p>
+ title="dom-HTMLAllCollection-namedItem">namedItem()</code> method.
+ It is intended only for the legacy <code
+ title="dom-document-all">document.all</code> attribute.</p>
<pre class="idl">interface <dfn>HTMLAllCollection</dfn> : <span>HTMLCollection</span> {
// inherits <span title="dom-HTMLCollection-length">length</span> and <span title="dom-HTMLCollection-item">item</span>(unsigned long index)
@@ -9253,10 +9254,10 @@
<h5>HTMLFormControlsCollection</h5>
- <p>The <code>HTMLFormControlsCollection</code> interface represents
- a <span title="collections">collection</span> of <span
- title="category-listed">listed elements</span> in <code>form</code>
- and <code>fieldset</code> elements.</p>
+ <p>The <code>HTMLFormControlsCollection</code> interface is used for
+ <span>collections</span> of <span title="category-listed">listed
+ elements</span> in <code>form</code> and <code>fieldset</code>
+ elements.</p>
<pre class="idl">interface <dfn>HTMLFormControlsCollection</dfn> : <span>HTMLCollection</span> {
// inherits <span title="dom-HTMLCollection-length">length</span> and <span title="dom-HTMLCollection-item">item</span>()
@@ -9398,10 +9399,10 @@
<h5>HTMLOptionsCollection</h5>
- <p>The <code>HTMLOptionsCollection</code> interface represents a
- list of <code>option</code> elements. It is always rooted on a
- <code>select</code> element and has attributes and methods that
- manipulate that element's descendants.</p>
+ <p>The <code>HTMLOptionsCollection</code> interface is used for
+ <span>collections</span> of <code>option</code> elements. It is
+ always rooted on a <code>select</code> element and has attributes
+ and methods that manipulate that element's descendants.</p>
<pre class="idl">interface <dfn>HTMLOptionsCollection</dfn> : <span>HTMLCollection</span> {
// inherits <span title="dom-HTMLCollection-item">item</span>()
@@ -9648,16 +9649,13 @@
</div>
-<!--END w3c-html--><!--MD-->
- <div data-component="HTML Microdata (editor: Ian Hickson)"><!--TOPIC:Microdata-->
-<!--START microdata-->
-<!--FIXUP microdata -1-->
+
+<!--TOPIC:Microdata-->
<h5>HTMLPropertiesCollection</h5>
-<!--FIXUP microdata +1-->
- <p>The <code>HTMLPropertiesCollection</code> interface represents a
- <span title="collections">collection</span> of elements that add
- name-value pairs to a particular <span
+ <p>The <code>HTMLPropertiesCollection</code> interface is used for
+ <span>collections</span> of elements that add <span title="the
+ properties of an item">name-value pairs</span> to a particular <span
title="concept-item">item</span> in the <span>microdata</span>
model.</p>
@@ -9754,8 +9752,6 @@
order</span>.</p>
</div>
-<!--END microdata-->
- </div><!--data-component-->
<!--TOPIC:DOM APIs-->
More information about the Commit-Watchers
mailing list