explanations for some errors triggered by typos in doctype declaration,

courtesy of Jorgen Elgaard Larsen and some additions by YT.
http://lists.w3.org/Archives/Public/www-validator/2008Apr/0059.html

1 files changed, 28 insertions, 0 deletions

diff --git a/share/templates/en_US/error_messages.cfg b/share/templates/en_US/error_messages.cfg
index 2d73404..2b8e260 100644
--- a/share/templates/en_US/error_messages.cfg
+++ b/share/templates/en_US/error_messages.cfg
@@ -156,6 +156,19 @@
 </msg>
 <msg 39>
   original = "%1 invalid: only %2 and parameter separators are allowed"
+  <div class="ve mid-39">
+    <p>
+	This error is typical of a typo or error in the DOCTYPE declaration at the top
+	of your document's markup.
+    </p>
+	<p>
+	In most cases, it is safer not to type or edit the DOCTYPE declaration at all,
+	and preferable to let a tool include it, or copy and paste it from a 
+	<a href="http://www.w3.org/QA/2002/04/valid-dtd-list.html">trusted list of DTDs</a>.
+	</p>
+  </div>
+.EOF.  
+
 </msg>
 <msg 40>
   original = "%1 invalid: only %2 and token separators are allowed"
@@ -1450,6 +1463,21 @@
 </msg>
 <msg 323>
   original = "DTD did not contain element declaration for document type name"
+  verbose <<.EOF.
+  <div class="ve mid-323">
+    <p>
+	A DOCTYPE declares the version of the language used, as well as what the root
+	(top) element of your document will be. For example, if the top element 
+	of your document is &lt;html&gt;, the DOCTYPE declaration 
+	will look like: "&lt;!DOCTYPE html".                                                                                                                  
+    </p>
+	<p>
+	In most cases, it is safer not to type or edit the DOCTYPE declaration at all,
+	and preferable to let a tool include it, or copy and paste it from a 
+	<a href="http://www.w3.org/QA/2002/04/valid-dtd-list.html">trusted list of DTDs</a>.
+	</p>
+  </div>
+.EOF.  
 </msg>
 <msg 324>
   original = "invalid default SGML declaration"