html5/spec Overview.html,1.2280,1.2281

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv18390

Modified Files:
	Overview.html 
Log Message:
Make the formatBlock execCommand more discerning. (bug 6440) (whatwg r3123)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2280
retrieving revision 1.2281
diff -u -d -r1.2280 -r1.2281
--- Overview.html	24 May 2009 05:42:50 -0000	1.2280
+++ Overview.html	25 May 2009 01:27:08 -0000	1.2281
@@ -152,7 +152,7 @@
    <h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
    <!--ZZZ:-->
    <!--<h2 class="no-num no-toc">W3C Working Draft 23 April 2009</h2>-->
-   <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 24 May 2009</h2>
+   <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 25 May 2009</h2>
    <!--:ZZZ-->
    <dl><!-- ZZZ: update the month/day (twice), (un)comment out
     <dt>This Version:</dt>
@@ -245,7 +245,7 @@
   track.
   <!--ZZZ:-->
   <!--This specification is the 23 April 2009 Working Draft.-->
-  This specification is the 24 May 2009 Editor's Draft.
+  This specification is the 25 May 2009 Editor's Draft.
   <!--:ZZZ-->
   </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>This specification is also being produced by the <a href="http://www.whatwg.org/">WHATWG</a>. The two specifications are
   identical from the table of contents onwards.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- context and rationale (required) --><p>This specification is intended to replace (be a new version of)
@@ -11024,6 +11024,7 @@
   object.<h4 id="the-section-element"><span class="secno">4.4.2 </span>The <dfn><code>section</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
    <dd><a href="#sectioning-content-0">Sectioning content</a>.</dd>
+   <dd><a href="#formatblock-candidate"><code title="">formatBlock</code> candidate</a>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <a href="#flow-content-0">flow content</a> is expected.</dd>
    <dt>Content model:</dt>
@@ -11087,6 +11088,7 @@
   </div><h4 id="the-nav-element"><span class="secno">4.4.3 </span>The <dfn><code>nav</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
    <dd><a href="#sectioning-content-0">Sectioning content</a>.</dd>
+   <dd><a href="#formatblock-candidate"><code title="">formatBlock</code> candidate</a>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <a href="#flow-content-0">flow content</a> is expected.</dd>
    <dt>Content model:</dt>
@@ -11138,6 +11140,7 @@
   </div><h4 id="the-article-element"><span class="secno">4.4.4 </span>The <dfn><code>article</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
    <dd><a href="#sectioning-content-0">Sectioning content</a>.</dd>
+   <dd><a href="#formatblock-candidate"><code title="">formatBlock</code> candidate</a>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <a href="#flow-content-0">flow content</a> is expected.</dd>
    <dt>Content model:</dt>
@@ -11190,6 +11193,7 @@
   </div><h4 id="the-aside-element"><span class="secno">4.4.5 </span>The <dfn><code>aside</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
    <dd><a href="#sectioning-content-0">Sectioning content</a>.</dd>
+   <dd><a href="#formatblock-candidate"><code title="">formatBlock</code> candidate</a>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <a href="#flow-content-0">flow content</a> is expected.</dd>
    <dt>Content model:</dt>
@@ -11245,6 +11249,7 @@
   elements</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
    <dd><a href="#heading-content-0">Heading content</a>.</dd>
+   <dd><a href="#formatblock-candidate"><code title="">formatBlock</code> candidate</a>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <a href="#flow-content-0">flow content</a> is expected.</dd>
    <dt>Content model:</dt>
@@ -11261,6 +11266,7 @@
   elements with the same name have equal rank.<h4 id="the-hgroup-element"><span class="secno">4.4.7 </span>The <dfn><code>hgroup</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
    <dd><a href="#heading-content-0">Heading content</a>.</dd>
+   <dd><a href="#formatblock-candidate"><code title="">formatBlock</code> candidate</a>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <a href="#flow-content-0">flow content</a> is expected.</dd>
    <dt>Content model:</dt>
@@ -11303,6 +11309,7 @@
 
   </div><h4 id="the-header-element"><span class="secno">4.4.8 </span>The <dfn><code>header</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
+   <dd><a href="#formatblock-candidate"><code title="">formatBlock</code> candidate</a>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <a href="#flow-content-0">flow content</a> is expected.</dd>
    <dt>Content model:</dt>
@@ -11385,6 +11392,7 @@
 
   </div><h4 id="the-footer-element"><span class="secno">4.4.9 </span>The <dfn><code>footer</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
+   <dd><a href="#formatblock-candidate"><code title="">formatBlock</code> candidate</a>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <a href="#flow-content-0">flow content</a> is expected.</dd>
    <dt>Content model:</dt>
@@ -11430,6 +11438,7 @@
 
   </div><h4 id="the-address-element"><span class="secno">4.4.10 </span>The <dfn><code>address</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
+   <dd><a href="#formatblock-candidate"><code title="">formatBlock</code> candidate</a>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <a href="#flow-content-0">flow content</a> is expected.</dd>
    <dt>Content model:</dt>
@@ -11897,6 +11906,7 @@
   heading of the original single page becomes the heading of the site,
   repeated on every page.<h3 id="grouping-content"><span class="secno">4.5 </span>Grouping content</h3><!-- XXX ew, find a better section name --><h4 id="the-p-element"><span class="secno">4.5.1 </span>The <dfn><code>p</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
+   <dd><a href="#formatblock-candidate"><code title="">formatBlock</code> candidate</a>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <a href="#flow-content-0">flow content</a> is expected.</dd>
    <dt>Content model:</dt>
@@ -12017,6 +12027,7 @@
   (e.g. as in a template). Such blank lines must not be used for
   presentation purposes.<h4 id="the-pre-element"><span class="secno">4.5.4 </span>The <dfn><code>pre</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
+   <dd><a href="#formatblock-candidate"><code title="">formatBlock</code> candidate</a>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <a href="#flow-content-0">flow content</a> is expected.</dd>
    <dt>Content model:</dt>
@@ -12139,6 +12150,7 @@
   to cite or quote.<h4 id="the-blockquote-element"><span class="secno">4.5.6 </span>The <dfn><code>blockquote</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
    <dd><a href="#sectioning-root">Sectioning root</a>.</dd>
+   <dd><a href="#formatblock-candidate"><code title="">formatBlock</code> candidate</a>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <a href="#flow-content-0">flow content</a> is expected.</dd>
    <dt>Content model:</dt>
@@ -35958,6 +35970,7 @@
 
   </div><h4 id="the-div-element"><span class="secno">4.12.2 </span>The <dfn><code>div</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
+   <dd><a href="#formatblock-candidate"><code title="">formatBlock</code> candidate</a>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <a href="#flow-content-0">flow content</a> is expected.</dd>
    <dt>Content model:</dt>
@@ -51163,8 +51176,8 @@
    <dt><dfn id="command-formatblock" title="command-formatBlock"><code>formatBlock</code></dfn></dt>
    <dd><strong>Summary:</strong> Wraps the selection in the element
    given by the second argument. If the second argument doesn't
-   specify an element that is <a href="#flow-content-0">flow content</a> but not
-   <a href="#phrasing-content-0">phrasing content</a>, does nothing.</dd>
+   specify an element that is a <dfn id="formatblock-candidate"><code title="">formatBlock</code>
+   candidate</dfn>, does nothing.</dd>
    <dd class="impl">
     <p><strong>Action:</strong> The user agent must run the following
     steps:</p>
@@ -51177,18 +51190,17 @@
      <li>
       <p>If <var title="">value</var> is (now) an <a href="#ascii-case-insensitive">ASCII
       case-insensitive</a> match for the tag name of an element
-      defined by this specification that is defined to be <a href="#flow-content-0">flow
-      content</a> but not <a href="#phrasing-content-0">phrasing content</a>, then, for
-      every position in the selection, take the furthest <a href="#flow-content-0">flow
-      content</a> ancestor element of that position that contains
-      only <a href="#phrasing-content-0">phrasing content</a>, and, if that element is
-      <a href="#editable">editable</a>, and has a content model that allows it to
-      contain <a href="#flow-content-0">flow content</a> other than <a href="#phrasing-content-0">phrasing
-      content</a>, and has a parent element whose content model
-      allows that parent to contain any <a href="#flow-content-0">flow content</a>,
-      replace the element with one in the HTML namespace whose name is
-      <var title="">value</var>, and move all the children that were
-      in the element to the new element.</p>
+      defined by this specification that is defined to be a
+      <a href="#formatblock-candidate"><code title="">formatBlock</code> candidate</a>, then,
+      for every position in the selection, take the furthest
+      <a href="#formatblock-candidate"><code title="">formatBlock</code> candidate</a>
+      ancestor element of that position that contains only
+      <a href="#phrasing-content-0">phrasing content</a>, and, if that element is
+      <a href="#editable">editable</a> and has a parent element whose content
+      model allows that parent to contain any <a href="#flow-content-0">flow
+      content</a>, replace it with an element in the HTML namespace
+      whose name is <var title="">value</var>, and move all the
+      children that were in it to the new element.</p>
       <p>If there is no selection, then, where in the description
       above refers to the selection, the user agent must act as if the
       selection was an empty range (with just one position) at the

Received on Monday, 25 May 2009 01:27:22 UTC