[css3-conditional] Describe requirements for conditionText getter on CSSSupportsRule.
authorL. David Baron <dbaron@dbaron.org>
Thu, 07 Feb 2013 14:29:04 -0800
changeset 73877dace721dff3
parent 7386 4bce5575a484
child 7388 7006601d0318
[css3-conditional] Describe requirements for conditionText getter on CSSSupportsRule.

This implements the resolution in
http://lists.w3.org/Archives/Public/www-style/2012Aug/0749.html
to address the second point in
http://lists.w3.org/Archives/Public/www-style/2013Feb/0228.html
which is Issue 8 in the Last Call Disposition of Comments.

It also adds a parenthetical to clarify the issue rejected in
http://lists.w3.org/Archives/Public/www-style/2012Dec/0102.html
css3-conditional/Overview.html
css3-conditional/Overview.src.html
     1.1 --- a/css3-conditional/Overview.html	Thu Feb 07 14:03:18 2013 -0800
     1.2 +++ b/css3-conditional/Overview.html	Thu Feb 07 14:29:04 2013 -0800
     1.3 @@ -1214,6 +1214,7 @@
     1.4      with the ‘<code class=css>@media</code>’ rule.
     1.5  
     1.6     <dt><code>conditionText</code> of type <code>DOMString</code>
     1.7 +    (CSSMediaRule-specific definition for attribute on CSSConditionRule)
     1.8  
     1.9     <dd>The <code>conditionText</code> attribute (defined on the <a
    1.10      href="#cssconditionrule"><code>CSSConditionRule</code></a> parent rule),
    1.11 @@ -1231,6 +1232,24 @@
    1.12  
    1.13    <pre class=idl>interface CSSSupportsRule : CSSConditionRule {
    1.14  }</pre>
    1.15 +
    1.16 +  <dl class=idl-attributes>
    1.17 +   <dt><code>conditionText</code> of type <code>DOMString</code>
    1.18 +    (CSSSupportsRule-specific definition for attribute on CSSConditionRule)
    1.19 +
    1.20 +   <dd>The <code>conditionText</code> attribute (defined on the <a
    1.21 +    href="#cssconditionrule"><code>CSSConditionRule</code></a> parent rule),
    1.22 +    on getting, must return the condition that was specified, without any
    1.23 +    logical simplifications, so that the returned condition will evaluate to
    1.24 +    the same result as the specified condition in any conformant
    1.25 +    implementation of this specification (including implementations that
    1.26 +    implement future extensions allowed by the <a
    1.27 +    href="#general_enclosed"><i>general_enclosed</i></a> exensibility
    1.28 +    mechanism in this specification). In other words, token stream
    1.29 +    simplifications are allowed (such as reducing whitespace to a single
    1.30 +    space or omitting it in cases where it is known to be optional), but
    1.31 +    logical simplifications are not allowed.
    1.32 +  </dl>
    1.33    <!--
    1.34  <h3 id="the-cssdocumentrule-interface">
    1.35  The <code>CSSDocumentRule</code> interface</h3>
     2.1 --- a/css3-conditional/Overview.src.html	Thu Feb 07 14:03:18 2013 -0800
     2.2 +++ b/css3-conditional/Overview.src.html	Thu Feb 07 14:29:04 2013 -0800
     2.3 @@ -973,7 +973,7 @@
     2.4    <dd>The <code>media</code> attribute must return a <code>MediaList</code> object
     2.5      for the list of media queries specified with the ''@media'' rule.
     2.6  
     2.7 -  <dt><code>conditionText</code> of type <code>DOMString</code>
     2.8 +  <dt><code>conditionText</code> of type <code>DOMString</code> (CSSMediaRule-specific definition for attribute on CSSConditionRule)
     2.9    <dd>The <code>conditionText</code> attribute (defined on the <code>CSSConditionRule</code> parent rule),
    2.10      on getting, must return the value of <code>media.mediaText</code> on the rule.
    2.11  
    2.12 @@ -990,6 +990,24 @@
    2.13  <pre class='idl'>interface CSSSupportsRule : CSSConditionRule {
    2.14  }</pre>
    2.15  
    2.16 +<dl class='idl-attributes'>
    2.17 +  <dt><code>conditionText</code> of type <code>DOMString</code> (CSSSupportsRule-specific definition for attribute on CSSConditionRule)
    2.18 +  <dd>The <code>conditionText</code> attribute (defined on the <code>CSSConditionRule</code> parent rule),
    2.19 +    on getting, must return the condition that was specified,
    2.20 +    without any logical simplifications,
    2.21 +    so that the returned condition will evaluate to the same result
    2.22 +    as the specified condition
    2.23 +    in any conformant implementation of this specification
    2.24 +    (including implementations that implement future extensions
    2.25 +    allowed by the <i>general_enclosed</i> exensibility mechanism in this specification).
    2.26 +    In other words,
    2.27 +    token stream simplifications are allowed
    2.28 +    (such as reducing whitespace to a single space
    2.29 +    or omitting it in cases where it is known to be optional),
    2.30 +    but logical simplifications are not allowed.
    2.31 +
    2.32 +</dl>
    2.33 +
    2.34  <!--
    2.35  <h3 id="the-cssdocumentrule-interface">
    2.36  The <code>CSSDocumentRule</code> interface</h3>