Installation of Jam/MR v2.2

First at all:

  1. Get a new source archive of Jam/MR from Perforce Software
  2. Extract the tar archive into a directory.

Windows NT/95/98:

For all MS Windows platforms you have to apply a patch-file. You can get this patch from the Tycoon-2 distribution on the directory contrib/Jam-2.2/STSNotes.

  1. First copy the patch-file to the Jam source directory.
  2. Get a working patch.exe e.g. from the Cygnus GNU Tools (see below).
  3. Apply the patch: patch -u -b <Jam.patch

This patch performs following changes on the original Jam sources:

  1. Generation of all needed Makefiles: Makefile.nt, Makefile.w95, Makefile.w98
  2. On Windows NT: Set definition of MAXLINE (Jam.h) to 10K (10240)
  3. On Windows 95/98: Additional #ifdefs, other behaviour of spawnvp (execdos.c)

Environment variables on Windows Platforms:

If you use MS Visual C++, you have to set the MSVCNT environment variable (see JAM readme). This variable contains the path to the C compiler: 

SET MSVCNT=F:\Lang\DevStudio\VC

In the Tycoon-2 distribution this will be done automaticly by the tools/win32/def_tl2.bat batchfile. But there is a problem (for Jam), if the path to the C compiler contains spaces, e.g.: 

SET MSVCNT="C:\Program Files\DevStudio\VC"

This donīt work well with Jam, so you have to do somewhat like that: 

SUBST Y: "C:\Program Files\DevStudio"
SET MSVCNT=Y:\VC

Note, that for compiling Jam with MS Visual C++ you have to set further environment variables, defined in VCVARS32.BAT (in the MS Visual binary path).

Compiling Jam:

First at all, you have to compile Jam with make (or nmake on MS Windows). If you already have a Jam executable, you can compile Jam with itīs self (there is a Jamfile on the Jam sources, that describes how to compile Jam). Depending on your current platform, you can perform the initial compile of jam with the following Makefiles:

System Calling make Binary directory
Linux make bin.linuxx86
Windows NT nmake -f makefile.nt bin.winntx86
Windows 95 nmake -f makefile.w95 bin.win95x86
Windows 98 nmake -f makefile.w98 bin.win98x86

For other Unix systems do the same as for Linux. The compiled jam executable in the binary directory can be copied into a directory in your path. Only this file ist needed for working with Jam (the Jambase is builtin).

On all Windows platforms two additional tools are needed for working with Jam: rm.exe and touch.exe, which can be either retrieved from the MS Windows NT Resource Kit, or from the Cygnus GNU Tools for Win32. If you perform further modifications on the Jam sources, you also need diff.exe and patch.exe from the Cygnus GNU Tools for Win32. You can find all needed files in the Tycoon-2 distribution at the directory contrib/Win32.

Examples:

On the directory contrib/Jam-2.2/STSNotes there are two samples: Sample01, for building a simple main program, and Sample02 for building a main program with a library. For better samples for Jam with building dynamic link libraries, take a look to the sources of the Tycoon-2 distribution. For further information for using Jam look at the Jamming mailing list on Perforce Software

Andre Willomat (MAY/31/99). Your feedback is welcome!