- From: Olivier Thereaux via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 17 Feb 2005 12:02:54 +0000
- To: www-validator-cvs@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"
>✉</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: <!-- comment here -->.
+ 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 "<!invalid comment>"
+ The proper syntax for comments is <!-- your comment here -->.
+ </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">
+ <img src="fred.gif><br />
+ <!-- 50 lines of stuff --><br />
+ <img src="joe.gif">
+ </code>
+ <p>
+ The "<code class="inline">src</code>" value for the first
+ <code class="inline"><img></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> — 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: <!-- comment here -->.
+ 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 <!-- my comment -->.
+ </p>
+ </div>
+.EOF.
</msg>
<msg 388>
original = "multiple comments in comment declaration"
Received on Thursday, 17 February 2005 12:02:55 UTC