[selectors] Fix paragraph markup.

Author: tabatkins

selectors/Overview.html

@@ -11,7 +11,7 @@
    rel=dcterms.rights>
   <meta content="Selectors Level 4" name=dcterms.title>
   <meta content=text name=dcterms.type>
-  <meta content=2014-03-20 name=dcterms.date>
+  <meta content=2014-03-22 name=dcterms.date>
   <meta content="Elika J. Etemad" name=dcterms.creator>
   <meta content="Tab Atkins Jr." name=dcterms.creator>
   <meta content=W3C name=dcterms.publisher>
@@ -32,13 +32,13 @@
 
    <h1 id=title>Selectors Level 4</h1>
 
-   <h2 class="no-num no-toc">Editor's Draft 20 March 2014</h2>
+   <h2 class="no-num no-toc">Editor's Draft 22 March 2014</h2>
 
    <dl>
     <dt>This version:
 
     <dd><a href="http://dev.w3.org/csswg/selectors4/">
-     http://www.w3.org/TR/2014/ED-selectors4-20140320/</a>
+     http://www.w3.org/TR/2014/ED-selectors4-20140322/</a>
 
     <dt>Editor's draft:
 
@@ -549,16 +549,14 @@ <h2 id=context><span class=secno>1. </span> Introduction</h2>
 
   <ul>
    <li> directly on an element to test whether it matches some criteria, such
-    as in the <code>Element.matches()</code> function defined in <a
-    href="#ref-SELECTORS-API2"
-    rel=biblioentry>[SELECTORS-API2]<!--{{SELECTORS-API2}}--></a>
+    as in the <code>element.matches()</code> function defined in <a
+    href="#ref-DOM" rel=biblioentry>[DOM]<!--{{DOM}}--></a>
 
    <li> applied to an entire tree of elements to filter it into a set of
     elements that match the criteria, such as in the
-    <code>document.findAll()</code> function defined in <a
-    href="#ref-SELECTORS-API2"
-    rel=biblioentry>[SELECTORS-API2]<!--{{SELECTORS-API2}}--></a> or the
-    selector of a CSS style rule.
+    <code>document.queryAll()</code> function defined in <a href="#ref-DOM"
+    rel=biblioentry>[DOM]<!--{{DOM}}--></a> or the selector of a CSS style
+    rule.
 
    <li> used "in reverse" to generate markup that would match a given
     selector, such as in <a href="http://haml.info/">HAML</a> or <a
@@ -1385,11 +1383,12 @@ <h3 id=evaluating-selectors><span class=secno>3.2. </span> Evaluating a
    href="#selector-match-list"><i>selector match list</i></a> is immediately
    filtered to contain only elements that are either the <a
    href="#scoping-root"><i>scoping root</i></a> or descendants of the <a
-   href="#scoping-root"><i>scoping root</i></a>. The selector is processed
-   from left to right in order, with <a href="#simple"><i>simple
-   selectors</i></a> filtering the <i>selector match set</i>, and <a
-   href="#combinator0"><i>combinators</i></a> changing the <i>selector match
-   set</i> into something new. If the selector is <a
+   href="#scoping-root"><i>scoping root</i></a>.
+
+  <p>The selector is processed from left to right in order, with <a
+   href="#simple"><i>simple selectors</i></a> filtering the <i>selector match
+   set</i>, and <a href="#combinator0"><i>combinators</i></a> changing the
+   <i>selector match set</i> into something new. If the selector is <a
    href="#scope-contained"><i>scope-contained</i></a> then after each <a
    href="#combinator0"><i>combinator</i></a> the <a
    href="#selector-match-list"><i>selector match list</i></a> must be
@@ -1400,9 +1399,11 @@ <h3 id=evaluating-selectors><span class=secno>3.2. </span> Evaluating a
    is finished processing, the <a href="#selector-match-list"><i>selector
    match list</i></a> must be filtered to contain only elements that are
    either the <a href="#scoping-root"><i>scoping root</i></a> or descendants
-   of the <a href="#scoping-root"><i>scoping root</i></a>. When this process
-   is done, the elements in the <i>selector match set</i> are the elements
-   said to match the selector.
+   of the <a href="#scoping-root"><i>scoping root</i></a>.
+
+  <p>When this process is done, the elements in the <i>selector match set</i>
+   are the elements said to match the selector. If the order of elements
+   matter, they must be sorted in document order, unless otherwise specified.
 
   <p>For example, to evaluate the selector "div > i.name" against a document,
    the <a href="#selector-match-list"><i>selector match list</i></a> is first
@@ -1643,7 +1644,7 @@ <h4 id=absolutizing><span class=secno>3.6.1. </span> Absolutizing a
    This is because handling an explicitly empty list should return nothing;
    if no :scope elements were given at all, Selectors API 2 should be amended
    to say that the selector must be absolute already. (Broken example: doing
-   <code>document.find('img', [list-of-links]))</code> finds images that are
+   <code>document.query('img', [list-of-links]))</code> finds images that are
    descendants of links normally, but instead finds all images in the
    document if the list-of-links is empty.)
 
@@ -4659,6 +4660,16 @@ <h3 id=informative-references><span class=secno>21.2. </span> Informative
    </dd>
    <!---->
 
+   <dt id=ref-DOM>[DOM]
+
+   <dd>Anne van Kesteren; et al. <a
+    href="http://www.w3.org/TR/2014/WD-dom-20140204/"><cite>W3C
+    DOM4.</cite></a> 4 February 2014. W3C Last Call Working Draft. (Work in
+    progress.) URL: <a
+    href="http://www.w3.org/TR/2014/WD-dom-20140204/">http://www.w3.org/TR/2014/WD-dom-20140204/</a>
+   </dd>
+   <!---->
+
    <dt id=ref-DOM-LEVEL-3-CORE>[DOM-LEVEL-3-CORE]
 
    <dd>Gavin Nicol; et al. <a

selectors/Overview.src.html

@@ -653,7 +653,7 @@ <h3 id='evaluating-selectors'>
   to contain only elements that are either the <i>scoping root</i>
   or descendants of the <i>scoping root</i>.
 
-  The selector is processed from left to right in order,
+  <p>The selector is processed from left to right in order,
   with <i>simple selectors</i> filtering the <i>selector match set</i>,
   and <i>combinators</i> changing the <i>selector match set</i> into something new.
   If the selector is <i>scope-contained</i>
@@ -667,8 +667,11 @@ <h3 id='evaluating-selectors'>
   to contain only elements that are either the <i>scoping root</i>
   or descendants of the <i>scoping root</i>.
 
-  When this process is done, the elements in the <i>selector match set</i>
+  <p>When this process is done, the elements in the <i>selector match set</i>
   are the elements said to match the selector.
+  If the order of elements matter,
+  they must be sorted in document order,
+  unless otherwise specified.
 
   <p>For example, to evaluate the selector "div > i.name" against a document,
   the <i>selector match list</i> is first set to all the elements in the entire document.