doc/install.xml

<?xml version="1.0" standalone="no"?>
<!DOCTYPE s1 SYSTEM "./dtd/document.dtd">

<s1 title="Installation">


    <s2 title="Window NT/98">
        <p>Install the binary &XercesCName; release by using <code>unzip</code>
		on the <ref>file</ref>-win32.zip archive in the Windows environment. You can
		use WinZip, or any other UnZip utility.</p>
<source>unzip &XercesCInstallDir;-win32.zip</source>
        <p>This creates a &apos;&XercesCInstallDir;-win32&apos; sub-directory
		containing the &XercesCName; distribution. </p>

        <p>You need to add the &apos;&XercesCInstallDir;-win32\bin&apos;
		directory to your path: </p>

        <p>To do this under Windows NT, go to the start menu, click the
		settings menu and select control panel. When the control panel opens,
		double click on System and select the &apos;Environment&apos; tab.
		Locate the PATH variable under system variables
        and add &lt;full_path_to_&XercesCInstallDir;>\bin to the PATH variable.
		To do this under Windows 95/98 add this line to your AUTOEXEC.BAT file:</p>
<source>SET PATH=&lt;full_path_to_&XercesCInstallDir;>\bin;%PATH%</source>
		<p>or run the <code>SET PATH</code> command in your shell window.</p>
    </s2>

    <s2 title="UNIX">
        <p>Binary installation of this release is to extract the files from the
		compressed .tar archive (using 'tar').</p>
<source>cd $HOME
gunzip &XercesCInstallDir;-linux.tar.gz
tar -xvf &XercesCInstallDir;-linux.tar</source>
        <p>This will create an '&XercesCInstallDir;-linux' sub-directory
		(in the home directory)
        which contains the &XercesCName; distribution. You will need to add the
        &XercesCInstallDir;-linux/bin directory to your PATH environment variable:</p>

        <p>For Bourne Shell, K Shell or Bash, type: </p>
<source>export PATH="$PATH:$HOME/&XercesCInstallDir;-linux/bin"</source>
		<p>For C Shell, type:</p>
<source>setenv PATH "$PATH:$HOME/&XercesCInstallDir;-linux/bin"</source>

        <p>If you wish to make this setting permanent, you need to change
		your profile by changing your setup files which can be either .profile or .kshrc.</p>

        <p>In addition, you will also need to set the environment variables XERCESCROOT,
        ICUROOT and the library search path. (LIBPATH on AIX, LD_LIBRARY_PATH on
        Solaris and Linux, SHLIB_PATH on HP-UX).</p>

        <note>XERCESCROOT and ICUROOT are needed only if you intend to
        recompile the samples or build your own applications. The library path is
        necessary to link the shared libraries at runtime.</note>

        <p>For Bourne Shell, K Shell or Bash, type:</p>
<source>export XERCESCROOT=&lt;wherever you installed &XercesCName;>
export ICUROOT=&lt;wherever you installed ICU>
export LIBPATH=$XERCESCROOT/lib:$LIBPATH (on AIX)
export LD_LIBRARY_PATH=$XERCESCROOT/lib:$LD_LIBRARY_PATH (on Solaris, Linux)
export SHLIB_PATH=$XERCESCROOT/lib:$SHLIB_PATH (on HP-UX)</source>

    	<p>For C Shell, type:</p>
<source>setenv XERCESCROOT "&lt;wherever you installed &XercesCName;>"
setenv ICUROOT "&lt;wherever you installed ICU>"
setenv LIBPATH "$XERCESCROOT/lib:$LIBPATH" (on AIX)
setenv LD_LIBRARY_PATH "$XERCESCROOT/lib:$LD_LIBRARY_PATH" (on Solaris, Linux)
setenv SHLIB_PATH "$XERCESCROOT/lib:$SHLIB_PATH" (on HP-UX)</source>

        <note>If you need to build the samples after installation,
        make sure you read and follow the build instructions given in the
		<jump href="build.html">FAQ</jump>.</note>

   </s2>
</s1>