- From: Olivier Thereaux via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 25 Apr 2005 04:47:26 +0000
- To: www-validator-cvs@w3.org
Update of /sources/public/validator/htdocs/docs
In directory hutz:/tmp/cvs-serv24264
Modified Files:
users.html
Log Message:
- updating statement on how the validator uses error messages from parser
- updating documentation of verbose output
- Moving "output options" out of "Interpreting the results" section
Index: users.html
===================================================================
RCS file: /sources/public/validator/htdocs/docs/users.html,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -d -r1.19 -r1.20
--- users.html 21 Jul 2004 15:07:10 -0000 1.19
+++ users.html 25 Apr 2005 04:47:24 -0000 1.20
@@ -17,6 +17,7 @@
<li><a href="#Options">Validator's options</a></li>
<li><a href="#Calling">Calling/Linking to the Validator</a></li>
<li><a href="#Interpret">Interpreting the results</a></li>
+ <li><a href="#Output">Output Options</a></li>
<li><a href="#CommaTools">Comma Tools</a></li>
<li><a href="#Installing">Installing the Markup Validator Locally</a></li>
</ul>
@@ -54,10 +55,14 @@
that URL and feed it to the SGML parser. If you upload a file it'll get
fed directly into the SGML parser. We then take the output from the
SGML parser and format it nicely as HTML and send it back to your web
- browser. The W3C Markup Validation Service isn't generating any of the
- error messages; they are all generated by the underlying SGML Parser
- which is checking your HTML against the actual standard for the version
- of HTML you are using.
+ browser.
+ </p>
+ <p>
+ The W3C Markup Validation Service is not generating the error messages
+ - they are all generated by the underlying Parser -
+ but it is appending short explanations and suggested fixes for each error.
+ We provide a <a href="../feedback.html#errormsg">feedback channel</a> for
+ users to suggest better explanations and more accurate solutions.
</p>
</div>
@@ -136,11 +141,11 @@
</dd>
<dt><a id="option-verbose" name="option-verbose"></a>Verbose Output</dt>
<dd>
- <p>This option triggers verbose output. By default the validator will only output
- the validity result if the document is valid, but you may want to have more
- information. This is the option to use then. The verbose output also provides helpful
- explanations in addition to the error messages, which makes it a generally useful
- option. </p>
+ <p>This option triggers verbose output. Verbose output adds more explanations
+ and suggestions to the validation results, and gives more information on the
+ resource validated. This makes it a useful option if you prefer to be given
+ as much help as possible; if you prefer more concise reports, leave this option
+ unset.</p>
</dd>
@@ -208,8 +213,9 @@
possible and include the <em>exact</em> error message and, preferably, an URL
we can validate to see for ourselves.
</p>
- <div id="Output" class="stb">
- <h4>Output Options</h4>
+ </div>
+ <div id="Output" class="stb">
+ <h3>Output Options</h3>
<p>
In addition to the HTML output intended for human consumption in a
browser, the Validator has some experimental features to generate
@@ -333,7 +339,6 @@
</dd>
</dl>
</div>
- </div>
<div id="CommaTools">
<h3>Comma Tools / Site Tools</h3>
Received on Monday, 25 April 2005 04:47:32 UTC