trunk/jam/ReadMe.txt

The files in this directory support building the Ascend
libraries and executables using the jam* build tool.

The following files are included:

  Jamrules_general.in - configuration & custom build rules used by Jamfiles
  Jambase             - lightly customized version of standard build rules
                        (primarily to shore up support for different compilers)

The Ascend jam build system currently supports building under Windows 
using the MSVC, Borland, MinGW, and Watcom** compilers, and under
Linux using gcc/g77.  With use of the included Jambase file, it should 
work with both the original and ftjam variants of jam. However, the
system was developed primarily using ftjam.

Automatic processing of Jamrules_general.in to Jamrules_general by
configure is not currently implemented.  Until it is, users will
need to manually copy Jamrules_general.in to Jamrules_general and
edit Jamrules_general to match their preferenes & configuration.

-------------------------------------------------------------------------

Build Instructions

1. jam must be installed and configured for the compiler in use.

2. Copy Jamrules_general.in to Jamrules_general.

3. Manually edit Jamrules_general to set configuration and local
   directory options.  These settings are used by all the Jamfiles
   in the Ascend source tree.

4. Follow the instructions in the particular Jamfile.

-------------------------------------------------------------------------
Notes:

* jam is an open source, multi-platform build tool
which is available in several flavors.  These include
the original (http://www.perforce.com) and ftjam
(http://www.freetype.org/jam/index.html) variants,
among others.

** Currently, Open Watcom 1.3 can compile the Ascend sources
and build the libraries.  However, it does not supply the required
IEEE math functions isnan() and copysign().  At present, Ascend does
not supply these, so the user must provide these functions to use
the libraries under Watcom.

1	jds	40	The files in this directory support building the Ascend
2			libraries and executables using the jam* build tool.
3
4			The following files are included:
5
6			Jamrules_general.in - configuration & custom build rules used by Jamfiles
7			Jambase - lightly customized version of standard build rules
8			(primarily to shore up support for different compilers)
9
10			The Ascend jam build system currently supports building under Windows
11			using the MSVC, Borland, MinGW, and Watcom** compilers, and under
12			Linux using gcc/g77. With use of the included Jambase file, it should
13	jds	47	work with both the original and ftjam variants of jam. However, the
14			system was developed primarily using ftjam.
15	jds	40
16	jds	47	Automatic processing of Jamrules_general.in to Jamrules_general by
17			configure is not currently implemented. Until it is, users will
18			need to manually copy Jamrules_general.in to Jamrules_general and
19			edit Jamrules_general to match their preferenes & configuration.
20	jds	40
21			-------------------------------------------------------------------------
22
23			Build Instructions
24
25			1. jam must be installed and configured for the compiler in use.
26
27			2. Copy Jamrules_general.in to Jamrules_general.
28
29	jds	47	3. Manually edit Jamrules_general to set configuration and local
30	jds	40	directory options. These settings are used by all the Jamfiles
31			in the Ascend source tree.
32
33			4. Follow the instructions in the particular Jamfile.
34
35			-------------------------------------------------------------------------
36			Notes:
37
38			* jam is an open source, multi-platform build tool
39			which is available in several flavors. These include
40			the original (http://www.perforce.com) and ftjam
41			(http://www.freetype.org/jam/index.html) variants,
42			among others.
43
44			** Currently, Open Watcom 1.3 can compile the Ascend sources
45			and build the libraries. However, it does not supply the required
46			IEEE math functions isnan() and copysign(). At present, Ascend does
47	jds	46	not supply these, so the user must provide these functions to use
48	jds	40	the libraries under Watcom.
49