tcltk98/jam/ReadMe.txt


THIS FILE IS DEPRECATED - 20-Dec-2005

The files in this directory support building the Tcl/Tk
version of ths Ascend modeling system using the jam* build tool.

The following files are included:

  Jamfile     - build instructions for the Ascend libs
  Jamrules.in - configuration & custom build rules used by Jamfile

The build also requires ../../jam/Jamrules_general and
../../jam/Jambase.  This system builds the Ascend executable
as well as a static library of Tcl/Tk interface functions.
Installation of the resulting program is still under construction.

The Ascend jam build system currently supports building the libraries
under Windows using the MSVC, Borland, MinGW, and Watcom** compilers
(extension to Linux/gcc is on the todo list).  With use of the
included Jambase file, it should work with both the original and ftjam
variants of jam.  The system was developed primarily using ftjam.

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

The interface library (libasc_tcltk98) is built in
./CONFIGTYPE/COMPILER/interface, while the executable
is built in ./CONFIGTYPE/COMPILER where
    CONFIGTYPE = Debug, Release
    COMPILER   = bcc, msvc, mingw, watcom, linix

There are several dependent libraries which must be provided to
successfully link the Ascend executable:

    libasc_compiler
    libasc_general
    libasc_packages
    libasc_solver
    libasc_utilities
    tcl80
    tk80

The default location for the Ascend base libraries is
../../base/jam/CONFIGTYPE/COMPILER.  The default location for the Tcl/Tk
libraries is ../../../Tcl/lib.  These may be modified by editing the
Jamrules file.
-------------------------------------------------------------------------

Build Instructions

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

2. Copy Jamrules.in to Jamrules.

3. Manually edit ../../jam/Jamrules_general, Jamrules and (if 
   necessary) Jamfile to set configuration and local directory 
   options.

4. Run jam from using the provided Jambase:
      jam -f ../../jam/Jambase ascend

-------------------------------------------------------------------------
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 but
cannot link the executable.  This is because Watcom does not supply
the required IEEE math functions isnan() and copysign().  Ascend does
not currently provide these support functions.

1
2	THIS FILE IS DEPRECATED - 20-Dec-2005
3
4	The files in this directory support building the Tcl/Tk
5	version of ths Ascend modeling system using the jam* build tool.
6
7	The following files are included:
8
9	Jamfile - build instructions for the Ascend libs
10	Jamrules.in - configuration & custom build rules used by Jamfile
11
12	The build also requires ../../jam/Jamrules_general and
13	../../jam/Jambase. This system builds the Ascend executable
14	as well as a static library of Tcl/Tk interface functions.
15	Installation of the resulting program is still under construction.
16
17	The Ascend jam build system currently supports building the libraries
18	under Windows using the MSVC, Borland, MinGW, and Watcom** compilers
19	(extension to Linux/gcc is on the todo list). With use of the
20	included Jambase file, it should work with both the original and ftjam
21	variants of jam. The system was developed primarily using ftjam.
22
23	Automatic processing of Jamrules.in to Jamrules by configure is
24	not currently implemented. Until it is, users will need to manually
25	copy Jamrules.in to Jamrules and edit Jamrules to match their
26	preferenes & configuration.
27
28	The interface library (libasc_tcltk98) is built in
29	./CONFIGTYPE/COMPILER/interface, while the executable
30	is built in ./CONFIGTYPE/COMPILER where
31	CONFIGTYPE = Debug, Release
32	COMPILER = bcc, msvc, mingw, watcom, linix
33
34	There are several dependent libraries which must be provided to
35	successfully link the Ascend executable:
36
37	libasc_compiler
38	libasc_general
39	libasc_packages
40	libasc_solver
41	libasc_utilities
42	tcl80
43	tk80
44
45	The default location for the Ascend base libraries is
46	../../base/jam/CONFIGTYPE/COMPILER. The default location for the Tcl/Tk
47	libraries is ../../../Tcl/lib. These may be modified by editing the
48	Jamrules file.
49	-------------------------------------------------------------------------
50
51	Build Instructions
52
53	1. jam must be installed and configured for the compiler in use.
54
55	2. Copy Jamrules.in to Jamrules.
56
57	3. Manually edit ../../jam/Jamrules_general, Jamrules and (if
58	necessary) Jamfile to set configuration and local directory
59	options.
60
61	4. Run jam from using the provided Jambase:
62	jam -f ../../jam/Jambase ascend
63
64	-------------------------------------------------------------------------
65	Notes:
66
67	* jam is an open source, multi-platform build tool
68	which is available in several flavors. These include
69	the original (http://www.perforce.com) and ftjam
70	(http://www.freetype.org/jam/index.html) variants,
71	among others.
72
73	** Currently, Open Watcom 1.3 can compile the Ascend sources but
74	cannot link the executable. This is because Watcom does not supply
75	the required IEEE math functions isnan() and copysign(). Ascend does
76	not currently provide these support functions.
77