############################################ # 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-.exe, Boost-1.34Setup-.exe - LibStmCppSetup-.exe - LibUsbWin32-0.1Setup-.exe - LibStmIoSetup-.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-.exe - Boost-1.35Setup-.exe - Boost.Asio-0.3Setup-.exe (Boost.Asio is included in Boost-1.35) - BerkeleyDb-4.6Setup-.exe or BerkeleyDb-4.7Setup-.exe - PthreadsWin32-2Setup-.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-.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-.tgz - LibStmCSrc-.tgz - Boost-1.34Src-.tgz - Boost-1.35Src-.tgz - LibStmCppSrc-.tgz - LibStmIo-.tgz - ClearToolSuiteSrc-.tgz - BerkeleyDb-4.6Src-.tgz - BerkeleyDb-4.7Src-.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.