Skip to content

Commit

Permalink
[e] (0) Clean up the Collections section, e.g. avoid the normatively-…
Browse files Browse the repository at this point in the history 
…significant word 'represents'.

Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=17194
Affected topics: DOM APIs, Microdata

git-svn-id: http://svn.whatwg.org/webapps@7307 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Sep 1, 2012
1 parent b4ba9a5 commit 89bcd9d
Show file tree
Hide file tree
Showing 3 changed files with 52 additions and 60 deletions.
36 changes: 17 additions & 19 deletions complete.html
View file
Expand Up @@ -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 &mdash; Last Updated 31 August 2012</h2>
<h2 class="no-num no-toc">Living Standard &mdash; 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>
Expand Down Expand Up @@ -9117,13 +9117,13 @@ <h4 id=collections-0><span class=secno>2.8.2 </span>Collections</h4>

<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)
Expand Down Expand Up @@ -9223,9 +9223,10 @@ <h5 id=htmlallcollection-0><span class=secno>2.8.2.1 </span>HTMLAllCollection</h

<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>()
Expand Down Expand Up @@ -9337,10 +9338,10 @@ <h5 id=htmlformcontrolscollection-0><span class=secno>2.8.2.2 </span>HTMLFormCon

<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>()
Expand Down Expand Up @@ -9531,14 +9532,13 @@ <h5 id=htmloptionscollection-0><span class=secno>2.8.2.3 </span>HTMLOptionsColle

</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> {
Expand Down Expand Up @@ -9621,8 +9621,6 @@ <h5 id=htmlpropertiescollection-0><span class=secno>2.8.2.4 </span>HTMLPropertie

</div>

</div><!--data-component-->


<!--TOPIC:DOM APIs-->
<h4 id=domstringmap-0><span class=secno>2.8.3 </span>DOMStringMap</h4>
Expand Down
36 changes: 17 additions & 19 deletions index
View file
Expand Up @@ -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 &mdash; Last Updated 31 August 2012</h2>
<h2 class="no-num no-toc">Living Standard &mdash; 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>
Expand Down Expand Up @@ -9117,13 +9117,13 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d

<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)
Expand Down Expand Up @@ -9223,9 +9223,10 @@ a.setAttribute('href', 'http://example.com/'); // change the content attribute d

<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>()
Expand Down Expand Up @@ -9337,10 +9338,10 @@ http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20html%3E..

<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>()
Expand Down Expand Up @@ -9531,14 +9532,13 @@ http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20html%3E..

</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> {
Expand Down Expand Up @@ -9621,8 +9621,6 @@ interface <dfn id=propertynodelist>PropertyNodeList</dfn> : <a href=#nodelist>No

</div>

</div><!--data-component-->


<!--TOPIC:DOM APIs-->
<h4 id=domstringmap-0><span class=secno>2.8.3 </span>DOMStringMap</h4>
Expand Down
40 changes: 18 additions & 22 deletions source
View file
Expand Up @@ -9125,16 +9125,17 @@ is conforming depends on which specs apply, and leaves it at that. -->

<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)
Expand Down Expand Up @@ -9253,10 +9254,10 @@ is conforming depends on which specs apply, and leaves it at that. -->

<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>()
Expand Down Expand Up @@ -9398,10 +9399,10 @@ http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20html%3E..

<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>()
Expand Down Expand Up @@ -9648,16 +9649,13 @@ http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20html%3E..

</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>

Expand Down Expand Up @@ -9754,8 +9752,6 @@ interface <dfn>PropertyNodeList</dfn> : <span>NodeList</span> {
order</span>.</p>

</div>
<!--END microdata-->
</div><!--data-component-->


<!--TOPIC:DOM APIs-->
Expand Down

0 comments on commit 89bcd9d

Please sign in to comment.