W3C home > Mailing lists > Public > public-html-commits@w3.org > October 2008

html5/spec Overview.html,1.1453,1.1454

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Sat, 04 Oct 2008 01:28:30 +0000
To: public-html-commits@w3.org
Message-Id: <E1Klvwc-0007AW-8K@lionel-hutz.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 &lt;canvas&gt; 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>&lt;menu type="commands"&gt;
Received on Saturday, 4 October 2008 01:29:04 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 9 October 2008 20:33:00 GMT