- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Sat, 04 Oct 2008 01:28:30 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv27542
Modified Files:
Overview.html
Log Message:
fiddle with some wording for consistency. (whatwg r2281)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1453
retrieving revision 1.1454
diff -u -d -r1.1453 -r1.1454
--- Overview.html 4 Oct 2008 01:21:43 -0000 1.1453
+++ Overview.html 4 Oct 2008 01:28:27 -0000 1.1454
@@ -6447,8 +6447,8 @@
any elements in the tree that represent <a href=#hyperlink title=hyperlink>hyperlinks</a>.<p class=note>If there are multiple <code><a href=#the-base-element>base</a></code> elements
with <code title=attr-base-target><a href=#attr-base-target>target</a></code> attributes, all but
the first are ignored.<p>The <dfn id=dom-base-href title=dom-base-href><code>href</code></dfn> and <dfn id=dom-base-target title=dom-base-target><code>target</code></dfn> DOM attributes
- must <a href=#reflect>reflect</a> the content attributes of the same
- name.<h4 id=the-link-element><span class=secno>4.2.4 </span>The <dfn><code>link</code></dfn> element</h4><dl class=element><dt>Categories</dt>
+ must <a href=#reflect>reflect</a> the respective content attributes of the
+ same name.<h4 id=the-link-element><span class=secno>4.2.4 </span>The <dfn><code>link</code></dfn> element</h4><dl class=element><dt>Categories</dt>
<dd><a href=#metadata-content-0>Metadata content</a>.</dd>
<dt>Contexts in which this element may be used:</dt>
<dd>Where <a href=#metadata-content-0>metadata content</a> is expected.</dd>
@@ -9361,7 +9361,7 @@
suffix</a></var>, then take that into account when following the
hyperlink.</li>
- </ol><p>The DOM attributes <dfn id=dom-a-href title=dom-a-href><code>href</code></dfn>, <dfn id=dom-a-ping title=dom-a-ping><code>ping</code></dfn>, <dfn id=dom-a-target title=dom-a-target><code>target</code></dfn>, <dfn id=dom-a-rel title=dom-a-rel><code>rel</code></dfn>, <dfn id=dom-a-media title=dom-a-media><code>media</code></dfn>, <dfn id=dom-a-hreflang title=dom-a-hreflang><code>hreflang</code></dfn>, and <dfn id=dom-a-type title=dom-a-type><code>type</code></dfn>, must each
+ </ol><p>The DOM attributes <dfn id=dom-a-href title=dom-a-href><code>href</code></dfn>, <dfn id=dom-a-ping title=dom-a-ping><code>ping</code></dfn>, <dfn id=dom-a-target title=dom-a-target><code>target</code></dfn>, <dfn id=dom-a-rel title=dom-a-rel><code>rel</code></dfn>, <dfn id=dom-a-media title=dom-a-media><code>media</code></dfn>, <dfn id=dom-a-hreflang title=dom-a-hreflang><code>hreflang</code></dfn>, and <dfn id=dom-a-type title=dom-a-type><code>type</code></dfn>, must
<a href=#reflect>reflect</a> the respective content attributes of the same
name.<p>The DOM attribute <dfn id=dom-a-rellist title=dom-a-rellist><code>relList</code></dfn> must
<a href=#reflect>reflect</a> the <code title=attr-hyperlink-rel><a href=#attr-hyperlink-rel>rel</a></code>
@@ -10157,7 +10157,7 @@
UA should indicate whether it is a determinate or indeterminate
progress bar, and in the former case, should indicate the relative
position of the current value relative to the maximum value.<p>The <dfn id=dom-progress-max title=dom-progress-max><code>max</code></dfn> and <dfn id=dom-progress-value title=dom-progress-value><code>value</code></dfn> DOM attributes
- must <a href=#reflect>reflect</a> the elements' content attributes of the
+ must <a href=#reflect>reflect</a> the respective content attributes of the
same name. When the relevant content attributes are absent, the DOM
attributes must return zero. The value parsed from the
<code><a href=#textcontent>textContent</a></code> never affects the DOM values.<p class=XXX>Would be cool to have the <code title=dom-progress-value><a href=#dom-progress-value>value</a></code> DOM attribute update the
@@ -10461,7 +10461,7 @@
saying "Value: 23.2 out of 60." on one line and "seconds" on a
second line.</p>
</div><p>The <dfn id=dom-meter-min title=dom-meter-min><code>min</code></dfn>, <dfn id=dom-meter-max title=dom-meter-max><code>max</code></dfn>, <dfn id=dom-meter-value title=dom-meter-value><code>value</code></dfn>, <dfn id=dom-meter-low title=dom-meter-low><code>low</code></dfn>, <dfn id=dom-meter-high title=dom-meter-high><code>high</code></dfn>, and <dfn id=dom-meter-optimum title=dom-meter-optimum><code>optimum</code></dfn> DOM attributes
- must <a href=#reflect>reflect</a> the elements' content attributes of the
+ must <a href=#reflect>reflect</a> the respective content attributes of the
same name. When the relevant content attributes are absent, the DOM
attributes must return zero. The value parsed from the
<code><a href=#textcontent>textContent</a></code> never affects the DOM values.<p class=XXX>Would be cool to have the <code title=dom-meter-value><a href=#dom-meter-value>value</a></code> DOM attribute update the
@@ -12562,7 +12562,8 @@
Gotta handle the XML case.
--><p class=note>The <a href=#html-parser>HTML parser</a> treats markup inside
<code><a href=#the-iframe-element>iframe</a></code> elements as text.<p>The DOM attributes <dfn id=dom-iframe-src title=dom-iframe-src><code>src</code></dfn>, <dfn id=dom-iframe-name title=dom-iframe-name><code>name</code></dfn>, <dfn id=dom-iframe-sandbox title=dom-iframe-sandbox><code>sandbox</code></dfn>, and <dfn id=dom-iframe-seamless title=dom-iframe-seamless><code>seamless</code></dfn> must
- <a href=#reflect>reflect</a> the content attributes of the same name.<h4 id=the-embed-element><span class=secno>4.8.4 </span>The <dfn><code>embed</code></dfn> element</h4><!--
+ <a href=#reflect>reflect</a> the respective content attributes of the same
+ name.<h4 id=the-embed-element><span class=secno>4.8.4 </span>The <dfn><code>embed</code></dfn> element</h4><!--
XXX we have all kinds of quirks we should define, as e.g. shown in:
http://mxr.mozilla.org/mozilla-central/source/layout/generic/nsObjectFrame.cpp
http://trac.webkit.org/browser/trunk/WebCore/html/HTMLEmbedElement.cpp
@@ -13583,7 +13584,8 @@
by the first suitable <code><a href=#the-source-element>source</a></code> element child of the
<a href=#media-element>media element</a> is the one used.<p>The <dfn id=dom-media-src title=dom-media-src><code>src</code></dfn> DOM
attribute on <a href=#media-element title="media element">media elements</a> must
- <a href=#reflect>reflect</a> the content attribute of the same name.<p>To <dfn id=pick-a-media-resource>pick a media resource</dfn> for a <a href=#media-element>media
+ <a href=#reflect>reflect</a> the respective content attribute of the same
+ name.<p>To <dfn id=pick-a-media-resource>pick a media resource</dfn> for a <a href=#media-element>media
element</a>, a user agent must use the following steps:<ol><li><p>Let the <var title="">chosen resource's pixel ratio
override</var> be <i>none</i>.</li>
@@ -14923,8 +14925,8 @@
and reinitialized with the newly specified coordinate space
dimensions.<p>The <dfn id=dom-canvas-width title=dom-canvas-width><code>width</code></dfn> and
<dfn id=dom-canvas-height title=dom-canvas-height><code>height</code></dfn> DOM
- attributes must <a href=#reflect>reflect</a> the content attributes of the
- same name.<div class=example>
+ attributes must <a href=#reflect>reflect</a> the respective content
+ attributes of the same name.<div class=example>
<p>Only one square appears to be drawn in the following example:</p>
<pre>
// canvas is a reference to a <canvas> element
@@ -16940,7 +16942,8 @@
parsing, returns no value, it must be treated, for the purposes of
those requirements, as if it was not specified.<p>The <dfn id=dom-dim-width title=dom-dim-width><code>width</code></dfn> and <dfn id=dom-dim-height title=dom-dim-height><code>height</code></dfn> DOM attributes on
the <code><a href=#the-embed-element>embed</a></code>, <code><a href=#the-object-element>object</a></code>, and <code><a href=#video>video</a></code>
- elements must <a href=#reflect>reflect</a> the content attributes of the same name.<h3 id=tabular-data><span class=secno>4.9 </span>Tabular data</h3><h4 id=table-intro><span class=secno>4.9.1 </span>Introduction</h4><p><em>This section is non-normative.</em><p class=XXX>...examples, how to write tables accessibly, a
+ elements must <a href=#reflect>reflect</a> the respective content attributes
+ of the same name.<h3 id=tabular-data><span class=secno>4.9 </span>Tabular data</h3><h4 id=table-intro><span class=secno>4.9.1 </span>Introduction</h4><p><em>This section is non-normative.</em><p class=XXX>...examples, how to write tables accessibly, a
brief mention of the table model, etc...<h4 id=the-table-element><span class=secno>4.9.2 </span>The <dfn><code>table</code></dfn> element</h4><dl class=element><dt>Categories</dt>
<dd><a href=#flow-content-0>Flow content</a>.</dd>
<dt>Contexts in which this element may be used:</dt>
@@ -17172,9 +17175,9 @@
specified, whose value must be a <a href=#valid-non-negative-integer>valid non-negative
integer</a> greater than zero.<p>The <code><a href=#the-colgroup-element>colgroup</a></code> element and its <code title=attr-colgroup-span><a href=#attr-colgroup-span>span</a></code> attribute take part in the
<a href=#table-model>table model</a>.<p>The <dfn id=dom-colgroup-span title=dom-colgroup-span><code>span</code></dfn> DOM
- attribute must <a href=#reflect>reflect</a> the content attribute of the
- same name. The value must be <a href=#limited-to-only-positive-non-zero-numbers>limited to only positive non-zero
- numbers</a>.<h4 id=the-col-element><span class=secno>4.9.5 </span>The <dfn><code>col</code></dfn> element</h4><dl class=element><dt>Categories</dt>
+ attribute must <a href=#reflect>reflect</a> the respective content attribute
+ of the same name. The value must be <a href=#limited-to-only-positive-non-zero-numbers>limited to only positive
+ non-zero numbers</a>.<h4 id=the-col-element><span class=secno>4.9.5 </span>The <dfn><code>col</code></dfn> element</h4><dl class=element><dt>Categories</dt>
<dd>None.</dd>
<dt>Contexts in which this element may be used:</dt>
<dd>As a child of a <code><a href=#the-colgroup-element>colgroup</a></code> element that doesn't have
@@ -18415,8 +18418,8 @@
<code><a href=#the-form-element>form</a></code> elements in the <code title=dom-forms>forms</code> collection that it is in, if any.<p>The <code title=attr-fs-action><a href=#attr-fs-action>action</a></code>, <code title=attr-fs-enctype><a href=#attr-fs-enctype>enctype</a></code>, <code title=attr-fs-method><a href=#attr-fs-method>method</a></code>, and <code title=attr-fs-target><a href=#attr-fs-target>target</a></code> attributes are <a href=#attributes-for-form-submission>attributes
for form submission</a>.<p>The <dfn id=dom-form-accept-charset title=dom-form-accept-charset><code>accept-charset</code></dfn>
and <dfn id=dom-form-name title=dom-form-name><code>name</code></dfn> DOM
- attributes must <a href=#reflect>reflect</a> the content attributes of the
- same name.<p>The <dfn id=dom-form-elements title=dom-form-elements><code>elements</code></dfn>
+ attributes must <a href=#reflect>reflect</a> the respective content
+ attributes of the same name.<p>The <dfn id=dom-form-elements title=dom-form-elements><code>elements</code></dfn>
DOM attribute must return an <code><a href=#htmlformcontrolscollection-0>HTMLFormControlsCollection</a></code>
rooted at the <code>Document</code> node, whose filter matches <a href=#category-listed title=category-listed>listed</a> elements whose <a href=#form-owner>form
owner</a> is the <code><a href=#the-form-element>form</a></code> element, with the exception of
@@ -19397,9 +19400,9 @@
the control non-interactive and to prevent its value from being
submitted. The <code title=attr-fe-autofocus><a href=#attr-fe-autofocus>autofocus</a></code>
attribute controls focus.<p>The <dfn id=dom-input-accept title=dom-input-accept><code>accept</code></dfn>, <dfn id=dom-input-alt title=dom-input-alt><code>alt</code></dfn>, <dfn id=dom-input-autocomplete title=dom-input-autocomplete><code>autocomplete</code></dfn>, <dfn id=dom-input-max title=dom-input-max><code>max</code></dfn>, <dfn id=dom-input-min title=dom-input-min><code>min</code></dfn>, <dfn id=dom-input-pattern title=dom-input-pattern><code>pattern</code></dfn>, <dfn id=dom-input-required title=dom-input-required><code>required</code></dfn>, <dfn id=dom-input-size title=dom-input-size><code>size</code></dfn>, <dfn id=dom-input-src title=dom-input-src><code>src</code></dfn>, <dfn id=dom-input-step title=dom-input-step><code>step</code></dfn>, and <dfn id=dom-input-type title=dom-input-type><code>type</code></dfn> DOM attributes must
- <a href=#reflect>reflect</a> the content attributes with the same names.
- The <dfn id=dom-input-maxlength title=dom-input-maxLength><code>maxLength</code></dfn>
- DOM attribute must <a href=#reflect>reflect</a> the <code title=attr-input-maxlength><a href=#attr-input-maxlength>maxlength</a></code> content attribute. The
+ <a href=#reflect>reflect</a> the respective content attributes of the same
+ name. The <dfn id=dom-input-maxlength title=dom-input-maxLength><code>maxLength</code></dfn> DOM
+ attribute must <a href=#reflect>reflect</a> the <code title=attr-input-maxlength><a href=#attr-input-maxlength>maxlength</a></code> content attribute. The
<dfn id=dom-input-readonly title=dom-input-readOnly><code>readOnly</code></dfn> DOM
attribute must <a href=#reflect>reflect</a> the <code title=attr-input-readonly><a href=#attr-input-readonly>readonly</a></code> content attribute. The
<dfn id=dom-input-defaultchecked title=dom-input-defaultChecked><code>defaultChecked</code></dfn>
@@ -20901,8 +20904,8 @@
attribute DOMString <a href=#dom-fs-method title=dom-fs-method>method</a>;
attribute DOMString <a href=#dom-fe-name title=dom-fe-name>name</a>;
attribute DOMString <a href=#dom-fs-target title=dom-fs-target>target</a>;
- attribute DOMString <span title=dom-button-type>type</span>;
- attribute DOMString <span title=dom-button-value>value</span>;
+ attribute DOMString <a href=#dom-button-type title=dom-button-type>type</a>;
+ attribute DOMString <a href=#dom-button-value title=dom-button-value>value</a>;
readonly attribute <span>NodeList</span> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
@@ -20967,7 +20970,10 @@
attribute must not be present unless the <code title=attr-fae-form><a href=#attr-fae-form>form</a></code> attribute is present. The
element's <a href=#concept-fe-value title=concept-fe-value>value</a> is the value
of the element's <code title=attr-button-value><a href=#attr-button-value>value</a></code>
- attribute, if there is one, or the empty string otherwise.<p>The <code title=dom-cva-willValidate><a href=#dom-cva-willvalidate>willValidate</a></code>,
+ attribute, if there is one, or the empty string otherwise.<p>The <dfn id=dom-button-value title=dom-button-value><code>value</code></dfn> and
+ <dfn id=dom-button-type title=dom-button-type><code>type</code></dfn> DOM attributes
+ must <a href=#reflect>reflect</a> the respective content attributes of the
+ same name.<p>The <code title=dom-cva-willValidate><a href=#dom-cva-willvalidate>willValidate</a></code>,
<code title=dom-cva-validity><a href=#dom-cva-validity>validity</a></code>, and <code title=dom-cva-validationMessage><a href=#dom-cva-validationmessage>validationMessage</a></code>
attributes, and the <code title=dom-cva-checkValidatity><a href=#dom-cva-checkvalidatity>checkValidity()</a></code> and
<code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
@@ -23391,9 +23397,10 @@
menu, showing the various <code><a href=#the-command>command</a></code> attributes off, and
that has a default command.</p>
- </div><p>The <dfn id=dom-command-type title=dom-command-type><code>type</code></dfn>, <dfn id=dom-command-label title=dom-command-label><code>label</code></dfn>, <dfn id=dom-command-icon title=dom-command-icon><code>icon</code></dfn>, <dfn id=dom-command-disabled title=dom-command-disabled><code>disabled</code></dfn>, <dfn id=dom-command-checked title=dom-command-checked><code>checked</code></dfn>, <dfn id=dom-command-radiogroup title=dom-command-radiogroup><code>radiogroup</code></dfn>, and <dfn id=dom-command-default title=dom-command-default><code>default</code></dfn> DOM
- attributes must <a href=#reflect>reflect</a> the
- content attributes of the same name.<p>The <dfn id=dom-command-click title=dom-command-click><code>click()</code></dfn>
+ </div><p>The <dfn id=dom-command-type title=dom-command-type><code>type</code></dfn>, <dfn id=dom-command-label title=dom-command-label><code>label</code></dfn>, <dfn id=dom-command-icon title=dom-command-icon><code>icon</code></dfn>, <dfn id=dom-command-disabled title=dom-command-disabled><code>disabled</code></dfn>, <dfn id=dom-command-checked title=dom-command-checked><code>checked</code></dfn>, <dfn id=dom-command-radiogroup title=dom-command-radiogroup><code>radiogroup</code></dfn>, and
+ <dfn id=dom-command-default title=dom-command-default><code>default</code></dfn> DOM
+ attributes must <a href=#reflect>reflect</a> the respective content
+ attributes of the same name.<p>The <dfn id=dom-command-click title=dom-command-click><code>click()</code></dfn>
method's behavior depends on the value of the <code title=attr-command-type><a href=#attr-command-type>type</a></code> attribute of the element, as
follows:<dl class=switch><dt>If the <code title=attr-command-type><a href=#attr-command-type>type</a></code> attribute
has the value <code title="">checkbox</code></dt>
@@ -23592,9 +23599,9 @@
attribute gives the label of the menu. It is used by user agents to
display nested menus in the UI. For example, a context menu
containing another menu would use the nested menu's <code title=attr-menu-label><a href=#attr-menu-label>label</a></code> attribute for the submenu's
- menu label.<p>The <dfn id=dom-menu-type title=dom-menu-type><code>type</code></dfn> and <dfn id=dom-menu-label title=dom-menu-label><code>label</code></dfn> DOM
- attributes must <a href=#reflect>reflect</a> the
- content attributes of the same name.<h5 id=menus-intro><span class=secno>4.11.5.1 </span>Introduction</h5><p><em>This section is non-normative.</em><p class=XXX>...</p><!--
+ menu label.<p>The <dfn id=dom-menu-type title=dom-menu-type><code>type</code></dfn> and <dfn id=dom-menu-label title=dom-menu-label><code>label</code></dfn> DOM attributes must
+ <a href=#reflect>reflect</a> the respective content attributes of the same
+ name.<h5 id=menus-intro><span class=secno>4.11.5.1 </span>Introduction</h5><p><em>This section is non-normative.</em><p class=XXX>...</p><!--
<pre><menu type="commands">
Received on Saturday, 4 October 2008 01:29:04 UTC