validator/htdocs/docs install.html,1.1.2.2,1.1.2.3

Update of /sources/public/validator/htdocs/docs
In directory hutz:/tmp/cvs-serv7939

Modified Files:
      Tag: validator-0_6_0-branch
	install.html 
Log Message:
crude first attempt at providing a "first aid kit" for new installations that do not work.

I realize it lacks a paragraph about contacting www-validator if all fails...


Index: install.html
===================================================================
RCS file: /sources/public/validator/htdocs/docs/Attic/install.html,v
retrieving revision 1.1.2.2
retrieving revision 1.1.2.3
diff -u -d -r1.1.2.2 -r1.1.2.3
--- install.html	25 Dec 2003 09:44:31 -0000	1.1.2.2
+++ install.html	6 Apr 2004 15:10:46 -0000	1.1.2.3
@@ -128,7 +128,36 @@
     <p><strong>Help us</strong> improve this installation guide by sending us your feedback
     if you install the validator on your local system!</p>
 
-    </div>
+   <h3 id="install-troubleshoot">Troubleshooting a new installation</h3>
+   <p>It is not always easy to troubleshoot an incomplete, or failed, installation of
+   the Markup Validator. While the instructions given in this page should help most people
+   install the validator successfully on their system, bad luck, a forgotten step 
+    or a broken component can make things go sour.</p>
+
+   <h4>Double check the installation steps</h4>
+   <p>The first sound thing to do if the installation failed would be to check that you did not forget
+   any step while installing. properly copying and editing the configuration file is among the common
+   mistakes, for example.</p>
+
+   <h4>Check the logs</h4>
+   <p>The error logs for your Web server should be a good first place to look for hints on what
+   is wrong with your installation.</p>
+
+   <h4>Check the dependencies</h4>
+   <p>A common problem with a newly installed validator is a validator that is apparently running
+   but marking anything as "invalid", without giving any error message as output.</p>
+
+  <p>This is somewhat typical of a problem with OpenSP. Cross-check that you actually have a version
+  above 1.5, by running <kbd>onsgmls --version</kbd>.</p>   
+
+
+   <h4>The miracle debug options</h4>
+   <p>If the validator is misbehaving, you can try forcing various debug options by appending to
+   the uri the following string: <kbd>&amp;debug=1&amp;errors=1&amp;esis=1&amp;verbose=1</kbd>.</p>
+   <p>This can sometimes provide you with error messages that would not have appeared anywhere in
+   non-debug mode, and can be helpflu o diagnose the problem</p>
+
+ </div>
     
     <div id="credits" class="stb">
       <h3>Credits and Acknowledgments</h3>

Received on Tuesday, 6 April 2004 11:10:57 UTC