Re: [docbook-apps] Beginner Problems Updating CLASSPATHS for Saxon Installation

["Bob Stayton" <bobs@sagehill.net>]

----- Original Message ----- 
From: "René Haché" <rene-hache@shaw.ca>
To: <docbook-apps@lists.oasis-open.org>
Sent: Monday, June 07, 2004 1:48 PM
Subject: [docbook-apps] Beginner Problems Updating CLASSPATHS for Saxon
Installation


> To whom it may concern,
>
> I am trying to install and use Saxon on a Windows XP Professional machine
by
> following the directions in Bob Stayton's "DocBook XSL: The Complete
Guide",
> but I am utterly confused. I know how to get to the Environment Variables
> dialog box, but confused on how exactly to change or add new system
> variables.
>
> When I click to create a new Variable, a dialog box comes up with two
> fields: "Variable" and a "Value". What do I put in each of those fields if
> my .jar files are located here:
>
> -C:\studies\xsl\extensions\saxon651.jar
> -C:\studies\saxon\saxon.jar
>
> I guess I am unclear of the difference between a Variable and a Value when
> creating a new Environment Variable and exactly what to put in there. Also
> the following statement, from "DocBook XSL: The Complete Guide" under the
> section "Using Saxon" is very unclear to me:
>
> "Saxon is a Java application, which means you need to add the appropriate
> Java class files to your CLASSPATH environment variable. Then you execute
> the java command with the main processor class as its first argument."
>
> I do not know what the appropriate Java class files are?

I'll clarify that for the next edition for those not familiar with Java
lingo. That really should say "the appropriate .jar files". The example that
follows the above statement shows how to add 'saxon.jar' from the Saxon 6
distribution and the 'saxon65.jar' file from the DocBook XSL distribution
(in the extensions directory) to a CLASSPATH.  The "main processor class"
for Saxon is 'com.icl.saxon.Stylesheet', and that apears on the java command
line.

Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net