Skip to content

Commit a43b2e7

Browse files
committed
[css-values] Rephrase the functional notation section to not emphasize comma use.
--HG-- extra : rebase_source : 530a5edb69b73e81c185b1ed195f2ec3556d0346
1 parent 2a35300 commit a43b2e7

3 files changed

Lines changed: 22 additions & 11 deletions

File tree

css-values/Overview.html

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -11,12 +11,12 @@
1111
rel=dcterms.rights>
1212
<meta content="CSS Values and Units Module Level 3" name=dcterms.title>
1313
<meta content=text name=dcterms.type>
14-
<meta content=2013-11-13 name=dcterms.date>
14+
<meta content=2013-11-21 name=dcterms.date>
1515
<meta content="Håkon Wium Lie" name=dcterms.creator>
1616
<meta content="Tab Atkins" name=dcterms.creator>
1717
<meta content="Elika J. Etemad" name=dcterms.creator>
1818
<meta content=W3C name=dcterms.publisher>
19-
<meta content="http://www.w3.org/TR/2013/CR-css3-values-20131113/"
19+
<meta content="http://www.w3.org/TR/2013/CR-css3-values-20131121/"
2020
name=dcterms.identifier>
2121
<style type="text/css">
2222
code, small { white-space: nowrap }
@@ -42,14 +42,14 @@
4242
<h1 class=p-name>CSS Values and Units Module Level 3</h1>
4343

4444
<h2 class="no-num no-toc">W3C Candidate Recommendation <span
45-
class=dt-updated><span class=value title=20131113>13 November
45+
class=dt-updated><span class=value title=20131121>21 November
4646
2013</span></span></h2>
4747

4848
<dl>
4949
<dt>This version:
5050

5151
<dd><a class=u-url
52-
href="http://www.w3.org/TR/2013/CR-css3-values-20131113/">http://www.w3.org/TR/2013/CR-css3-values-20131113/</a>
52+
href="http://www.w3.org/TR/2013/CR-css3-values-20131121/">http://www.w3.org/TR/2013/CR-css3-values-20131121/</a>
5353

5454
<dt>Latest version:
5555

@@ -1419,9 +1419,14 @@ <h2 id=functional-notation><span class=secno>8. </span> Functional
14191419
followed by a left parenthesis (i.e. a <code>FUNCTION</code> token)
14201420
followed by the argument(s) to the notation followed by a right
14211421
parenthesis. White space is allowed, but optional, immediately inside the
1422-
parentheses. If a function takes a list of arguments, the arguments are
1423-
separated by a comma (‘<code class=css>,</code>’) with optional
1424-
whitespace before and after the comma.
1422+
parentheses. Functions can take multiple arguments, which are formatted
1423+
similarly to a CSS property value.
1424+
1425+
<p> Some legacy functional notations, such as ‘<code
1426+
class=css>rgba()</code>’, use commas unnecessarily, but generally commas
1427+
are only used to separate items in a list, or pieces of a grammar that
1428+
would be ambiguous otherwise. If a comma is used to separate argument,
1429+
whitespace is optional before and after the comma.
14251430

14261431
<pre class=example>
14271432
<!-- -->background: url(http://www.example.org/image);

css-values/Overview.src.html

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -948,9 +948,15 @@ <h2 id="functional-notation">
948948
followed by the argument(s) to the notation
949949
followed by a right parenthesis.
950950
White space is allowed, but optional, immediately inside the parentheses.
951-
If a function takes a list of arguments,
952-
the arguments are separated by a comma (',')
953-
with optional whitespace before and after the comma.
951+
Functions can take multiple arguments,
952+
which are formatted similarly to a CSS property value.
953+
954+
<p>
955+
Some legacy functional notations, such as ''rgba()'', use commas unnecessarily,
956+
but generally commas are only used to separate items in a list,
957+
or pieces of a grammar that would be ambiguous otherwise.
958+
If a comma is used to separate argument,
959+
whitespace is optional before and after the comma.
954960

955961
<pre class="example">
956962
<!-- -->background: url(http://www.example.org/image);

mediaqueries/Overview.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@
5454
</p>
5555
<h1 class="p-name no-ref" id=title>Media Queries Level 4</h1>
5656
<h2 class="no-num no-toc no-ref heading settled heading" id=subtitle><span class=content>Editor’s Draft,
57-
<span class=dt-updated><span class=value-title title=20131116>16 November 2013</span></span></span></h2>
57+
<span class=dt-updated><span class=value-title title=20131119>19 November 2013</span></span></span></h2>
5858
<div data-fill-with=spec-metadata><dl><dt>This version:<dd><a class=u-url href=http://dev.w3.org/csswg/mediaqueries4/>http://dev.w3.org/csswg/mediaqueries4/</a><dt>Editor’s Draft:<dd><a href=http://dev.w3.org/csswg/mediaqueries4/>http://dev.w3.org/csswg/mediaqueries4/</a>
5959
<dt>Feedback:</dt>
6060
<dd><a href="mailto:www-style@w3.org?subject=%5Bmediaqueries%5D%20feedback">www-style@w3.org</a>

0 commit comments

Comments
 (0)