[selectors] Add complex-selector variants of :matches() and :not().

--HG--
extra : rebase_source : 3c1c30da67633e6449ab8c454763ec91cd38e78c

Author: tabatkins

selectors/Overview.html

@@ -182,8 +182,8 @@ <h2 class="no-num no-toc" id=contents>Table of Contents</h2>
    <li><a href="#overview"><span class=secno>2. </span> Selectors
     Overview</a>
     <ul class=toc>
-     <li><a href="#profiles"><span class=secno>2.1. </span> "Fast" and
-      "Complete" Profiles</a>
+     <li><a href="#profiles"><span class=secno>2.1. </span> <i>Fast</i> vs
+      <i>Complete</i> Selector Profiles</a>
     </ul>
 
    <li><a href="#syntax"><span class=secno>3. </span> Selector Syntax and
@@ -1184,8 +1184,9 @@ <h2 id=overview><span class=secno>2. </span> Selectors Overview</h2>
    introduced in <a href="#CSS3UI"
    rel=biblioentry>[CSS3UI]<!--{{CSS3UI}}--></a>.
 
-  <h3 id=profiles><span class=secno>2.1. </span> "Fast" and "Complete"
-   Profiles</h3>
+  <h3 id=profiles><span class=secno>2.1. </span> <a
+   href="#fast-profile"><i>Fast</i></a> vs <a
+   href="#complete-profile"><i>Complete</i></a> Selector Profiles</h3>
 
   <p> Selectors are used in many different contexts, with wildly varying
    performance characteristics. Some powerful selectors are unfortunately too
@@ -1195,12 +1196,11 @@ <h3 id=profiles><span class=secno>2.1. </span> "Fast" and "Complete"
   <dl>
    <dt><dfn id=fast-profile>fast</dfn>
 
-   <dd> The ‘<a href="#fast-profile"><code class=css>fast</code></a>’
-    profile is appropriate for use in any context, including dynamic browser
-    CSS selector matching. It includes every selector defined in this
-    document, except for:
+   <dd> The <a href="#fast-profile"><i>fast</i></a> profile is appropriate
+    for use in any context, including dynamic browser CSS selector matching.
+    It includes every selector defined in this document, except for:
     <ul>
-     <li>The "complex selector" variants of ‘<a
+     <li><a href="#combinator"><i>Combinators</i></a> within ‘<a
       href="#matches-pseudo"><code class=css>:matches()</code></a>’ and
       ‘<a href="#negation-pseudo"><code class=css>:not()</code></a>’.
 
@@ -1211,10 +1211,9 @@ <h3 id=profiles><span class=secno>2.1. </span> "Fast" and "Complete"
 
    <dt><dfn id=complete-profile>complete</dfn>
 
-   <dd> The ‘<a href="#complete-profile"><code
-    class=css>complete</code></a>’ profile is appropriate for contexts
-    which aren't extremely performance sensitive. For example,
-    implementations of the Selectors API specification <a
+   <dd> The <a href="#complete-profile"><i>complete</i></a> profile is
+    appropriate for contexts which aren't extremely performance sensitive.
+    For example, implementations of the Selectors API specification <a
     href="#SELECTORS-API"
     rel=biblioentry>[SELECTORS-API]<!--{{SELECTORS-API}}--></a> should use
     the ‘<a href="#complete-profile"><code class=css>complete</code></a>’
@@ -1599,17 +1598,19 @@ <h3 id=matches><span class=secno>4.2. </span> The Matches-Any Pseudo-class:
    list</a> as its argument. It represents an element that is represented by
    its argument.
 
-  <p>In Selectors Level 4, only <a href="#compound">compound selectors</a>
-   are allowed within <a href="#matches-pseudo"><code>:matches()</code></a>:
-   <a href="#combinator">combinators</a> are not allowed. Additionally, <a
-   href="#matches-pseudo"><code>:matches()</code></a> may not be nested
-   within itself or within <a
+  <p>In the <a href="#fast-profile"><i>fast</i></a> Selectors profile, only
+   <a href="#compound"><i>compound selectors</i></a> are allowed within <a
+   href="#matches-pseudo"><code>:matches()</code></a>: <a
+   href="#combinator"><i>combinators</i></a> are not allowed. In the <a
+   href="#complete-profile"><i>complete</i></a> profile, full <a
+   href="#complex"><i>complex selectors</i></a> are allowed.
+
+  <p>The <a href="#matches-pseudo"><code>:matches()</code></a> pseudo-class
+   may not be nested within itself or within <a
    href="#negation-pseudo"><code>:not()</code></a>:
    <code>:matches(:matches(...))</code> and <code>:not(:matches(...))</code>
-   are invalid.
-
-  <p>Pseudo-elements cannot be represented by the matches-any pseudo-class;
-   they are not valid within <a
+   are invalid. Additionally, pseudo-elements cannot be represented by the
+   matches-any pseudo-class; they are not valid within <a
    href="#matches-pseudo"><code>:matches()</code></a>.
 
   <p>Default namespace declarations do not affect the subject of any selector
@@ -1640,21 +1641,24 @@ <h3 id=negation><span class=secno>4.3. </span> The Negation Pseudo-class:
    an argument. It represents an element that is not represented by its
    argument.
 
-  <p>In Selectors Level 4, only <a href="#compound">compound selectors</a>
-   are allowed within <a href="#negation-pseudo"><code>:not()</code></a>: <a
-   href="#combinator">combinators</a> are not allowed. Additionally, a
-   negation may not be nested within itself or within <a
+  <p>In the <a href="#fast-profile"><i>fast</i></a> Selectors profile, only
+   <a href="#compound"><i>compound selectors</i></a> are allowed within <a
+   href="#negation-pseudo"><code>:not()</code></a>: <a
+   href="#combinator"><i>combinators</i></a> are not allowed. In the <a
+   href="#complete-profile"><i>complete</i></a> profile, full <a
+   href="#complex"><i>complex selectors</i></a> are allowed.
+
+  <p class=note>In Selectors Level 3, only a single <a
+   href="#simple"><i>simple selector</i></a> was allowed as the argument to
+   <a href="#negation-pseudo"><code>:not()</code></a>.
+
+  <p>A negation may not be nested within itself or within <a
    href="#matches-pseudo"><code>:matches()</code></a>:
    <code>:not(:not(...))</code> and <code>:matches(:not(...))</code> are
-   invalid.
-
-  <p class=note>In Selectors Level 3, only a single <a href="#simple">simple
-   selector</a> was allowed as the argument to <a
+   invalid. Additionally, pseudo-elements cannot be represented by the
+   negation pseudo-class; they are not valid within <a
    href="#negation-pseudo"><code>:not()</code></a>.
 
-  <p>Pseudo-elements cannot be represented by the negation pseudo-class; they
-   are not valid within <a href="#negation-pseudo"><code>:not()</code></a>.
-
   <div class=example>
    <p>For example, the following selector matches all <code>button</code>
     elements in an HTML document that are not disabled.

selectors/Overview.src.html

@@ -520,7 +520,7 @@ <h2 id="overview">
     introduced in [[CSS3UI]].
 
 <h3 id="profiles">
-"Fast" and "Complete" Profiles</h3>
+<i>Fast</i> vs <i>Complete</i> Selector Profiles</h3>
 
   <p>
     Selectors are used in many different contexts,
@@ -532,20 +532,20 @@ <h3 id="profiles">
   <dl>
     <dt><dfn id='fast-profile'>fast</dfn>
     <dd>
-      The ''fast'' profile is appropriate for use in any context,
+      The <i>fast</i> profile is appropriate for use in any context,
       including dynamic browser CSS selector matching.
       It includes every selector defined in this document,
       except for:
 
       <ul>
-        <li>The "complex selector" variants of '':matches()'' and '':not()''.
+        <li><i>Combinators</i> within '':matches()'' and '':not()''.
         <li>The <a href="idref-combinators">reference combinator</a>
         <li>The <a href="#subject">subject indicator</a>
       </ul>
 
     <dt><dfn id='complete-profile'>complete</dfn>
     <dd>
-      The ''complete'' profile is appropriate for contexts which aren't extremely performance sensitive.
+      The <i>complete</i> profile is appropriate for contexts which aren't extremely performance sensitive.
       For example, implementations of the Selectors API specification [[SELECTORS-API]] should use the ''complete'' profile.
       It includes all of the selectors defined in this document.
   </dl>
@@ -876,14 +876,16 @@ <h3 id="matches">
   is a functional pseudo-class taking a <a href="#grouping">selector list</a>
   as its argument. It represents an element that is represented by its argument.
 
-  <p>In Selectors Level 4, only <a href="#compound">compound selectors</a>
+  <p>In the <i>fast</i> Selectors profile, only <i>compound selectors</i>
   are allowed within <code>:matches()</code>:
-  <a href="#combinator">combinators</a> are not allowed. Additionally,
-  <code>:matches()</code> may not be nested within itself or within
-  <code>:not()</code>: <code>:matches(:matches(...))</code> and
-  <code>:not(:matches(...))</code> are invalid.
-
-  <p>Pseudo-elements cannot be represented by the matches-any pseudo-class;
+  <i>combinators</i> are not allowed.
+  In the <i>complete</i> profile,
+  full <i>complex selectors</i> are allowed.
+
+  <p>The <code>:matches()</code> pseudo-class may not be nested within itself
+  or within <code>:not()</code>: 
+  <code>:matches(:matches(...))</code> and <code>:not(:matches(...))</code> are invalid.
+  Additionally, pseudo-elements cannot be represented by the matches-any pseudo-class;
   they are not valid within <code>:matches()</code>.
 
   <p>Default namespace declarations do not affect the subject of any selector
@@ -910,17 +912,18 @@ <h3 id="negation">
   as an argument. It represents an element that is not represented
   by its argument.
 
-  <p>In Selectors Level 4, only <a href="#compound">compound selectors</a>
+  <p>In the <i>fast</i> Selectors profile, only <i>compound selectors</i>
   are allowed within <code>:not()</code>:
-  <a href="#combinator">combinators</a> are not allowed. Additionally,
-  a negation may not be nested within itself or within <code>:matches()</code>:
-  <code>:not(:not(...))</code> and <code>:matches(:not(...))</code> are invalid.
+  <i>combinators</i> are not allowed.
+  In the <i>complete</i> profile,
+  full <i>complex selectors</i> are allowed.
 
-  <p class="note">In Selectors Level 3, only a single
-  <a href="#simple">simple selector</a> was allowed as the argument to
-  <code>:not()</code>.
+  <p class="note">In Selectors Level 3, 
+  only a single <i>simple selector</i> was allowed as the argument to <code>:not()</code>.
 
-  <p>Pseudo-elements cannot be represented by the negation pseudo-class;
+  <p>A negation may not be nested within itself or within <code>:matches()</code>:
+  <code>:not(:not(...))</code> and <code>:matches(:not(...))</code> are invalid.
+  Additionally, pseudo-elements cannot be represented by the negation pseudo-class;
   they are not valid within <code>:not()</code>.
 
   <div class="example">