Adding a TOC to the user's guide, the error message guide and the help.validator_0_6_0-beta

Added some verbiage to the help page, some re-org, plus some updates.
Added documentation about comma/site tools.

TODO : check validity
TODO : add style for comma tools table

1 files changed, 180 insertions, 2 deletions

diff --git a/htdocs/docs/errors.html b/htdocs/docs/errors.html
index 67f6395..418ed3d 100755
--- a/htdocs/docs/errors.html
+++ b/htdocs/docs/errors.html
@@ -1,5 +1,5 @@
-<!--#set var="revision" value="\$Id: errors.html,v 1.20 2002-10-23 23:11:30 link Exp $"
---><!--#set var="date" value="\$Date: 2002-10-23 23:11:30 $"
+<!--#set var="revision" value="\$Id: errors.html,v 1.21 2002-11-06 02:45:20 ot Exp $"
+--><!--#set var="date" value="\$Date: 2002-11-06 02:45:20 $"
 --><!--#set var="title" value="Error Explanations for The W3C MarkUp Validation Service"
 --><!--#set var="relroot" value="../"
 --><!--#include virtual="../header.html" -->
@@ -9,6 +9,184 @@
       they are used here with his permission.
     </p>
 
+<h2>Table of Contents</h2>
+<ul>
+
+<li><a href="#undef-id">
+&ldquo;<code>ID &lsquo;<var>FOO</var>&rsquo; already defined</code>&rdquo;
+</a></li>
+
+<li><a href="#unterm-comment-1">
+&ldquo;<code>entity end not allowed in comment</code>&rdquo;
+</a></li>
+
+<li><a href="#unterm-comment-2">
+&ldquo;<code>name start character invalid: only s and comment allowed in 
+comment declaration</code>&rdquo;
+</a></li>
+
+<li><a href="#bad-comment">
+&ldquo;<code>unknown declaration type &lsquo;<var>FOO</var>&rsquo;</code>&rdquo;
+</a></li>
+
+<li><a href="#attr-quoted">
+&ldquo;<code>an attribute value must be a literal unless it 
+contains only name characters</code>&rdquo;
+</a></li>
+
+<li><a href="#attr-char">
+&ldquo;<code>character `X' not allowed in attribute specification list</code>&rdquo;
+</a></li>
+
+<li><a href="#name-length">
+&ldquo;<code>length of attribute value must not exceed 
+LITLEN less NORMSEP (1022)</code>&rdquo;
+</a></li>
+
+<li><a href="#undef-tag">
+&ldquo;<code>element &lsquo;<var>FOO</var>&rsquo; 
+undefined</code>&rdquo;
+</a></li>
+
+<li><a href="#not-allowed">
+&ldquo;<code>document type does not allow element 
+&lsquo;<var>FOO</var>&rsquo; here</code>&rdquo;
+</a></li>
+
+<li><a href="#not-contained">
+&ldquo;<code>
+document type does not allow element &lsquo;
+<var>FOO</var>&rsquo; here; assuming missing &lsquo;
+<var>BAR</var>&rsquo; start-tag&rdquo;
+</code>
+</a></li>
+
+<li><a href="#attr-undef">
+&ldquo;<code>there is no attribute 
+&lsquo;<var>FOO</var>&rsquo; 
+for this element (in this HTML version)</code>&rdquo;
+</a></li>
+
+<li><a href="#undef-attr-val">
+&ldquo;<code>&lsquo;<var>FOO</var>&rsquo; 
+is not a member of the group specified in the 
+declared value of this attribute</code>&rdquo;
+</a></li>
+
+<li><a href="#bad-attr-char">
+&ldquo;<code>syntax of attribute value does not conform 
+to declared value</code>&rdquo;
+</a></li>
+
+<li><a href="#attr-bad-name">
+&ldquo;<code>value of attribute &lsquo;<var>FOO</var>&rsquo; 
+invalid: "#" cannot start a name</code>&rdquo;
+</a></li>
+
+<li><a href="#bad-abbrev-attr">
+&ldquo;<code>&lsquo;<var>FOO</var>&rsquo; is not a member of 
+a group specified for any attribute</code>&rdquo;
+</a></li>
+
+<li><a href="#attr-missing">
+&ldquo;<code>required attribute &lsquo;<var>FOO</var>&rsquo; 
+not specified</code>&rdquo;
+</a></li>
+
+<li><a href="#no-end-tag">
+&ldquo;<code>end tag for &lsquo;<var>FOO</var>&rsquo; 
+omitted, but its declaration does not permit this</code>&rdquo;
+</a></li>
+
+<li><a href="#floating-close">
+&ldquo;<code>end tag for element &lsquo;<var>FOO</var>&rsquo;
+which is not open</code>&rdquo;
+</a></li>
+
+<li><a href="#omitted-content">
+&ldquo;<code>end tag for &lsquo;<var>FOO</var>&rsquo; 
+which is not finished</code>&rdquo;
+</a></li>
+
+<li><a href="#no-start-tag">
+&ldquo;<code>start tag for &lsquo;<var>FOO</var>&rsquo; 
+omitted, but its declaration does not permit this</code>&rdquo;
+</a></li>
+
+<li><a href="#bad-entity">
+&ldquo;<code>unknown entity &lsquo;<var>FOO</var>&rsquo;</code>&rdquo;
+</a></li>
+
+<li><a href="#bad-char">
+&ldquo;<code>non SGML character number ###</code>&rdquo;
+</a></li>
+ 
+<li><a href="#unicode-char">
+&ldquo;<code>`####' is not a valid character number</code>&rdquo;
+</a></li>
+
+<li><a href="#bad-pub-id">
+&ldquo;<code>cannot generate system identifier for entity `HTML'</code>&rdquo;
+</a></li>
+
+<li><a href="#missing-subel">
+&ldquo;<code>missing a required sub-element of 
+&lsquo;<var>FOO</var>&rsquo;</code>&rdquo;
+</a></li>
+
+<li><a href="#start-tag">
+&ldquo;<code>start tag was here</code>&rdquo;
+</a></li>
+
+<li><a href="#utf8-bom">
+&ldquo;<code>UTF-8 'BOM' detected and removed</code>&rdquo;
+</a></li>
+
+<li><a href="#text-not-allowed">
+&ldquo;<code> text is not allowed here; try wrapping the text 
+in a more descriptive container</code>&rdquo;
+</a></li>
+
+<li><a href="#unkn-att-val">
+&ldquo;<code> value of attribute 
+&lsquo;<var>FOO</var>&rsquo; cannot be &lsquo;<var>BAR</var>&rsquo;; 
+must be one of &lsquo;<var>FOO</var>&rsquo;, &lsquo;<var>BAR</var>&rsquo;, 
+&lsquo;<var>BAZ</var>&rsquo;</code>&rdquo;
+</a></li>
+
+<li><a href="#no-attr-end">
+&ldquo;<code>character &lsquo;<var>FOO</var>&rsquo; not allowed 
+in attribute specification list possibly caused by a missing 
+quotation mark ending a previous attribute value</code>&rdquo;
+</a></li>
+
+<li><a href="#dup-attr">
+&ldquo;<code>duplicate specification of attribute 
+&lsquo;<var>FOO</var>&rsquo;</code>&rdquo;
+</a></li>
+
+<li><a href="#invalid-attr-val">
+&ldquo;<code>invalid attribute value</code>&rdquo;
+</a></li>
+
+<li><a href="#attr-spec-nmtoken">
+&ldquo;<code>an attribute specification must start with a name 
+or name token</code>&rdquo;
+</a></li>
+
+<li><a href="#inval-comment">
+&ldquo;<code>invalid comment declaration; 
+check your comment syntax</code>&rdquo;
+</a></li>
+
+<li><a href="#assuming-missing-starttag">
+&ldquo;<code>element &lsquo;<var>FOO</var>&rsquo; not allowed here; 
+assuming missing &lsquo;<var>BAR</var>&rsquo; start-tag</code>&rdquo;</a>
+</li>
+</ul>
+
+<h2>Listing of errors and their explanation</h2>
+
     <dl>
       <dt><a id="undef-id" name="dup-id">&ldquo;<code>ID &lsquo;<var>FOO</var>&rsquo; already defined</code>&rdquo;</a></dt>
       <dd>