############################################
# DevEnvHowto - Tom Michaelis (2008-08-03) #
############################################

This document explains how to set up your development environment in order to
use the packages LibStmC, Boost-1.34, Boost-1.35, LibStmCpp, LibUsbWin32-0.1,
LibStmIo, ClearToolSuite, Boost.Asio-0.3, BerkeleyDb-4.6, BerkeleyDb-4.7 and
PthreadsWin32-2.


1 Download and install the package header and library files
===========================================================
- Download the Win32 package installers 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 reside 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 NTFS partition with at least 4 GB of free
  space. If the partition of that directory is no NTFS partition, file hard
  links will be replaced by copies of the files concerned.
  The directory %LOCROOT% serves as the installation path of all SysToMath
  packages installed on the system.
- Install the packages in the same installation path %LOCROOT% by execuing the
  Win32 package installers
   - LibStmCSetup-<Version>.exe, Boost-1.34Setup-<Version>.exe
   - LibStmCppSetup-<Version>.exe
   - LibUsbWin32-0.1Setup-<Version>.exe
   - LibStmIoSetup-<Version>.exe
  Each package requires the ones listed above of it as prerequisites.
- Install the optional packages in the same installation path %LOCROOT% by
  execuing the Win32 package installers
   - ClearToolSuiteSetup-<Version>.exe
   - Boost-1.35Setup-<Version>.exe
   - Boost.Asio-0.3Setup-<Version>.exe (Boost.Asio is included in Boost-1.35)
   - BerkeleyDb-4.6Setup-<Version>.exe or BerkeleyDb-4.7Setup-<Version>.exe
   - PthreadsWin32-2Setup-<Version>.exe
- Read the files readme.txt of the packages to learn about the procedures
  necessary to use the libraries and tools provided by the packages.


2 Download and install the SysToMath package sources (optional)
===============================================================
- Install the SysToMath package builder package MakePkg to the installation
  path %LOCROOT% by execuing the Win32 package installer
   - MakePkgSetup-<Version>.exe
- Read the file readme.txt of the package MakePkg to learn about the procedures
  necessary to use the SysToMath package builder command makepkg.
- Download the SysToMath package source archives
   - MakePkgSrc-<Version>.tgz
   - LibStmCSrc-<Version>.tgz
   - Boost-1.34Src-<Version>.tgz
   - Boost-1.35Src-<Version>.tgz
   - LibStmCppSrc-<Version>.tgz
   - LibStmIo-<Version>.tgz
   - ClearToolSuiteSrc-<Version>.tgz
   - BerkeleyDb-4.6Src-<Version>.tgz
   - BerkeleyDb-4.7Src-<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% and also the last directory of
  the path %DEVLROOT% shall be differerent from the last directory of the path
  %LOCROOT%.
  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 archives into the directory %DEVLROOT% or into a
  subdirectory thereof. For the correct functioning of the command makepkg it
  is important that all source packages are installed somewhere in the tree
  rooted by %DEVLROOT%.
- Read the files ReleaseHowto.txt of the packages to learn about the procedures
  necessary to maintain and build the packages.