ViewVC logotype

Contents of /trunk/README-windows.txt

Parent Directory Parent Directory | Revision Log Revision Log

Revision 1573 - (show annotations) (download)
Sat Aug 4 09:37:03 2007 UTC (16 years, 9 months ago) by jpye
File MIME type: text/plain
File size: 5185 byte(s)
Added support for automatic download/install of ActiveTcl.
1 README for Windows Users
2 ========================
4 The following contains some specific comments for people who have
5 installed ASCEND on Windows using the binary 'setup' installer. If you have
6 built you own copy of ASCEND from the source code, comments here may not
7 apply to you.
9 For more information about and support for ASCEND, consult our home page:
10 http://ascend.cheme.cmu.edu/
12 ASCEND documentation (such as it is) is available at the above link, or
13 if you selected to install the Documentation, you should have a link
14 called "User's Manual" in your Start Menu under ASCEND. At present the
15 documentation is available only as a PDF file.
18 Running ASCEND
19 --------------
21 There are two different GUIs for ASCEND. Depending on the software that was
22 available on your machine at the time when you installed ASCEND, you may
23 have either the Tcl/Tk GUI and the PyGTK GUI, or both of these, or neither.
25 The newer GUI is the PyGTK GUI. It looks nice and is under active development.
26 An alternative GUI is the Tcl/Tk GUI which is older but still somewhat more
27 stable and complete than the new GUI. It is not really under active development
28 any more, however. You can choose for yourself.
31 Running the PyGTK GUI
32 ---------------------
34 ASCEND can be launched from the Start menu. If you didn't choose to install
35 the Start menu shortcuts, you can run ASCEND using
37 c:\Python25\pythonw.exe c:\Program Files\ASCEND\ascend
39 The location of 'pythonw.exe' and 'ascend' may be different depending on
40 where you installed Python and where you installed ASCEND.
42 You can also launch the PyGTK GUI for ASCEND by double-clicking on files
43 with the .a4c or .a4l extension. The installer will associate ASCEND with
44 those file extensions.
46 There is not yet a manual for the PyGTK GUI. The 'Help' menu also provides
47 access to the online manual.
50 Running the Tcl/Tk GUI
51 ----------------------
53 The Tcl/Tk GUI can be run from the Start menu.
55 If you didn't select to install start menu shortcuts, you can launch it
56 via
58 c:\Program Files\ASCEND\ascend4.exe
60 The file location will depend on the folder where you chose to install ASCEND.
62 There is no file association for .a4c and .a4l files with the Tcl/Tk GUI.
64 Note that .a4s files are 'scripts' for the Tcl/Tk GUI.
66 A PDF-file manual has been written for the Tcl/Tk GUI and may be downloaded
67 from the ASCEND wiki.
70 If ASCEND Stops Working
71 -----------------------
73 An easy way to break ASCEND is to remove some of the software it depends
74 on in order to work. This includes uninstalling Python, GTK+, Tcl/Tk,
75 PyCairo, PyGObject, PyGTK, IPython, Numpy, Matplotlib and possibly others.
77 The best thing to do in this case is to uninstall ASCEND using the
78 Add/Remove Programs control panel, then attempting to re-install it. At this
79 point, the installer should tell you what components you are missing.
82 Configuration Settings
83 ----------------------
85 There are configuration settings in the Windows Registry that the ASCEND
86 PyGTK GUI uses to determine where its files have been installed.
88 There are also per-user settings installed in
90 c:\Documents and Settings\yourusername\Application Data\.ascend.ini
92 This last file can be edited if you want to add new folders to your
93 ASCENDLIBRARY path, for example if you are building up a collection of your
94 own ASCEND models in a directory of their own.
96 For example:
98 [Directories]
99 librarypath = C:\Program Files\ASCEND\models;C:\Program Files\freesteam\ascend
101 Other settings are also stored in this file. You can delete this file if you
102 to revert to the default settings that ASCEND used when you first installed
103 it.
105 Neither .ascend.ini file nor the Windows Registry are used by the Tcl/Tk
106 version of ASCEND. Instead, a number of files are stored in the 'ascdata'
107 folder within your My Documents folder.
110 Removing ASCEND from your System
111 --------------------------------
113 The uninstaller for ASCEND can be found in the Start menu and also in the
114 Add/Remove Programs list. In any case, the uninstaller will remove all
115 ASCEND components from your system.
117 NOTE however that when the uninstaller runs, it does NOT remove the
118 dependencies such as Python, PyGTK, GTK+ etc that may have been downloaded
119 and installed by the ASCEND installer when you first installed ASCEND.
120 These additional components will need to be removed by you manually. The
121 reason that they are not automatically removed is that it is not
122 possible to determine whether or not you have other programs installed
123 that also depend on them.
125 Syntax Highlighting for TextPad
126 -------------------------------
128 If you would like to be able to edit ASCEND files using a text edit that
129 provides syntax highlighting support, you can use the editor 'TextPad'
130 available from http://www.textpad.com. If you use TextPad, you can use
131 the syntax file 'ascend.syn' that is installed in c:\Program Files\ASCEND
132 by first copying it to your c:\Program Files\TextPad 5\system folder,
133 and then creating a new 'Document Class' for .a4c and .a4l files, and
134 selecting the 'ascend.syn' syntax file.
136 --
137 John Pye
138 4 Aug 2007.

ViewVC Help
Powered by ViewVC 1.1.22