[html5] r8426 - [e] (0) Audit use of 'required'. Fixing https://www.w3.org/Bugs/Public/show_bug. [...]
whatwg at whatwg.org
whatwg at whatwg.org
Mon Jan 27 15:55:25 PST 2014
Author: ianh
Date: 2014-01-27 15:55:24 -0800 (Mon, 27 Jan 2014)
New Revision: 8426
Modified:
complete.html
index
source
Log:
[e] (0) Audit use of 'required'.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=24363
Affected topics: HTML
Modified: complete.html
===================================================================
--- complete.html 2014-01-27 23:08:49 UTC (rev 8425)
+++ complete.html 2014-01-27 23:55:24 UTC (rev 8426)
@@ -3204,7 +3204,7 @@
<p>All diagrams, examples, and notes in this specification are non-normative, as are all sections
explicitly marked non-normative. Everything else in this specification is normative.</p>
- <p>The key words "MUST", "MUST NOT", "REQUIRED", <!--"SHALL", "SHALL NOT",--> "SHOULD", "SHOULD
+ <p>The key words "MUST", "MUST NOT", <!--"REQUIRED",--> <!--"SHALL", "SHALL NOT",--> "SHOULD", "SHOULD
NOT", <!--"RECOMMENDED", "NOT RECOMMENDED",--> "MAY", and "OPTIONAL" in the normative parts of
this document are to be interpreted as described in RFC2119. The key word "OPTIONALLY" in the
normative parts of this document is to be interpreted with the same normative meaning as "MAY" and
@@ -3908,7 +3908,8 @@
<p>The term <dfn id=default-object-size>default object size</dfn> is also defined in the <cite>CSS Image Values and
Replaced Content</cite> specification. <a href=#refsCSSIMAGES>[CSSIMAGES]</a></p>
- <p>Support for the CSS Object Model is required for implementations that support scripting. The
+<!--CLEANUP-->
+ <p>Implementations that support scripting must support the CSS Object Model. The
following features and terms are defined in the CSSOM specifications: <a href=#refsCSSOM>[CSSOM]</a> <a href=#refsCSSOMVIEW>[CSSOMVIEW]</a>
<ul class=brief><li><dfn id=screen><code>Screen</code></dfn></li>
@@ -5429,16 +5430,15 @@
<li>Two <a href=#ascii-digits>ASCII digits</a>, representing <var title="">minute</var>, in the range
0 ≤ <var title="">minute</var> ≤ 59</li>
- <li>Optionally (required if <var title="">second</var> is
- non-zero):
+ <li>If <var title="">second</var> is non-zero, or optionally if <var title="">second</var> is
+ zero:
<ol><li>A U+003A COLON character (:)</li>
<li>Two <a href=#ascii-digits>ASCII digits</a>, representing the integer part of <var title="">second</var>,
in the range 0 ≤ <var title="">s</var> ≤ 59</li>
- <li>Optionally (required if <var title="">second</var> is not an
- integer):
+ <li>If <var title="">second</var> is not an integer, or optionally if <var title="">second</var> is an integer:
<ol><li>A 002E FULL STOP character (.)</li>
@@ -11510,7 +11510,8 @@
<div class=impl>
- <p>User agents are required to implement ARIA semantics on all <a href=#html-elements>HTML elements</a>, as
+<!--CLEANUP-->
+ <p>User agents must implement ARIA semantics on all <a href=#html-elements>HTML elements</a>, as
defined in the ARIA specifications. The <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a> defined below
must be recognized by implementations for the purposes of ARIA processing. <a href=#refsARIAIMPL>[ARIAIMPL]</a></p>
@@ -96273,9 +96274,10 @@
<h4 id=warnings-for-obsolete-but-conforming-features><span class=secno>15.1.1 </span>Warnings for obsolete but conforming features</h4>
+<!--CLEANUP-->
<p>To ease the transition from HTML4 Transitional documents to the language defined in
<em>this</em> specification, and to discourage certain features that are only allowed in very few
- circumstances, conformance checkers are required to warn the user when the following features are
+ circumstances, conformance checkers must warn the user when the following features are
used in a document. These are generally old obsolete features that have no effect, and are allowed
only to distinguish between likely mistakes (regular conformance errors) and mere vestigial markup
or unusual and discouraged practices (these warnings).</p>
Modified: index
===================================================================
--- index 2014-01-27 23:08:49 UTC (rev 8425)
+++ index 2014-01-27 23:55:24 UTC (rev 8426)
@@ -3204,7 +3204,7 @@
<p>All diagrams, examples, and notes in this specification are non-normative, as are all sections
explicitly marked non-normative. Everything else in this specification is normative.</p>
- <p>The key words "MUST", "MUST NOT", "REQUIRED", <!--"SHALL", "SHALL NOT",--> "SHOULD", "SHOULD
+ <p>The key words "MUST", "MUST NOT", <!--"REQUIRED",--> <!--"SHALL", "SHALL NOT",--> "SHOULD", "SHOULD
NOT", <!--"RECOMMENDED", "NOT RECOMMENDED",--> "MAY", and "OPTIONAL" in the normative parts of
this document are to be interpreted as described in RFC2119. The key word "OPTIONALLY" in the
normative parts of this document is to be interpreted with the same normative meaning as "MAY" and
@@ -3908,7 +3908,8 @@
<p>The term <dfn id=default-object-size>default object size</dfn> is also defined in the <cite>CSS Image Values and
Replaced Content</cite> specification. <a href=#refsCSSIMAGES>[CSSIMAGES]</a></p>
- <p>Support for the CSS Object Model is required for implementations that support scripting. The
+<!--CLEANUP-->
+ <p>Implementations that support scripting must support the CSS Object Model. The
following features and terms are defined in the CSSOM specifications: <a href=#refsCSSOM>[CSSOM]</a> <a href=#refsCSSOMVIEW>[CSSOMVIEW]</a>
<ul class=brief><li><dfn id=screen><code>Screen</code></dfn></li>
@@ -5429,16 +5430,15 @@
<li>Two <a href=#ascii-digits>ASCII digits</a>, representing <var title="">minute</var>, in the range
0 ≤ <var title="">minute</var> ≤ 59</li>
- <li>Optionally (required if <var title="">second</var> is
- non-zero):
+ <li>If <var title="">second</var> is non-zero, or optionally if <var title="">second</var> is
+ zero:
<ol><li>A U+003A COLON character (:)</li>
<li>Two <a href=#ascii-digits>ASCII digits</a>, representing the integer part of <var title="">second</var>,
in the range 0 ≤ <var title="">s</var> ≤ 59</li>
- <li>Optionally (required if <var title="">second</var> is not an
- integer):
+ <li>If <var title="">second</var> is not an integer, or optionally if <var title="">second</var> is an integer:
<ol><li>A 002E FULL STOP character (.)</li>
@@ -11510,7 +11510,8 @@
<div class=impl>
- <p>User agents are required to implement ARIA semantics on all <a href=#html-elements>HTML elements</a>, as
+<!--CLEANUP-->
+ <p>User agents must implement ARIA semantics on all <a href=#html-elements>HTML elements</a>, as
defined in the ARIA specifications. The <a href=#default-implicit-aria-semantics>default implicit ARIA semantics</a> defined below
must be recognized by implementations for the purposes of ARIA processing. <a href=#refsARIAIMPL>[ARIAIMPL]</a></p>
@@ -96273,9 +96274,10 @@
<h4 id=warnings-for-obsolete-but-conforming-features><span class=secno>15.1.1 </span>Warnings for obsolete but conforming features</h4>
+<!--CLEANUP-->
<p>To ease the transition from HTML4 Transitional documents to the language defined in
<em>this</em> specification, and to discourage certain features that are only allowed in very few
- circumstances, conformance checkers are required to warn the user when the following features are
+ circumstances, conformance checkers must warn the user when the following features are
used in a document. These are generally old obsolete features that have no effect, and are allowed
only to distinguish between likely mistakes (regular conformance errors) and mere vestigial markup
or unusual and discouraged practices (these warnings).</p>
Modified: source
===================================================================
--- source 2014-01-27 23:08:49 UTC (rev 8425)
+++ source 2014-01-27 23:55:24 UTC (rev 8426)
@@ -1911,7 +1911,7 @@
<p>All diagrams, examples, and notes in this specification are non-normative, as are all sections
explicitly marked non-normative. Everything else in this specification is normative.</p>
- <p>The key words "MUST", "MUST NOT", "REQUIRED", <!--"SHALL", "SHALL NOT",--> "SHOULD", "SHOULD
+ <p>The key words "MUST", "MUST NOT", <!--"REQUIRED",--> <!--"SHALL", "SHALL NOT",--> "SHOULD", "SHOULD
NOT", <!--"RECOMMENDED", "NOT RECOMMENDED",--> "MAY", and "OPTIONAL" in the normative parts of
this document are to be interpreted as described in RFC2119. The key word "OPTIONALLY" in the
normative parts of this document is to be interpreted with the same normative meaning as "MAY" and
@@ -2682,7 +2682,8 @@
<p>The term <dfn>default object size</dfn> is also defined in the <cite>CSS Image Values and
Replaced Content</cite> specification. <a href="#refsCSSIMAGES">[CSSIMAGES]</a></p>
- <p>Support for the CSS Object Model is required for implementations that support scripting. The
+<!--CLEANUP-->
+ <p>Implementations that support scripting must support the CSS Object Model. The
following features and terms are defined in the CSSOM specifications: <a
href="#refsCSSOM">[CSSOM]</a> <a href="#refsCSSOMVIEW">[CSSOMVIEW]</a>
@@ -4484,8 +4485,8 @@
<li>Two <span>ASCII digits</span>, representing <var data-x="">minute</var>, in the range
0 ≤ <var data-x="">minute</var> ≤ 59</li>
- <li>Optionally (required if <var data-x="">second</var> is
- non-zero):
+ <li>If <var data-x="">second</var> is non-zero, or optionally if <var data-x="">second</var> is
+ zero:
<ol>
@@ -4494,8 +4495,8 @@
<li>Two <span>ASCII digits</span>, representing the integer part of <var data-x="">second</var>,
in the range 0 ≤ <var data-x="">s</var> ≤ 59</li>
- <li>Optionally (required if <var data-x="">second</var> is not an
- integer):
+ <li>If <var data-x="">second</var> is not an integer, or optionally if <var
+ data-x="">second</var> is an integer:
<ol>
@@ -11556,7 +11557,8 @@
<div class="impl">
- <p>User agents are required to implement ARIA semantics on all <span>HTML elements</span>, as
+<!--CLEANUP-->
+ <p>User agents must implement ARIA semantics on all <span>HTML elements</span>, as
defined in the ARIA specifications. The <span>default implicit ARIA semantics</span> defined below
must be recognized by implementations for the purposes of ARIA processing. <a
href="#refsARIAIMPL">[ARIAIMPL]</a></p>
@@ -107180,9 +107182,10 @@
<h4>Warnings for obsolete but conforming features</h4>
+<!--CLEANUP-->
<p>To ease the transition from HTML4 Transitional documents to the language defined in
<em>this</em> specification, and to discourage certain features that are only allowed in very few
- circumstances, conformance checkers are required to warn the user when the following features are
+ circumstances, conformance checkers must warn the user when the following features are
used in a document. These are generally old obsolete features that have no effect, and are allowed
only to distinguish between likely mistakes (regular conformance errors) and mere vestigial markup
or unusual and discouraged practices (these warnings).</p>
More information about the Commit-Watchers
mailing list