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

csswg/css3-values Overview.html,1.117,1.118 Overview.src.html,1.120,1.121

From: Tab Atkins Jr.. via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 11 Oct 2011 00:35:11 +0000
To: public-css-commits@w3.org
Message-Id: <E1RDQJL-00031x-9r@lionel-hutz.w3.org>
Update of /sources/public/csswg/css3-values
In directory hutz:/tmp/cvs-serv11635

Modified Files:
	Overview.html Overview.src.html 
Log Message:
Formatting tweaks.  Editorial.

Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-values/Overview.html,v
retrieving revision 1.117
retrieving revision 1.118
diff -u -d -r1.117 -r1.118
--- Overview.html	11 Oct 2011 00:30:59 -0000	1.117
+++ Overview.html	11 Oct 2011 00:35:09 -0000	1.118
@@ -139,9 +139,9 @@
    &lsquo;<a href="#vw-unit"><code class=css>vw</code></a>&rsquo;, &lsquo;<a
    href="#vm-unit"><code class=css>vm</code></a>&rsquo;, &lsquo;<a
    href="#fr-unit"><code class=css>fr</code></a>&rsquo;, &lsquo;<a
-   href="#gr-unit"><code class=css>gr</code></a>&rsquo;, &lsquo;<code
-   class=css>cycle()</code>&rsquo;, &lsquo;<code
-   class=css>attr()</code>&rsquo;.
+   href="#gr-unit"><code class=css>gr</code></a>&rsquo;, &lsquo;<a
+   href="#cycle-value"><code class=css>cycle()</code></a>&rsquo;, &lsquo;<a
+   href="#attr-value"><code class=css>attr()</code></a>&rsquo;.
 
   <h2 class="no-num no-toc" id=contents>Table of contents</h2>
   <!--begin-toc-->
@@ -1452,37 +1452,38 @@
    treated as if &lsquo;<code class=property>auto</code>&rsquo; had been
    specified.
 
-  <h3 id=cycle><span class=secno>9.2. </span> Cycling Values: &lsquo;<code
-   class=css>cycle()</code>&rsquo;</h3>
+  <h3 id=cycle><span class=secno>9.2. </span> Cycling Values: &lsquo;<a
+   href="#cycle-value"><code class=css>cycle()</code></a>&rsquo;</h3>
 
-  <p>The <dfn id=cycle0>&lsquo;<code class=css>cycle()</code>&rsquo;</dfn>
-   expression allows descendant elements to cycle over a list of values
-   instead of inheriting the same value. The syntax of the &lsquo;<code
-   class=css>cycle()</code>&rsquo; expression is:
+  <p>The <dfn id=cycle-value>cycle()</dfn> expression allows descendant
+   elements to cycle over a list of values instead of inheriting the same
+   value. The syntax of the &lsquo;<a href="#cycle-value"><code
+   class=css>cycle()</code></a>&rsquo; expression is:
 
   <pre>cycle( &lt;value&gt;# )</pre>
 
   <p>where <code>&lt;value&gt;</code> is a CSS value that is valid where the
    expression is placed. If any of the values inside are not valid, then the
-   entire &lsquo;<code class=css>cycle()</code>&rsquo; expression is invalid.
-   
+   entire &lsquo;<a href="#cycle-value"><code
+   class=css>cycle()</code></a>&rsquo; expression is invalid.
 
-  <p>The value returned by &lsquo;<code class=css>cycle()</code>&rsquo; must
-   be determined by comparing the inherited value <var>I</var> (the computed
-   value on the parent, or, for the root, the initial value) to the computed
-   values <var>C<sub>n</sub></var> returned by the <var>n</var>-th argument
-   to &lsquo;<code class=css>cycle()</code>&rsquo;. For the earliest
-   <var>C<sub>n</sub></var> such that <var>C<sub>n</sub></var> =
-   <var>I</var>, the value returned by cycle is <var>C<sub>n+1</sub></var>.
-   However, if this <var>C<sub>n</sub></var> is the last value, or if there
-   are no <var>C<sub>n</sub></var> that equal <var>I</var>, the computed
-   value of the first value is returned instead.
+  <p>The value returned by &lsquo;<a href="#cycle-value"><code
+   class=css>cycle()</code></a>&rsquo; must be determined by comparing the
+   inherited value <var>I</var> (the computed value on the parent, or, for
+   the root, the initial value) to the computed values
+   <var>C<sub>n</sub></var> returned by the <var>n</var>-th argument to
+   &lsquo;<a href="#cycle-value"><code class=css>cycle()</code></a>&rsquo;.
+   For the earliest <var>C<sub>n</sub></var> such that
+   <var>C<sub>n</sub></var> = <var>I</var>, the value returned by cycle is
+   <var>C<sub>n+1</sub></var>. However, if this <var>C<sub>n</sub></var> is
+   the last value, or if there are no <var>C<sub>n</sub></var> that equal
+   <var>I</var>, the computed value of the first value is returned instead.
 
-  <p class=note>Note that &lsquo;<code class=css>cycle()</code>&rsquo;
-   explicitly looks at the computed value of the parent, so it is useful even
-   for non-inherited properties. This is similar to the &lsquo;<code
-   class=css>inherit</code>&rsquo; keyword, which is useful even for
-   non-inherited properties.
+  <p class=note>Note that &lsquo;<a href="#cycle-value"><code
+   class=css>cycle()</code></a>&rsquo; explicitly looks at the computed value
+   of the parent, so it is useful even for non-inherited properties. This is
+   similar to the &lsquo;<code class=css>inherit</code>&rsquo; keyword, which
+   is useful even for non-inherited properties.
 
   <div class=example>
    <pre>
@@ -1500,37 +1501,40 @@
   li > ul { list-style-type: cycle(disk, circle, square, box); }</pre>
   </div>
 
-  <p>The &lsquo;<code class=css>cycle()</code>&rsquo; notation is not allowed
-   to be nested; nor may it contain &lsquo;<code
-   class=css>attr()</code>&rsquo;, &lsquo;<a href="#calc0"><code
+  <p>The &lsquo;<a href="#cycle-value"><code
+   class=css>cycle()</code></a>&rsquo; notation is not allowed to be nested;
+   nor may it contain &lsquo;<a href="#attr-value"><code
+   class=css>attr()</code></a>&rsquo;, &lsquo;<a href="#calc0"><code
    class=css>calc()</code></a>&rsquo;, &lsquo;<a href="#min"><code
    class=css>min()</code></a>&rsquo;, or &lsquo;<a href="#max"><code
    class=css>max()</code></a>&rsquo; notations. Declarations containing such
    constructs are invalid.
 
-  <h3 id=attr><span class=secno>9.3. </span> Attribute References:
-   &lsquo;<code class=css>attr()</code>&rsquo;</h3>
+  <h3 id=attr><span class=secno>9.3. </span> Attribute References: &lsquo;<a
+   href="#attr-value"><code class=css>attr()</code></a>&rsquo;</h3>
 
-  <p>The &lsquo;<code class=css>attr()</code>&rsquo; function returns the
-   value of an attribute on the element for use as a value in a property. If
-   used on a pseudo-element, it returns the value of the attribute on the
+  <p>The <dfn id=attr-value>attr()</dfn> function returns the value of an
+   attribute on the element for use as a value in a property. If used on a
+   pseudo-element, it returns the value of the attribute on the
    pseudo-element's 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 &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
+   the &lsquo;<a href="#attr-value"><code class=css>attr()</code></a>&rsquo;
+   expression always returns a string. In CSS3, the &lsquo;<a
+   href="#attr-value"><code class=css>attr()</code></a>&rsquo; expression can
+   return many different types. The &lsquo;<a href="#attr-value"><code
+   class=css>attr()</code></a>&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.
+   the &lsquo;<a href="#attr-value"><code class=css>attr()</code></a>&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>The new syntax for the &lsquo;<code class=css>attr()</code>&rsquo;
-   expression is:
+  <p>The new syntax for the &lsquo;<a href="#attr-value"><code
+   class=css>attr()</code></a>&rsquo; expression is:
 
   <pre>'attr(' <a
    href="#wqname"><var>wqname</var></a> [ ',' &lt;type> [ ',' &lt;value> ]? ]? ')'</pre>
@@ -1547,29 +1551,33 @@
   <!-- TODO: Delete this syntax definition when Namespaces is updated to contain the wqname production -->
 
   <p>The <a href="#wqname"><i>wqname</i></a> argument represents an attribute
-   name. The computed value of the &lsquo;<code
-   class=css>attr()</code>&rsquo; expression is the value of the attribute
-   with that name on the element, according to the rules given below.
+   name. The computed value of the &lsquo;<a href="#attr-value"><code
+   class=css>attr()</code></a>&rsquo; expression is the value of the
+   attribute with that name on the element, according to the rules given
+   below.
 
   <p>The &lsquo;<code class=css>&lt;type></code>&rsquo; argument (which is
    optional but must be present if the third argument is present) is a
    keyword drawn from the list below that tells the UA how to interpret the
    attribute value. If omitted, &lsquo;<code class=css>string</code>&rsquo;
-   is implied. If the type is not valid for where the &lsquo;<code
-   class=css>attr()</code>&rsquo; expression is placed, the whole
-   &lsquo;<code class=css>attr()</code>&rsquo; expression is invalid.
+   is implied. If the type is not valid for where the &lsquo;<a
+   href="#attr-value"><code class=css>attr()</code></a>&rsquo; expression is
+   placed, the whole &lsquo;<a href="#attr-value"><code
+   class=css>attr()</code></a>&rsquo; expression is invalid.
 
   <p>The &lsquo;<code class=css>&lt;value></code>&rsquo; argument (which is
-   optional) is a CSS value which must be valid where the &lsquo;<code
-   class=css>attr()</code>&rsquo; expression is placed. It represents a
-   fallback value to be used if the named attribute is missing, or its value
-   cannot be parsed into the given type or is invalid/out-of-range for the
-   property. If the &lsquo;<code class=css>&lt;value></code>&rsquo; argument
-   is not valid for the property where the &lsquo;<code
-   class=css>attr()</code>&rsquo; expression is placed, the whole
-   &lsquo;<code class=css>attr()</code>&rsquo; expression is invalid. If the
-   fallback &lsquo;<code class=css>&lt;value></code>&rsquo; is absent, the
-   default value for the given type (from the list below) is implied.
+   optional) is a CSS value which must be valid where the &lsquo;<a
+   href="#attr-value"><code class=css>attr()</code></a>&rsquo; expression is
+   placed. It represents a fallback value to be used if the named attribute
+   is missing, or its value cannot be parsed into the given type or is
+   invalid/out-of-range for the property. If the &lsquo;<code
+   class=css>&lt;value></code>&rsquo; argument is not valid for the property
+   where the &lsquo;<a href="#attr-value"><code
+   class=css>attr()</code></a>&rsquo; expression is placed, the whole
+   &lsquo;<a href="#attr-value"><code class=css>attr()</code></a>&rsquo;
+   expression is invalid. If the fallback &lsquo;<code
+   class=css>&lt;value></code>&rsquo; is absent, the default value for the
+   given type (from the list below) is implied.
 
   <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
@@ -1752,9 +1760,11 @@
 color: attr(color); /* 'color' doesn't accept strings */</pre>
   </div>
 
-  <p class=note>The &lsquo;<code class=css>attr()</code>&rsquo; expression
-   cannot currently fall back onto another attribute. Future versions of CSS
-   may extend &lsquo;<code class=css>attr()</code>&rsquo; in this direction.</p>
+  <p class=note>The &lsquo;<a href="#attr-value"><code
+   class=css>attr()</code></a>&rsquo; expression cannot currently fall back
+   onto another attribute. Future versions of CSS may extend &lsquo;<a
+   href="#attr-value"><code class=css>attr()</code></a>&rsquo; in this
+   direction.</p>
   <!--
 <h4>The 'counter' function</h4>
 
@@ -2264,6 +2274,9 @@
    <li>&lt;angle&gt;, <a href="#angle-value"
     title="&lt;angle&gt;"><strong>6.1.</strong></a>
 
+   <li>attr(), <a href="#attr-value" title="attr()"><strong>9.3.</strong></a>
+    
+
    <li>calc(), <a href="#calc0" title="calc()"><strong>9.1.</strong></a>
 
    <li>ch, <a href="#ch-unit" title=ch><strong>5.1.1.</strong></a>
@@ -2274,8 +2287,8 @@
    <li>computed value, <a href="#computed-value"
     title="computed value"><strong>10.2.</strong></a>
 
-   <li>&lsquo;<code class=css>cycle()</code>&rsquo;, <a href="#cycle0"
-    title="''cycle()''"><strong>9.2.</strong></a>
+   <li>cycle(), <a href="#cycle-value"
+    title="cycle()"><strong>9.2.</strong></a>
 
    <li>deg, <a href="#deg" title=deg><strong>6.1.</strong></a>
 

Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-values/Overview.src.html,v
retrieving revision 1.120
retrieving revision 1.121
diff -u -d -r1.120 -r1.121
--- Overview.src.html	11 Oct 2011 00:30:59 -0000	1.120
+++ Overview.src.html	11 Oct 2011 00:35:09 -0000	1.121
@@ -999,7 +999,7 @@
 <h3 id="cycle">
 Cycling Values: ''cycle()''</h3>
 
-	<p>The <dfn>''cycle()''</dfn> expression allows descendant elements
+	<p>The <dfn id='cycle-value'>cycle()</dfn> expression allows descendant elements
 	to cycle over a list of values instead of inheriting the same value.
 	The syntax of the ''cycle()'' expression is:
 
@@ -1049,7 +1049,7 @@
 <h3 id="attr">
 Attribute References: ''attr()''</h3>
 
-	<p>The ''attr()'' function returns the value of an attribute on the element 
+	<p>The <dfn id='attr-value'>attr()</dfn> function returns the value of an attribute on the element 
 	for use as a value in a property.  If used on a pseudo-element, it returns 
 	the value of the attribute on the pseudo-element's originating element.</p>
 
Received on Tuesday, 11 October 2011 00:35:13 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 11 October 2011 00:35:13 GMT