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	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	work with both the original and ftjam variants of jam. However, the
14	system was developed primarily using ftjam.
15
16	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
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	3. Manually edit Jamrules_general to set configuration and local
30	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	not supply these, so the user must provide these functions to use
48	the libraries under Watcom.
49