W3C home > Mailing lists > Public > public-css-commits@w3.org > October 2011

csswg/css3-hierarchies Overview.html,1.8,1.9 Overview.src.html,1.8,1.9

From: Tab Atkins Jr.. via cvs-syncmail <cvsmail@w3.org>
Date: Wed, 26 Oct 2011 23:45:56 +0000
To: public-css-commits@w3.org
Message-Id: <E1RJDAS-0007bt-1L@lionel-hutz.w3.org>
Update of /sources/public/csswg/css3-hierarchies
In directory hutz:/tmp/cvs-serv29239

Modified Files:
	Overview.html Overview.src.html 
Log Message:
Editorial nits.  Added a note.

Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-hierarchies/Overview.html,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -d -r1.8 -r1.9
--- Overview.html	19 Oct 2011 05:25:00 -0000	1.8
+++ Overview.html	26 Oct 2011 23:45:53 -0000	1.9
@@ -40,12 +40,12 @@
 
    <h1>CSS Hierarchies Module Level 3</h1>
 
-   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 19 October
+   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 26 October
     2011</h2>
 
    <dl>
     <dt>This version:
-     <!--<dd><a href="http://www.w3.org/TR/2011/ED-css3-hierarchies-20111019/">http://www.w3.org/TR/2011/ED-css3-hierarchies-20111019/</a>-->
+     <!--<dd><a href="http://www.w3.org/TR/2011/ED-css3-hierarchies-20111026/">http://www.w3.org/TR/2011/ED-css3-hierarchies-20111026/</a>-->
      
 
     <dd><a
@@ -229,10 +229,10 @@
    This specification is one of those modules.
 
   <p>This module describes support for nesting a style rule within another
-   style rule, causing the inner rule to adopt the selector of the outer rule
-   as a selector prefix. This feature allows related styles to be aggregated
-   into a single structure within the CSS document, improving readability and
-   maintainability.
+   style rule, allowing the inner rule's selector to reference the elements
+   matched by the outer rule. This feature allows related styles to be
+   aggregated into a single structure within the CSS document, improving
+   readability and maintainability.
 
   <h3 id=placement><span class=secno>1.1. </span> Module Interactions</h3>
 
@@ -292,7 +292,7 @@
 }</pre>
   </div>
 
-  <p>Besides removing duplication, the grouping of related rules improves
+  <p>Besides removing duplication, the grouping of related rules improves the
    readability and maintainability of the resulting CSS.
 
   <h2 id=nesting-selector><span class=secno>2. </span> The &amp; Selector</h2>
@@ -305,7 +305,7 @@
    selector called the nesting selector, represented in selectors by the
    &lsquo;<code class=css>&amp;</code>&rsquo; character. All complex
    selectors in the selector lists of nested rule sets must start with the
-   nesting selector. The nesting selector represents the elements matches by
+   nesting selector. The nesting selector represents the elements matched by
    the parent rule set's selector list.
 
   <div class=example>
@@ -344,7 +344,7 @@
 
   <p>Multiple style rules can be embedded within a style rule. Style rules
    can be embedded arbitrarily deeply. Embedded style rules and properties
-   can co-exist.
+   can both appear in a single declaration block, and in any order.
 
   <div class=example>
    <p>The following example using Hierarchies:
@@ -369,6 +369,12 @@
 div .constant:hover:after, p .constant:hover:after {content: " [" attr(value) "]";}</pre>
   </div>
 
+  <p class=note>Note: Though it's unlikely that stylesheets authored with
+   Hierarchies will be useful in legacy user agents, as the nested sections
+   will be ignored by the error-handling rules, authors can minimize the
+   damage caused by error-recovery by always putting properties before nested
+   rules.
+
   <h2 id=Grammar><span class=secno>3. </span> Grammar modifications</h2>
 
   <p>This specification alters the CSS Core Grammar and the Selectors
@@ -630,10 +636,10 @@
    <dt id=CSS21>[CSS21]
 
    <dd>Bert Bos; et al. <a
-    href="http://www.w3.org/TR/2011/REC-CSS2-20110607/"><cite>Cascading Style
+    href="http://www.w3.org/TR/2011/REC-CSS2-20110607"><cite>Cascading Style
     Sheets Level 2 Revision 1 (CSS&#160;2.1) Specification.</cite></a> 7 June
     2011. W3C Recommendation. URL: <a
-    href="http://www.w3.org/TR/2011/REC-CSS2-20110607/">http://www.w3.org/TR/2011/REC-CSS2-20110607/</a>
+    href="http://www.w3.org/TR/2011/REC-CSS2-20110607">http://www.w3.org/TR/2011/REC-CSS2-20110607</a>
     </dd>
    <!---->
 
@@ -678,9 +684,9 @@
    <dt id=CSS3COLOR>[CSS3COLOR]
 
    <dd>Tantek &#199;elik; Chris Lilley; L. David Baron. <a
-    href="http://www.w3.org/TR/2011/REC-css3-color-20110607/"><cite>CSS Color
+    href="http://www.w3.org/TR/2011/REC-css3-color-20110607"><cite>CSS Color
     Module Level 3.</cite></a> 7 June 2011. W3C Recommendation. URL: <a
-    href="http://www.w3.org/TR/2011/REC-css3-color-20110607/">http://www.w3.org/TR/2011/REC-css3-color-20110607/</a>
+    href="http://www.w3.org/TR/2011/REC-css3-color-20110607">http://www.w3.org/TR/2011/REC-css3-color-20110607</a>
     </dd>
    <!---->
   </dl>

Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-hierarchies/Overview.src.html,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -d -r1.8 -r1.9
--- Overview.src.html	19 Oct 2011 05:25:00 -0000	1.8
+++ Overview.src.html	26 Oct 2011 23:45:53 -0000	1.9
@@ -95,7 +95,7 @@
 
 	<p>CSS beyond level 2 is a set of modules, divided up to allow the specifications to develop incrementally, along with their implementations. This specification is one of those modules.
 
-	<p>This module describes support for nesting a style rule within another style rule, causing the inner rule to adopt the selector of the outer rule as a selector prefix. This feature allows related styles to be aggregated into a single structure within the CSS document, improving readability and maintainability.
+	<p>This module describes support for nesting a style rule within another style rule, allowing the inner rule's selector to reference the elements matched by the outer rule.  This feature allows related styles to be aggregated into a single structure within the CSS document, improving readability and maintainability.
 
 <h3 id="placement">
 Module Interactions</h3>
@@ -153,14 +153,14 @@
 }</pre>
 	</div>
 
-	<p>Besides removing duplication, the grouping of related rules improves readability and maintainability of the resulting CSS.
+	<p>Besides removing duplication, the grouping of related rules improves the readability and maintainability of the resulting CSS.
 
 <h2 id="nesting-selector">
 The &amp; Selector</h2>
 
 	<p>This specification provides a mechanism that allows for the nesting of style rules within other style rules. A nested style rule can used anywhere that a declaration can be used.</p>
 
-	<p>In order to accomplish nesting, this specification defines a new simple selector called the nesting selector, represented in selectors by the '&amp;' character. All complex selectors in the selector lists of nested rule sets must start with the nesting selector. The nesting selector represents the elements matches by the parent rule set's selector list.
+	<p>In order to accomplish nesting, this specification defines a new simple selector called the nesting selector, represented in selectors by the '&amp;' character. All complex selectors in the selector lists of nested rule sets must start with the nesting selector. The nesting selector represents the elements matched by the parent rule set's selector list.
 
 	<div class='example'>
 		<p>The following example using Hierarchies:
@@ -196,7 +196,7 @@
 p .constant {color:red;}</pre>
 	</div>
 
-	<p>Multiple style rules can be embedded within a style rule. Style rules can be embedded arbitrarily deeply. Embedded style rules and properties can co-exist.</p>
+	<p>Multiple style rules can be embedded within a style rule. Style rules can be embedded arbitrarily deeply. Embedded style rules and properties can both appear in a single declaration block, and in any order.</p>
 
 	<div class='example'>
 		<p>The following example using Hierarchies:
@@ -221,6 +221,8 @@
 div .constant:hover:after, p .constant:hover:after {content: " [" attr(value) "]";}</pre>
 	</div>
 
+	<p class='note'>Note: Though it's unlikely that stylesheets authored with Hierarchies will be useful in legacy user agents, as the nested sections will be ignored by the error-handling rules, authors can minimize the damage caused by error-recovery by always putting properties before nested rules.</p>
+
 <h2 id="Grammar">
 Grammar modifications</h2>
 
Received on Wednesday, 26 October 2011 23:45:57 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 26 October 2011 23:45:59 GMT