5682 2008-05-08 07:36:49 +0000 Instructions not clear for sgml-lib path configuration 2009-09-21 20:19:33 +0000 1 1 1 Unclassified Validator Website HEAD PC Windows 2000 RESOLVED WORKSFORME http://validator.w3.org/docs/install_win.html P2 normal --- 1 akinss dave.null akinss david.tibbe www-validator-cvs oldest_to_newest 20048 0 akinss 2008-05-08 07:36:49 +0000 The instructions for installing and configuring the sgml-lib are not clear and are potentially incorrect. Looking at the directory structure of the packages, the use of the Base variable and the instructions in http://validator.w3.org/docs/install.html, I think the following changes should be made to the instructions. In the 'Configuration of the Validator' section it describes this: For the SGML Library, c:/www/sgml-lib is declared. Notice that slashes are used here instead of windows-like back slashes. What it should be be doing is this: Change #Base = /usr/local/validator To Base = C:/www/validator Unpacking the sgml-lib should just go under C:\www\validator the same as the validator as per http://validator.w3.org/docs/install.html#install-components I can rewrite the page if you like and send it to someone for update, just let me know how. Cheers, Steve Akins 20078 1 ot 2008-05-11 21:01:35 +0000 Have you looked at http://validator.w3.org/docs/install_win.html ? 20079 2 ot 2008-05-11 21:11:50 +0000 oh, I see your feedback is about install_win.html and not install.html - I was confused by the main bug text, my apologies. (In reply to comment #0) > I can rewrite the page if you like and send it to someone for update, just let > me know how. That would be great. Can you create a diff from the latest CVS version, which you can find at: http://dev.w3.org/cvsweb/validator/htdocs/docs/install_win.html ? Thanks. 20081 3 akinss 2008-05-12 03:53:37 +0000 Hi Oliver, Here's the patch for version 1.16. It looks like the 1.15 version described something similar to what I'm doing here. For some reason it was changed in 1.16. I'm sorry but I don't have a huge amount of time or resources to help a whole lot and I don't have CVS or a UNIX environment. I hope the output below from WinMerge is enough. Cheers, Steve 91,92c91 < <code>C:\www\pmm</code>, the validator itself in <code>C:\www\validator</code> and finally < the DTD-Collection in <code>C:\www\sgml-lib</code></p> --- > <code>C:\www\pmm</code>, the validator along with the DTD-Collection in <code>C:\www\validator</code></p> 248a248,260 > <h3 id="install-components">Install the various necessary components:</h3> > <p>In a previous step you created a directory for the validator's installation called <code>C:\www\validator</code>. > This directory will be referred to as <code>[validatorpath]</code> > throughout this guide.</p> > <p>Unpack the archives of the validator and DTD library into a > temporary directory, and copy the directories <code>htdocs</code>, <code>httpd/cgi-bin</code>, > and <code>share</code> from <code>validator-<em>X.X.X</em></code> into > <code>[validatorpath]</code>.</p> > <p>The <code>[validatorpath]</code> directory should now have > subdirectories named <code>cgi-bin</code>, <code>htdocs</code>, and and > <code>share</code>.</p> > <p>Within <code>[validatorpath]\htdocs</code> there should be an <code>sgml-lib</code> directory containing all the directories and files from the DTD archive.</p> > 253,257c265,266 < <p>For the SGML <code>Library</code>, <code>c:/www/sgml-lib</code> < is declared. Notice that slashes are used here instead of < windows-like back slashes.</p> < < <p>The option <code>Home Page</code> has to be changed to the URL of --- > Uncomment and set the Base Path variable to <code>C:/www/validator</code>, notice that slashes are used here instead of windows-like > back slashes.<p>The option <code>Home Page</code> has to be changed to the URL of 288c297 < #Base = /usr/local/validator --- > Base = C:/www/validator 300c309 < Library = C:/www/sgml-lib --- > Library = $Base/htdocs/sgml-lib 20376 4 ot 2008-06-04 20:13:57 +0000 Hi Steve, (In reply to comment #3) > It looks like the 1.15 version described something similar to what I'm doing > here. For some reason it was changed in 1.16. There may have been a good reason behind that change, I am honestly not sure. I brought your comment, and you patch (thank you!) to the attention of David Tibbe, the contibutor in charge of the windows manual. Let's see if he can clarify for us. Thanks. 21056 5 david.tibbe 2008-07-03 19:58:45 +0000 Steve got the validator from the CVS repository. The sgml-lib is included there and it is located in BASE\htdocs\sgml-lib. So in his case, the objection is correct. But the installation guide tells to use the tar ball that does not include the sgml-lib. It must be downloaded separately. To have a nice directory structure, I supposed to extract it to c:\www\sgml-lib, so the directory is outside the BASE and must be set explicitly. As the guide is for an installation using the tar ball I suggest to keep the current way. Olivier acknowledged that already via mail. Regards, David 27425 6 ville.skytta 2009-09-21 20:19:33 +0000 Closing as worksforme per comment 5.