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

csswg/css-variables Overview.html,1.9,1.10 Overview.src.html,1.9,1.10

From: Tab Atkins Jr.. via cvs-syncmail <cvsmail@w3.org>
Date: Fri, 30 Sep 2011 20:37:45 +0000
To: public-css-commits@w3.org
Message-Id: <E1R9jq5-0004Nr-G4@lionel-hutz.w3.org>
Update of /sources/public/csswg/css-variables
In directory hutz:/tmp/cvs-serv16837

Modified Files:
	Overview.html Overview.src.html 
Log Message:
Killed the remaining fixmes in the intro.

Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css-variables/Overview.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- Overview.html	30 Sep 2011 20:31:32 -0000	1.9
+++ Overview.html	30 Sep 2011 20:37:43 -0000	1.10
@@ -90,13 +90,13 @@
 
   <p>CSS is a language for describing the rendering of structured documents
    (such as HTML and XML) on screen, on paper, in speech, etc. This module
-   contains the features of CSS level&nbsp;3 relating to <var
-   class=replaceme>DESCRIBE HERE</var>. It includes and extends the
-   functionality of CSS level&nbsp;2 <a href="#CSS21"
-   rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a>, which builds on CSS
-   level&nbsp;1 <a href="#CSS1" rel=biblioentry>[CSS1]<!--{{CSS1}}--></a>.
-   The main extensions compared to level&nbsp;2 are <var
-   class=replaceme>SUMMARIZE HERE</var>.
+   contains the features of CSS level&nbsp;3 relating to variables. It
+   includes and extends the functionality of CSS level&nbsp;2 <a
+   href="#CSS21" rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a>, which builds
+   on CSS level&nbsp;1 <a href="#CSS1"
+   rel=biblioentry>[CSS1]<!--{{CSS1}}--></a>. The main extensions compared to
+   level&nbsp;2 are the introduction of the variable as a new primitive value
+   type that is accepted by all properties.
 
   <h2 class="no-num no-toc" id=status>Status of this document</h2>
   <!--begin-status-->
@@ -132,8 +132,7 @@
    href="/Consortium/Patent-Policy-20040205/#sec-Disclosure">section 6 of the
    W3C Patent Policy</a>.</p>
   <!--end-status-->
-
-  <p>The following features are at risk: &hellip;
+  <!--<p>The following features are at risk: …</p>-->
 
   <h2 class="no-num no-toc" id=contents>Table of contents</h2>
   <!--begin-toc-->
@@ -225,24 +224,20 @@
    for example, a site may establish a color scheme and reuse three or four
    colors throughout the site. Altering this data can be difficult and
    error-prone, since it's scattered throughout the CSS file (and possibly
-   across multiple files), and may not be amenable to Find-and-Replace. This
-   module introduces <b>Variables</b>, which allow a value to be assigned to
-   a name, which may then be used in place of the value elsewhere in the
-   document. This makes it easier to read large files, as seemingly-arbitrary
-   values now have informative names, and makes editting such files much
-   easier and less error-prone, as one only has to change the value once, at
-   the variable definition site, and the change will propagate to all uses of
-   that variable automatically.
+   across multiple files), and may not be amenable to Find-and-Replace.
 
-  <h3 id=placement><span class=secno>1.1. </span> Module Interactions</h3>
+  <p>This module introduces <b>Variables</b>, which allow a value to be
+   assigned to a name, which may then be used in place of the value elsewhere
+   in the document. This makes it easier to read large files, as
+   seemingly-arbitrary values now have informative names, and makes editting
+   such files much easier and less error-prone, as one only has to change the
+   value once, at the variable definition site, and the change will propagate
+   to all uses of that variable automatically.
 
-  <p class=replaceme>Explain, normatively, how this module affects the
-   definition of CSS.
+  <h3 id=placement><span class=secno>1.1. </span> Module Interactions</h3>
 
-  <p>This module replaces and extends the <var class=replaceme>SUMMARIZE
-   HERE</var> features defined in <a href="#CSS21"
-   rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> sections <var
-   class=replaceme>W.X and Y.Z</var>.
+  <p>This module defines a new type of primitive value, the <b>Variable</b>,
+   which is accepted by all properties.
 
   <h3 id=values><span class=secno>1.2. </span> Values</h3>
 

Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css-variables/Overview.src.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- Overview.src.html	30 Sep 2011 20:31:32 -0000	1.9
+++ Overview.src.html	30 Sep 2011 20:37:43 -0000	1.10
@@ -60,18 +60,13 @@
 
 <h2 class="no-num no-toc" id="abstract">Abstract</h2>
 
-	<p>CSS is a language for describing the rendering of structured documents
-	(such as HTML and XML) on screen, on paper,  in speech, etc. This module
-	contains the features of CSS level&nbsp;3 relating to <var class="replaceme">DESCRIBE HERE</var>.
-	It includes and extends the functionality of CSS level&nbsp;2 [[!CSS21]],
-	which builds on CSS level&nbsp;1 [[CSS1]].
-	The main extensions compared to level&nbsp;2 are <var class="replaceme">SUMMARIZE HERE</var>.
+	<p>CSS is a language for describing the rendering of structured documents (such as HTML and XML) on screen, on paper,  in speech, etc. This module contains the features of CSS level&nbsp;3 relating to variables. It includes and extends the functionality of CSS level&nbsp;2 [[!CSS21]], which builds on CSS level&nbsp;1 [[CSS1]]. The main extensions compared to level&nbsp;2 are the introduction of the variable as a new primitive value type that is accepted by all properties.
 
 <h2 class="no-num no-toc" id="status">Status of this document</h2>
 
 <!--status-->
 
-<p>The following features are at risk: &hellip;
+<!--<p>The following features are at risk: …</p>-->
 
 <h2 class="no-num no-toc" id="contents">Table of contents</h2>
 
@@ -82,15 +77,14 @@
 
 	<p><em>This section is not normative.</em></p>
 
-	<p>Large documents or applications (and even small ones) can contain quite a bit of CSS.  Many of the values in the CSS file will be duplicate data; for example, a site may establish a color scheme and reuse three or four colors throughout the site.  Altering this data can be difficult and error-prone, since it's scattered throughout the CSS file (and possibly across multiple files), and may not be amenable to Find-and-Replace.  This module introduces <b>Variables</b>, which allow a value to be assigned to a name, which may then be used in place of the value elsewhere in the document.  This makes it easier to read large files, as seemingly-arbitrary values now have informative names, and makes editting such files much easier and less error-prone, as one only has to change the value once, at the variable definition site, and the change will propagate to all uses of that variable automatically.</p>
+	<p>Large documents or applications (and even small ones) can contain quite a bit of CSS.  Many of the values in the CSS file will be duplicate data; for example, a site may establish a color scheme and reuse three or four colors throughout the site.  Altering this data can be difficult and error-prone, since it's scattered throughout the CSS file (and possibly across multiple files), and may not be amenable to Find-and-Replace.</p>
+
+	<p>This module introduces <b>Variables</b>, which allow a value to be assigned to a name, which may then be used in place of the value elsewhere in the document.  This makes it easier to read large files, as seemingly-arbitrary values now have informative names, and makes editting such files much easier and less error-prone, as one only has to change the value once, at the variable definition site, and the change will propagate to all uses of that variable automatically.</p>
 
 <h3 id="placement">
 Module Interactions</h3>
 
-	<p class="replaceme">Explain, normatively, how this module affects the definition of CSS.</p>
-
-	<p>This module replaces and extends the <var class="replaceme">SUMMARIZE HERE</var>
-	features defined in [[!CSS21]] sections <var class="replaceme">W.X and Y.Z</var>.
+	<p>This module defines a new type of primitive value, the <b>Variable</b>, which is accepted by all properties.</p>
 
 <h3 id="values">
 Values</h3>
Received on Friday, 30 September 2011 20:37:47 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 30 September 2011 20:37:47 GMT