[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