Skip to content

Commit d98eb1d

Browse files
committed
[mediaqueries-3] Mark normative errata as candidate change
1 parent f816710 commit d98eb1d

1 file changed

Lines changed: 38 additions & 3 deletions

File tree

mediaqueries-3/Overview.html

Lines changed: 38 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -157,6 +157,8 @@ <h2 class="no-num no-toc" id=status>Status of this document</h2>
157157
W3C Patent Policy</a>.</p>
158158
<!--end-status-->
159159

160+
<div class="correction"><a href="https://www.w3.org/Consortium/Process/#candidate-correction">Candidate corrections</a> are marked in the document.</div>
161+
160162
<nav id="toc">
161163
<h2 class="no-num no-toc" id=contents>Table of contents</h2>
162164
<!--begin-toc-->
@@ -560,18 +562,43 @@ <h3 id=error-handling><span class=secno>3.1. </span>Error Handling</h3>
560562
<p>For media queries that are not conforming user agents need to follow the
561563
rules described in this section.
562564

565+
<div class="correction" id="c1">
566+
<span class="marker">Candidate Correction 1:</span>
567+
Clarify that the keywords ‘<code>not</code>’, ‘<code>and</code>’, ‘<code>only</code>’, and ‘<code>or</code>’ should not be treated as unknown media types,
568+
but as syntax errors when used in place of media types.
569+
570+
<p>The reasoning for this change can be found in <a href="https://lists.w3.org/Archives/Public/www-style/2013May/0783.html">the minutes of the 2013-05-30 CSS WG teleconference</a>
571+
and in the emails referenced therefrom.
572+
<details>
573+
<summary>This change has tests</summary>
574+
<a href="https://github.com/web-platform-tests/wpt/commit/ea1821d4bd24ed1e859db03571cca8e783dbf957">Tests for this change</a> have been added to <abbr title="Web Platform Tests">WPT</abbr>.
575+
The results can be viewed at <a href="https://wpt.fyi/results/css/mediaqueries?q=mq-invalid-media-type">wpt.fyi</a>.
576+
</details>
577+
</div>
578+
563579
<ul>
564580
<li>
565581
<p><strong>Unknown media types.</strong> Unknown media types evaluate to
566582
false. Effectively, they are treated identically to known media types
567-
that do not match the media type of the device.</p>
583+
that do not match the media type of the device.
584+
<ins cite="#c1">However, an exception is made for media types ‘<code>not</code>’, ‘<code>and</code>’, ‘<code>only</code>’, and ‘<code>or</code>’.
585+
Even though they do match the IDENT production,
586+
they must not be treated as unknown media types,
587+
but rather trigger the malformed query clause.</ins></p>
568588

569589
<div class=example>
570590
<p>The media query "<code>unknown</code>" will evaluate to false, unless
571591
<code>unknown</code> is actually a supported media type. Similarly,
572592
"<code>not unknown</code>" will evaluate to true.</p>
573593
</div>
574594

595+
<ins cite="#c1">
596+
<div class="example">
597+
<p>The following is a malformed media query because it uses ‘<code>only</code>’ and ‘<code>or</code>’ as media types.</p>
598+
<pre><code>@media only and or { … }</code></pre>
599+
</div>
600+
</ins>
601+
575602
<p class=note>Unknown media types are distinct from media types that do
576603
not actually match the IDENT production. Those fall under the malformed
577604
media query clause.</p>
@@ -1104,7 +1131,15 @@ <h2 id=changes><span class=secno>7. </span>Changes</h2>
11041131
<h3 id=changes-2012><span class=secno>7.1. </span>Changes Since the 19 June 2012
11051132
Recommendation</h3>
11061133

1107-
<p>A handful of editorial and markup corrections were made:
1134+
<p>Candidate Corrections were introduced:
1135+
<ul>
1136+
<li><a href="#c1">Candidate Change 1</a> in <a href="#error-handling">Section 3.1</a>:
1137+
Clarify that the keywords ‘<code>not</code>’, ‘<code>and</code>’, ‘<code>only</code>’, and ‘<code>or</code>’ should not be treated as unknown media types,
1138+
but as syntax errors when used in place of media types.
1139+
1140+
</ul>
1141+
1142+
<p>A handful of editorial and markup corrections were also made:
11081143

11091144
<ul>
11101145
<li><a href="#media0">Section 2</a>: Dropped a redundant attribute in an example.
@@ -1270,4 +1305,4 @@ <h3 class=no-num id=other-references>Other references</h3>
12701305
<!---->
12711306
</dl>
12721307
<!--end-informative-->
1273-
<script src="https://www.w3.org/scripts/TR/fixup.js"></script>
1308+
<script src="https://www.w3.org/scripts/TR/2021/fixup.js"></script>

0 commit comments

Comments
 (0)