csswg/css3-values Overview.html,1.98,1.99 Overview.src.html,1.101,1.102

Update of /sources/public/csswg/css3-values
In directory hutz:/tmp/cvs-serv14677

Modified Files:
	Overview.html Overview.src.html 
Log Message:
Editorial rearranging/rewriting to make the intro for attr() better.

Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-values/Overview.html,v
retrieving revision 1.98
retrieving revision 1.99
diff -u -d -r1.98 -r1.99
--- Overview.html	10 Oct 2011 20:47:43 -0000	1.98
+++ Overview.html	10 Oct 2011 21:22:12 -0000	1.99
@@ -1474,17 +1474,27 @@
   <h3 id=attr><span class=secno>9.3. </span> Attribute References:
    &lsquo;<code class=css>attr()</code>&rsquo;</h3>
 
-  <p class=issue>Describe the feature fully here, not just a delta from CSS
-   21.
-
   <p class=issue>When attr is set on a pseudo-element, it should apply to the
    originating element
 
-  <p>In CSS2.1 <a href="#CSS21" rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a>,
-   the &lsquo;<code class=css>attr()</code>&rsquo; expression always returns
-   a string. In CSS3, the &lsquo;<code class=css>attr()</code>&rsquo;
-   expression can return many different types. The new syntax for the
-   &lsquo;<code class=css>attr()</code>&rsquo; expression is:
+  <p>The &lsquo;<code class=css>attr()</code>&rsquo; function returns the
+   value of an attribute on the element.
+
+  <p>The &lsquo;<code class=css>attr()</code>&rsquo; expression cannot return
+   everything, for example it cannot do counters, named strings, quotes, or
+   values such as &lsquo;<code class=css>auto</code>&rsquo;, &lsquo;<code
+   class=css>nowrap</code>&rsquo;, or &lsquo;<code
+   class=css>baseline</code>&rsquo;. This is intentional, as the intent of
+   the &lsquo;<code class=css>attr()</code>&rsquo; expression is not to make
+   it possible to describe a presentational language's formatting using CSS,
+   but to enable CSS to take semantic data into account. In CSS2.1 <a
+   href="#CSS21" rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a>, the
+   &lsquo;<code class=css>attr()</code>&rsquo; expression always returns a
+   string. In CSS3, the &lsquo;<code class=css>attr()</code>&rsquo;
+   expression can return many different types.
+
+  <p>The new syntax for the &lsquo;<code class=css>attr()</code>&rsquo;
+   expression is:
 
   <pre>'attr(' <a
    href="#wqname"><var>wqname</var></a> [ ',' &lt;type> [ ',' &lt;value> ]? ]? ')'</pre>
@@ -1621,15 +1631,6 @@
 color: attr(color); /* 'color' doesn't accept strings */</pre>
   </div>
 
-  <p>The &lsquo;<code class=css>attr()</code>&rsquo; expression cannot return
-   everything, for example it cannot do counters, named strings, quotes, or
-   values such as &lsquo;<code class=css>auto</code>&rsquo;, &lsquo;<code
-   class=css>nowrap</code>&rsquo;, or &lsquo;<code
-   class=css>baseline</code>&rsquo;. This is intentional, as the intent of
-   the &lsquo;<code class=css>attr()</code>&rsquo; expression is not to make
-   it possible to describe a presentational language's formatting using CSS,
-   but to enable CSS to take semantic data into account.
-
   <p class=note>Note that the default value need not be of the type given.
    For instance, if the type required of the attribute by the author is
    &lsquo;<code class=css>px</code>&rsquo;, the default could still be

Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-values/Overview.src.html,v
retrieving revision 1.101
retrieving revision 1.102
diff -u -d -r1.101 -r1.102
--- Overview.src.html	10 Oct 2011 20:47:48 -0000	1.101
+++ Overview.src.html	10 Oct 2011 21:22:12 -0000	1.102
@@ -1030,13 +1030,20 @@
 <h3 id="attr">
 Attribute References: ''attr()''</h3>
 
-	<p class=issue>Describe the feature fully here, not just a delta from CSS 21.</p>
-
 	<p class=issue>When attr is set on a pseudo-element, it should apply to the originating element</p>
 
-	<p>In CSS2.1 [[!CSS21]], the ''attr()'' expression always returns a
-	string. In CSS3, the ''attr()'' expression can return many different
-	types. The new syntax for the ''attr()'' expression is:</p>
+	<p>The ''attr()'' function returns the value of an attribute on the element.</p>
+
+	<p>The ''attr()'' expression cannot return everything, for example it cannot
+	do counters, named strings, quotes, or values such as ''auto'',
+	''nowrap'', or ''baseline''. This is intentional, as the intent of the
+	''attr()'' expression is not to make it possible to describe a
+	presentational language's formatting using CSS, but to enable CSS
+	to take semantic data into account.  In CSS2.1 [[!CSS21]], the ''attr()''
+	expression always returns a	string. In CSS3, the ''attr()'' expression can
+	return many different types. 
+
+	<p>The new syntax for the ''attr()'' expression is:</p>
 
 	<pre>'attr(' <var>wqname</var> [ ',' &lt;type> [ ',' &lt;value> ]? ]? ')'</pre>
 
@@ -1153,13 +1160,6 @@
 color: attr(color); /* 'color' doesn't accept strings */</pre>
 	</div>
 
-	<p>The ''attr()'' expression cannot return everything, for example it cannot
-	do counters, named strings, quotes, or values such as ''auto'',
-	''nowrap'', or ''baseline''. This is intentional, as the intent of the
-	''attr()'' expression is not to make it possible to describe a
-	presentational language's formatting using CSS, but to enable CSS
-	to take semantic data into account.</p>
-
 	<p class='note'>Note that the default value need not be of the type given. For
 	instance, if the type required of the attribute by the author is
 	''px'', the default could still be ''5em''.</p>

Received on Monday, 10 October 2011 21:22:17 UTC