ClearToolSuite Installation and Usage HOWTO
###########################################

This document explains how to set up your environment in order to use the
Win32 executables of the package ClearToolSuite provided by the setup program
ClearToolSuiteSetup-<Version>.exe.


1 Download and install the package documentation and executable files
=====================================================================
- Download the Win32 package installer LibStmCppSetup-<Version>.exe from
  SysToMath (see http://www.SysToMath.com/etc/html/libraries.html).
- Environment Variable LOCROOT
  This environment variable shall reside in the system environment (Settings,
  Control Panel, System, Enhanced, Environment, System Variables).
  As the Win32 executables and DLLs are installed in %LOCROOT%\bin\w32, it is
  recommended to add the value %LOCROOT%\bin\w32 to the system path. This has
  the advantage that all programs and DLLs located in %LOCROOT%\bin\w32 are
  found without stating an explicit directory path.
  It is further recommended that %LOCROOT% does not contain spaces and target an
  initially empty directory on a partition with at least 4 GB of free space.
  The directory %LOCROOT% shall be the installation path of all SysToMath
  packages installed on the system.
- Install the package with the installation path %LOCROOT% by executing the
  Win32 package installer ClearToolSuiteSetup-<Version>.exe.


2 Download and install the SysToMath package sources (optional)
===============================================================
- Download the Win32 package installer MakePkgSetup-<Version>.exe from SysToMath
  (see http://www.SysToMath.com/etc/html/libraries.html).
- Install the SysToMath package builder package MakePkg with the installation
  path %LOCROOT% by execuing MakePkgSetup.exe
- Download the SysToMath package source archive ClearToolSuiteSrc-<Version>.tgz
  from SysToMath (see http://www.SysToMath.com/etc/html/libraries.html).
- Environment Variable DEVLROOT
  This environment variable shall reside in the system environment (Settings,
  Control Panel, System, Enhanced, Environment, System Variables).
  %DEVLROOT% shall be different from %LOCROOT% but may be a subdirectory of it.
  It is further recommended that %DEVLROOT% does not contain spaces and target
  an initially empty directory on a partition with at least 4 GB of free space.
- Expand the package source archive into the directory %DEVLROOT% or into a
  subdirectory thereof. For the correct functioning of the command makepkg it
  is important that all SysToMath package source archives are installed
  somewhere in the tree rooted by %DEVLROOT%.
- Read the file ReleaseHowto.txt of the package source archive to learn about
  the procedures necessary to maintain and build the package.