tcltk/release_notes/README.txt

This file contains release notes for version 0.9.5 of ascend4,
binary for Windows.

Topics-
0. Documentation for the ASCEND language and how to use it
1. Installing under Win32 (95, 98, ME, NT4, XP)
2. Installing under Windows 3.1.1
3. Tcl/Tk used by ASCEND under Windows
4. Installing debugger version of ASCEND under Windows
5. Building ASCEND under Dev Studio from its sources
6. Modeling libraries from CMU

0. Documentation for the ASCEND language and how to use it.

   Howtos for mathematical modeling are available from
      http://ascend.cheme.cmu.edu/pdfhelp.htm.

   Bibliography and online publications relating to ASCEND and
   ASCEND applications are available from
      http://ascend.cheme.cmu.edu/ascend_documentation.htm.

   General information on ASCEND including free registration and
   bug report/technical support information is available from
      http://ascend.cheme.cmu.edu/Home.html

   All information is available in Adobe PDF format. Some information
   is available in alternate formats.


1. To install this software for Windows 95, 98, ME, NT 4, or XP:

   Unzip the distribution file. If your unzip program has an
   option that turns folder information off and on, turn it ON.
   ASCEND will not work without being arranged in its folders.

   Find ascopt4.exe in new folder <INSTALL_DIR>\ascend4-0.9.5\ascend4\bin\,
   then double-click to start ASCEND.
      or
   Right click the executable to create a shortcut and move the
   shortcut to your desktop or menu folder.

   Do NOT move the ascopt4.exe. It will not work except from
   the bin directory.

   The current release has only been tested on Windows XP.  If you
   encounter difficulties installing ASCEND, please let us know.


2. To install this software for Windows 3.1.1:

   ASCEND may work if you have installed Win32s.
   Verify that you have win32s and then follow the instructions for
   installing under Win32. We have not tested this theory as we
   have no obsolete Windows boxes available.


3. Tcl/Tk Notes:

   This release of ASCEND relies on Tcl/Tk 8.0p2, the portable GUI
   system from http://www.scriptics.com.  The ASCEND IV zip file is
   entirely self-contained.  You do not need to install Tcl/Tk
   separately. ASCEND will not interfere with any other Tcl/Tk
   version you may have installed.


4. To install the debugger version of ASCEND under windows:

   ASCEND IV is compiled with Mingw gcc 3.2.3 available from
   http://www.mingw.org.  The unoptimized executable file with
   debugger symbols is available.
     - Install the normal version of ASCEND IV.
     - Obtain a4debug.zip from the same download area
       where you obtained the normal version.
     - Unzip a4debug.zip.
     - Move ascend4.exe to <INSTALL_DIR>\ascend4-0.9.0/ascend4/bin.
       It will be in the same location as ascopt4.exe.
     - Run ascend4.exe just as you would ascopt.exe.
   Otherwise, you'll have to build ASCEND yourself in debug mode.


5. Building ascend4 from the source distribution.

   ASCEND IV is compiled from a single set of sources that
   works under most known ANSI C/C++ compilers for UNIX/X11R6
   or Windows. It is in principle portable to Macintosh,
   though this has not been done.

   Building ASCEND under Linux or other UNIX is trivial
   assuming you have matched ansi compliant C and F77
   compilers available. The configure and make programs
   take care of nearly everything automagically.

   Under Windows, life is not so simple.
   Compiling the complete system requires a matched set of
   C and FORTRAN compilers.  Known combinations that work
   include Mingw gcc/g77 and Visual C++/Digital FORTRAN.
   The Open Watcom tools almost work, but lack a couple of
   needed ieee math functions at this point.  The standard
   distribution is built using jam (ft variant preferred,
   see http://freetype.sourceforge.net/jam) and Mingw.  At
   this point, it is necessary to manually set options in
   <TOP>\jam\Jamrules_general.  Then, run jam in each of the
   jam subdirectories of base, blas, linpack, lsod, and
   tcltk (last).  A sporadically-maintained Visual Studio 7
   project set is also provided in the source distribution.
   You're on your own for an alternate FORTRAN compiler.


6. Modeling libraries from CMU

   A variety of libraries are included in the ascend4\models\
   directory. See ascend4\models\README.txt or README.html for
   details. Additional contributed models may be available from the
   ASCEND web sites above.

1	This file contains release notes for version 0.9.5 of ascend4,
2	binary for Windows.
3
4	Topics-
5	0. Documentation for the ASCEND language and how to use it
6	1. Installing under Win32 (95, 98, ME, NT4, XP)
7	2. Installing under Windows 3.1.1
8	3. Tcl/Tk used by ASCEND under Windows
9	4. Installing debugger version of ASCEND under Windows
10	5. Building ASCEND under Dev Studio from its sources
11	6. Modeling libraries from CMU
12
13	0. Documentation for the ASCEND language and how to use it.
14
15	Howtos for mathematical modeling are available from
16	http://ascend.cheme.cmu.edu/pdfhelp.htm.
17
18	Bibliography and online publications relating to ASCEND and
19	ASCEND applications are available from
20	http://ascend.cheme.cmu.edu/ascend_documentation.htm.
21
22	General information on ASCEND including free registration and
23	bug report/technical support information is available from
24	http://ascend.cheme.cmu.edu/Home.html
25
26	All information is available in Adobe PDF format. Some information
27	is available in alternate formats.
28
29
30	1. To install this software for Windows 95, 98, ME, NT 4, or XP:
31
32	Unzip the distribution file. If your unzip program has an
33	option that turns folder information off and on, turn it ON.
34	ASCEND will not work without being arranged in its folders.
35
36	Find ascopt4.exe in new folder <INSTALL_DIR>\ascend4-0.9.5\ascend4\bin\,
37	then double-click to start ASCEND.
38	or
39	Right click the executable to create a shortcut and move the
40	shortcut to your desktop or menu folder.
41
42	Do NOT move the ascopt4.exe. It will not work except from
43	the bin directory.
44
45	The current release has only been tested on Windows XP. If you
46	encounter difficulties installing ASCEND, please let us know.
47
48
49	2. To install this software for Windows 3.1.1:
50
51	ASCEND may work if you have installed Win32s.
52	Verify that you have win32s and then follow the instructions for
53	installing under Win32. We have not tested this theory as we
54	have no obsolete Windows boxes available.
55
56
57	3. Tcl/Tk Notes:
58
59	This release of ASCEND relies on Tcl/Tk 8.0p2, the portable GUI
60	system from http://www.scriptics.com. The ASCEND IV zip file is
61	entirely self-contained. You do not need to install Tcl/Tk
62	separately. ASCEND will not interfere with any other Tcl/Tk
63	version you may have installed.
64
65
66	4. To install the debugger version of ASCEND under windows:
67
68	ASCEND IV is compiled with Mingw gcc 3.2.3 available from
69	http://www.mingw.org. The unoptimized executable file with
70	debugger symbols is available.
71	- Install the normal version of ASCEND IV.
72	- Obtain a4debug.zip from the same download area
73	where you obtained the normal version.
74	- Unzip a4debug.zip.
75	- Move ascend4.exe to <INSTALL_DIR>\ascend4-0.9.0/ascend4/bin.
76	It will be in the same location as ascopt4.exe.
77	- Run ascend4.exe just as you would ascopt.exe.
78	Otherwise, you'll have to build ASCEND yourself in debug mode.
79
80
81	5. Building ascend4 from the source distribution.
82
83	ASCEND IV is compiled from a single set of sources that
84	works under most known ANSI C/C++ compilers for UNIX/X11R6
85	or Windows. It is in principle portable to Macintosh,
86	though this has not been done.
87
88	Building ASCEND under Linux or other UNIX is trivial
89	assuming you have matched ansi compliant C and F77
90	compilers available. The configure and make programs
91	take care of nearly everything automagically.
92
93	Under Windows, life is not so simple.
94	Compiling the complete system requires a matched set of
95	C and FORTRAN compilers. Known combinations that work
96	include Mingw gcc/g77 and Visual C++/Digital FORTRAN.
97	The Open Watcom tools almost work, but lack a couple of
98	needed ieee math functions at this point. The standard
99	distribution is built using jam (ft variant preferred,
100	see http://freetype.sourceforge.net/jam) and Mingw. At
101	this point, it is necessary to manually set options in
102	<TOP>\jam\Jamrules_general. Then, run jam in each of the
103	jam subdirectories of base, blas, linpack, lsod, and
104	tcltk (last). A sporadically-maintained Visual Studio 7
105	project set is also provided in the source distribution.
106	You're on your own for an alternate FORTRAN compiler.
107
108
109	6. Modeling libraries from CMU
110
111	A variety of libraries are included in the ascend4\models\
112	directory. See ascend4\models\README.txt or README.html for
113	details. Additional contributed models may be available from the
114	ASCEND web sites above.
115