Whoops, didn't realize fantasai had already added a scoped selector section, and it's better. Moved the example I wrote up into it, and deleted the rest of my section.

--HG--
extra : rebase_source : 29e77465aac1d3495ba20cff1b385a06d2d4c55f

Author: tabatkins

selectors4/Overview.html

@@ -183,9 +183,6 @@ <h2 class="no-num no-toc" id=contents>Table of Contents</h2>
 
      <li><a href="#invalid"><span class=secno>3.8. </span> Invalid Selectors
       and Error Handling</a>
-
-     <li><a href="#selector-scoping"><span class=secno>3.9. </span> Selector
-      Scoping</a>
     </ul>
 
    <li><a href="#logical-combination"><span class=secno>4. </span> Logical
@@ -1236,6 +1233,21 @@ <h3 id=scoping><span class=secno>3.3. </span> Scoped Selectors</h3>
    set</i></a> and can be selected with the <a
    href="#scope-pseudo"><code>:scope</code></a> pseudo-class.
 
+  <div class=example>
+   <p> The <code>document.querySelector()</code> function defined in <a
+    href="#SELECTORS-API2"
+    rel=biblioentry>[SELECTORS-API2]<!--{{SELECTORS-API2}}--></a> allows the
+    author to define a <a
+    href="#scope-constrained"><i>scope-constrained</i></a> selector.
+
+   <p> On the other hand, the <code>document.find()</code> function defined
+    in <a href="#SELECTORS-API2"
+    rel=biblioentry>[SELECTORS-API2]<!--{{SELECTORS-API2}}--></a> and the
+    selectors within a scoped stylesheet, defined in <a href="#HTML5"
+    rel=biblioentry>[HTML5]<!--{{HTML5}}--></a>, define <a
+    href="#scope-contained"><i>scope-contained</i></a> selectors.
+  </div>
+
   <h3 id=pseudo-classes><span class=secno>3.4. </span> Pseudo-classes</h3>
 
   <p>The <dfn id=pseudo-class>pseudo-class</dfn> concept is introduced to
@@ -1374,50 +1386,6 @@ <h3 id=invalid><span class=secno>3.8. </span> Invalid Selectors and Error
    that the last rule be dropped in favor of Media Queries-style
    error-handling.
 
-  <h3 id=selector-scoping><span class=secno>3.9. </span> Selector Scoping</h3>
-
-  <p> In some instances, selectors may be "scoped", or limited in some way to
-   apply only within a section of the document.
-
-  <p> There are two distinct ways in which selectors can be scoped:
-
-  <dl>
-   <dt><dfn id=scope-contained0>scope-contained</dfn>
-
-   <dd> When a selector is <a
-    href="#scope-contained0"><i>scope-contained</i></a>, it matches as if the
-    elements outside of its scope did not exist. In other words, it acts like
-    the scope defines a sub-document within which the selector is matched.
-
-   <dt><dfn id=scope-limited>scope-limited</dfn>
-
-   <dd> When a selector is <a href="#scope-limited"><i>scope-limited</i></a>,
-    it only matches if the target is within the scope. The rest of the
-    document is still acknowledged and can match all but the last part of the
-    selector; only the target (the element matched by the last compound
-    selector in the selector) is required to be within the scope.
-  </dl>
-
-  <div class=example>
-   <p> The <code>document.querySelector()</code> function defined in <a
-    href="#SELECTORS-API2"
-    rel=biblioentry>[SELECTORS-API2]<!--{{SELECTORS-API2}}--></a> allows the
-    author to define a <a href="#scope-limited"><i>scope-limited</i></a>
-    selector.
-
-   <p> On the other hand, the <code>document.find()</code> function defined
-    in <a href="#SELECTORS-API2"
-    rel=biblioentry>[SELECTORS-API2]<!--{{SELECTORS-API2}}--></a> and the
-    selectors within a scoped stylesheet, defined in <a href="#HTML5"
-    rel=biblioentry>[HTML5]<!--{{HTML5}}--></a>, define <a
-    href="#scope-contained0"><i>scope-contained</i></a> selectors.
-  </div>
-
-  <p> Both kinds of scoping define a <a
-   href="#contextual-reference-element-set"><i>contextual reference element
-   set</i></a>, which can be matched with the <a
-   href="#scope-pseudo"><code>:scope</code></a> pseudo-class selector.
-
   <h2 id=logical-combination><span class=secno>4. </span> Logical
    Combinations</h2>
 

selectors4/Overview.src.html

@@ -580,6 +580,7 @@ <h3 id="scoping">
   <p>Some host applications may choose to <dfn>scope</dfn> selectors
   to a particular subtree of the document.
   There are two methods of doing this:
+
   <dl>
     <dt><dfn>scope-contained</dfn> selectors
     <dd>
@@ -588,17 +589,31 @@ <h3 id="scoping">
       all <i>compound selectors</i> must match elements within the scope.
       (The <code>:root</code> pseudo-class, however,
       still only matches the actual root of the document.)
+
     <dt><dfn>scope-constrained</dfn> selectors
     <dd>
       With this method of scoping, a selector matches if
       the <i>subject</i> of the selector is within the scope,
       even if other components of the selector are outside the scope.
   </dl>
+
   <p>The root of the scoping subtree is called the <dfn>scoping element</dfn>
   and is in-scope.
   When scoped selectors are used, it forms the <i>contextual reference element set</i>
   and can be selected with the <code>:scope</code> pseudo-class.
 
+  <div class='example'>
+    <p>
+      The <code>document.querySelector()</code> function defined in [[SELECTORS-API2]]
+      allows the author to define a <i>scope-constrained</i> selector.
+
+    <p>
+      On the other hand, the <code>document.find()</code> function defined in [[SELECTORS-API2]]
+      and the selectors within a scoped stylesheet, defined in [[HTML5]],
+      define <i>scope-contained</i> selectors.
+  </div>
+
+
 <h3 id="pseudo-classes">
 Pseudo-classes</h3>
 
@@ -732,52 +747,6 @@ <h3 id="invalid">
     that the last rule be dropped in favor of Media Queries-style error-handling.</p>
 
 
-<h3 id='selector-scoping'>
-Selector Scoping</h3>
-
-  <p>
-    In some instances,
-    selectors may be "scoped",
-    or limited in some way to apply only within a section of the document.
-
-  <p>
-    There are two distinct ways in which selectors can be scoped:
-
-  <dl>
-    <dt><dfn>scope-contained</dfn>
-    <dd>
-      When a selector is <i>scope-contained</i>,
-      it matches as if the elements outside of its scope did not exist.
-      In other words,
-      it acts like the scope defines a sub-document within which the selector is matched.
-
-    <dt><dfn>scope-limited</dfn>
-    <dd>
-      When a selector is <i>scope-limited</i>,
-      it only matches if the target is within the scope.
-      The rest of the document is still acknowledged
-      and can match all but the last part of the selector;
-      only the target
-      (the element matched by the last compound selector in the selector)
-      is required to be within the scope.
-  </dl>
-
-  <div class='example'>
-    <p>
-      The <code>document.querySelector()</code> function defined in [[SELECTORS-API2]]
-      allows the author to define a <i>scope-limited</i> selector.
-
-    <p>
-      On the other hand, the <code>document.find()</code> function defined in [[SELECTORS-API2]]
-      and the selectors within a scoped stylesheet, defined in [[HTML5]],
-      define <i>scope-contained</i> selectors.
-  </div>
-
-  <p>
-    Both kinds of scoping define a <i>contextual reference element set</i>,
-    which can be matched with the <code>:scope</code> pseudo-class selector.
-
-
 
 <h2 id="logical-combination">
 Logical Combinations</h2>