W3C home > Mailing lists > Public > www-validator-cvs@w3.org > February 2005

validator/share/templates/en_US error_messages.cfg,1.5,1.6

From: Olivier Thereaux via cvs-syncmail <cvsmail@w3.org>
Date: Thu, 17 Feb 2005 12:02:54 +0000
To: www-validator-cvs@w3.org
Message-ID: <E1D1kMw-0001rQ-Na@lionel-hutz.w3.org>

Update of /sources/public/validator/share/templates/en_US
In directory hutz:/tmp/cvs-serv7140

Modified Files:
	error_messages.cfg 
Log Message:
First batch of error message explanations by Scott Bigham (from http://validator.w3.org/docs/errors.html) that were not yet included here

Index: error_messages.cfg
===================================================================
RCS file: /sources/public/validator/share/templates/en_US/error_messages.cfg,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -d -r1.5 -r1.6
--- error_messages.cfg	4 Jan 2005 06:56:55 -0000	1.5
+++ error_messages.cfg	17 Feb 2005 12:02:52 -0000	1.6
@@ -8,8 +8,8 @@
   verbose = <<.EOF.
     <p class="helpwanted">
       <a
-        href="mailto:www-validator@w3.org?Subject=[VE][<!--MID-->]%20Error%20Message%20Feedback"
-	title="Suggest improvements on this error message explanation by sending mail to the public list www-validator" 
+        href="feedback.html?uri=<!--URI-->;errmsg_id=<!--MID-->#errormsg"
+	title="Suggest improvements on this error message through our feedback channels" 
       >&#x2709;</a>
     </p>
 .EOF.
@@ -106,6 +106,16 @@
 </msg>
 <msg 28>
   original = "unterminated comment: found end of entity inside comment"
+    verbose <<.EOF.
+  <div class="ve mid-28">
+    <p>
+        Check that you are using a proper syntax for you comments, e.g: &lt;!-- comment here --&gt;. 
+        This error may appear if you forget the last "--" to close one comment, therefore including the rest 
+        of the content in your comment.
+    </p>
+  </div>
+.EOF.
+
 </msg>
 <msg 29>
   original = "comment started here"
@@ -155,6 +165,14 @@
 </msg>
 <msg 42>
   original = "unknown declaration type %1"
+    verbose <<.EOF.
+  <div class="ve mid-42">
+    <p>
+        This error may appear if you are using a bad syntax for you comments, such as "&lt;!invalid comment&gt;"
+        The proper syntax for comments is &lt;!-- your comment here --&gt;. 
+    </p>
+  </div>
+.EOF.
 </msg>
 <msg 43>
   original = "%1 declaration not allowed in DTD subset"
@@ -280,9 +298,32 @@
 </msg>
 <msg 68>
   original = "end tag for %1 omitted, but its declaration does not permit this"
+  verbose <<.EOF.
+  <div class="ve mid-68">
+    <ul>
+        <li>You forgot to close a tag, or</li>
+        <li>you used something inside this tag that was not allowed, and the validator
+        is complaining that the tag should be closed before such content can be allowed.</li>
+    </ul>
+    <p>    
+        The next message, "<code class="inline">start tag was here</code>"
+        points to the particular instance of the tag in question); the
+        positional indicator points to where the validator expected you to close the
+        tag.
+    </p>
+  </div>
+.EOF.  
 </msg>
 <msg 69>
   original = "start tag was here"
+    verbose <<.EOF.
+  <div class="ve mid-69">
+    <p>    
+        This is not an error, but rather  a pointer to the start tag of the element
+        the previous error referred to.    
+    </p>
+  </div>
+.EOF.
 </msg>
 <msg 70>
   original = "end tag for %1 omitted, but OMITTAG NO was specified"
@@ -297,6 +338,15 @@
 </msg>
 <msg 71>
   original = "start tag was here"
+  verbose <<.EOF.
+  <div class="ve mid-71">
+    <p>    
+        This is not an error, but rather a pointer to the start tag of the element
+        the previous error referred to.    
+    </p>
+  </div>
+.EOF.
+
 </msg>
 <msg 72>
   original = "start tag omitted for element %1 with declared content"
@@ -558,6 +608,30 @@
 </msg>
 <msg 120>
   original = "normalized length of attribute value literal must not exceed LITLEN (%1); length was %2"
+  verbose <<.EOF.
+  <div class="ve mid-120">
+    <p>
+    This error almost always means that you've forgotten a closing quote on an attribute value. For instance,
+            in:
+          </p>
+          <code class="block">
+            &lt;img src="fred.gif&gt;<br />
+            &lt;!-- 50 lines of stuff --&gt;<br />
+            &lt;img src="joe.gif"&gt;
+          </code>
+          <p>
+            The "<code class="inline">src</code>" value for the first
+            <code class="inline">&lt;img&gt;</code> is the entire
+            fifty lines of stuff up to the next double quote, which probably
+            exceeds the <a href="sgml.html#sgml"><abbr
+              title="Standard Generalized Markup Language">SGML</abbr></a>-defined
+            length limit for <abbr title="HyperText Markup Language">HTML</abbr>
+            string literals. Note that the position indicator in the error
+            message points to where the attribute value <em>ended</em> &mdash; in
+            this case, the <code class="inline">"joe.gif"</code> line.
+          </p>
+  </div>
+.EOF.
 </msg>
 <msg 121>
   original = "syntax of attribute value does not conform to declared value"
@@ -577,12 +651,36 @@
 </msg>
 <msg 122>
   original = "character %1 is not allowed in the value of attribute %2"
+  verbose <<.EOF.
+  <div class="ve mid-122">
+    <p>
+      It is possible that you violated the naming convention for this attribute.
+      For example, <code>id</code> and <code>name</code> attributes must begin with
+      a letter, not a digit.
+    </p>
+  </div>
+.EOF.
 </msg>
 <msg 123>
   original = "value of attribute %1 must be a single token"
+  verbose <<.EOF.
+  <div class="ve mid-123">
+    <p>
+      This attribute can not take a space-separated list of words as a value, but only one word ("token"). 
+      This may also be caused by the use of a space for the value of an attribute which does not permit it.
+    </p>
+  </div>
+.EOF.
 </msg>
 <msg 124>
   original = "value of attribute %2 invalid: %1 cannot start a number token"
+  verbose <<.EOF.
+  <div class="ve mid-124">
+    <p>
+      The value of this attribute should be a number, and you probably used a wrong syntax.
+    </p>
+  </div>
+.EOF.
 </msg>
 <msg 125>
   original = "value of attribute %2 invalid: %1 cannot start a name"
@@ -661,12 +759,53 @@
 </msg>
 <msg 137>
   original = "invalid comment declaration: found character %1 outside comment but inside comment declaration"
+  verbose <<.EOF.
+  <div class="ve mid-137">
+    <p>
+        Check that you are using a proper syntax for you comments, e.g: &lt;!-- comment here --&gt;. 
+        This error may appear if you forget the last "--" to close one comment, and later open another.
+    </p>
+  </div>
+.EOF.
 </msg>
 <msg 138>
   original = "comment declaration started here"
 </msg>
 <msg 139>
   original = "non SGML character number %1"
+  verbose <<.EOF.
+  <div class="ve mid-139">
+          <p>
+            You have used an illegal character in your text.
+            <abbr title="HyperText Markup Language">HTML</abbr> uses the standard
+            <a href="http://www.unicode.org/">UNICODE Consortium</a> character repertoire,
+            and it leaves undefined (among others) 65 character codes (0 to 31 inclusive and 127 to 159
+            inclusive) that are sometimes used for typographical quote marks and similar in
+            proprietary character sets. The validator has found one of these undefined
+            characters in your document. The character may appear on your browser as a
+            curly quote, or a trademark symbol, or some other fancy glyph; on a different
+            computer, however, it will likely appear as a completely different
+            character, or nothing at all.
+          </p>
+          <p>
+            Your best bet is to replace the character with the nearest equivalent
+            ASCII character, or to use an appropriate <a
+              href="http://www.w3.org/MarkUp/html3/latin1.html">character
+            entity</a>. For more information on Character Encoding on the web, see <a
+              href="http://ppewww.ph.gla.ac.uk/%7Eflavell/aflavell.html">Alan
+            Flavell</a>'s excellent <a
+            href="http://ppewww.ph.gla.ac.uk/%7Eflavell/charset/">HTML Character Set Issues</a>
+            reference.
+          </p>
+          <p>
+            This error can also be triggered by formatting characters embedded in
+            documents by some word processors. If you use a word processor to edit
+            your <abbr title="HyperText Markup Language">HTML</abbr> documents, be sure to use the "Save as ASCII" or similar
+            command to save the document without formatting information.
+          </p>
+  </div>
+.EOF.
+
 </msg>
 <msg 140>
   original = "data or replaceable character data in declaration subset"
@@ -1494,6 +1633,14 @@
 </msg>
 <msg 387>
   original = "S separator in comment declaration"
+  verbose <<.EOF.
+  <div class="ve mid-387">
+    <p>
+    This may happen if you have consecutive comments but did not close one of them properly. 
+    The proper syntax for comments is &lt;!-- my comment --&gt;.
+    </p>
+  </div>
+.EOF.  
 </msg>
 <msg 388>
   original = "multiple comments in comment declaration"
Received on Thursday, 17 February 2005 12:02:55 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 26 April 2012 12:54:48 GMT