W3C home > Mailing lists > Public > public-html-diffs@w3.org > April 2010

hixie: Try to be more consistent about the use of the word 'error'. (whatwg r4999)

From: poot <cvsmail@w3.org>
Date: Tue, 13 Apr 2010 07:09:29 +0900 (JST)
To: public-html-diffs@w3.org
Message-Id: <20100412220929.AB6662BC14@toro.w3.mag.keio.ac.jp>
hixie: Try to be more consistent about the use of the word 'error'.
(whatwg r4999)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.4016&r2=1.4017&f=h
http://html5.org/tools/web-apps-tracker?from=4998&to=4999

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4016
retrieving revision 1.4017
diff -u -d -r1.4016 -r1.4017
--- Overview.html	12 Apr 2010 08:04:12 -0000	1.4016
+++ Overview.html	12 Apr 2010 22:09:07 -0000	1.4017
@@ -1720,7 +1720,7 @@
    </dd>
 
 
-   <dt>Errors that help authors avoid fragile syntax constructs</dt>
+   <dt>Errors involving fragile syntax constructs</dt>
 
    <dd>
 
@@ -1763,7 +1763,7 @@
    </dd>
 
 
-   <dt>Errors that flag known interoperability problems in legacy user agents</dt>
+   <dt>Errors involving known interoperability problems in legacy user agents</dt>
 
    <dd>
 
@@ -1792,7 +1792,7 @@
    </dd>
 
 
-   <dt>Errors that protect authors from security attacks</dt>
+   <dt>Errors that risk exposing authors to security attacks</dt>
 
    <dd>
 
@@ -1814,8 +1814,9 @@
 
    <dd>
 
-    <p>Some errors merely flag cases where the author's intent is most
-    unclear. Correcting these errors early makes later maintenance easier.</p>
+    <p>Markup where the author's intent is very unclear is often made
+    non-conforming. Correcting these errors early makes later
+    maintenance easier.</p>
 
     <div class="example">
 
@@ -1851,11 +1852,11 @@
    </dd>
 
 
-   <dt>Errors that allow for new syntax in future</dt>
+   <dt>Errors that could interfere with new syntax in the future</dt>
 
    <dd>
 
-    <p>In order to allow us to extend the language syntax in the
+    <p>In order to allow the language syntax to be extended in the
     future, certain otherwise harmless features are disallowed.</p>
 
     <div class="example">
@@ -1878,7 +1879,7 @@
   provide modes of operation wherein such conventions are
   enforced.<h4 id="restrictions-on-content-models-and-on-attribute-values"><span class="secno">1.9.3 </span>Restrictions on content models and on attribute values</h4><p><i>This section is non-normative.</i><p>Beyond the syntax of the language, this specification also places
   restrictions on how elements and attributes can be specified. These
-  restrictions are present for similar reasons:<dl><dt>Errors that flag content with dubious semantics</dt>
+  restrictions are present for similar reasons:<dl><dt>Errors involving content with dubious semantics</dt>
 
    <dd>
 
@@ -1894,7 +1895,7 @@
    </dd>
 
 
-   <dt>Errors that indicate a conflict in expressed semantics</dt>
+   <dt>Errors that involve a conflict in expressed semantics</dt>
 
    <dd>
 
@@ -1923,7 +1924,7 @@
    </dd>
 
 
-   <dt>Errors that catch cases where the default styles are likely to lead to confusion</dt>
+   <dt>Cases where the default styles are likely to lead to confusion</dt>
 
    <dd>
 
@@ -1952,7 +1953,7 @@
    </dd>
 
 
-   <dt>Errors that encourage a correct understanding of the spec</dt>
+   <dt>Errors that indicate a likely misunderstanding of the specification</dt>
 
    <dd>
 
@@ -1969,7 +1970,7 @@
    </dd>
 
 
-   <dt>Errors that are intended merely to simplify the language</dt>
+   <dt>Errors involving limits that have been imposed merely to simplify the language</dt>
 
    <dd>
 
@@ -1987,7 +1988,7 @@
    </dd>
 
 
-   <dt>Errors that avoid peculiarities of the parser</dt>
+   <dt>Errors that involve peculiarities of the parser</dt>
 
    <dd>
 
@@ -2031,12 +2032,14 @@
    </dd>
 
 
-   <dt>Errors that are intended to save the author time</dt>
+   <dt>Errors that waste authoring time</dt>
 
    <dd>
 
     <p>Some constructs are disallowed because historically they have
-    been the cause of a lot of wasted authoring time.</p>
+    been the cause of a lot of wasted authoring time, and by
+    encouraging authors to avoid making them, authors can save time in
+    future efforts.</p>
 
     <p class="example">For example, a <code><a href="#script">script</a></code> element's
     <code title="attr-script-src"><a href="#attr-script-src">src</a></code> attribute causes the
@@ -2054,7 +2057,7 @@
    </dd>
 
 
-   <dt>Errors that are intended to help authors migrating to and from XHTML</dt>
+   <dt>Errors that involve areas that affect authors migrating to and from XHTML</dt>
 
    <dd>
 
@@ -2081,7 +2084,7 @@
    </dd>
 
 
-   <dt>Errors that reserve space for future expansion</dt>
+   <dt>Errors that involve areas reserved for future expansion</dt>
 
    <dd>
Received on Monday, 12 April 2010 22:09:58 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Saturday, 18 December 2010 06:14:18 GMT