[Bug 5682] Instructions not clear for sgml-lib path configuration

http://www.w3.org/Bugs/Public/show_bug.cgi?id=5682

           Summary: Instructions not clear for sgml-lib path configuration
           Product: Validator
           Version: HEAD
          Platform: PC
               URL: http://validator.w3.org/docs/install_win.html
        OS/Version: Windows 2000
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Website
        AssignedTo: dave.null@w3.org
        ReportedBy: akinss@gmail.com
         QAContact: www-validator-cvs@w3.org


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

Received on Thursday, 8 May 2008 07:37:20 UTC