1 | Singular version <x-y-z> |
---|
2 | University of Kaiserslautern |
---|
3 | Department of Mathematics Centre for Computer Algebra |
---|
4 | Authors: G.-M. Greuel, G. Pfister, H. Schoenemann |
---|
5 | (C) 1986-1999 All Rights Reserved |
---|
6 | |
---|
7 | WINDOWS 95/98/NT INSTALLATION INSTRUCTIONS FOR SINGULAR |
---|
8 | =========================================================== |
---|
9 | To install Singular on for Windows 95/NT, you need the following two |
---|
10 | archives: |
---|
11 | |
---|
12 | Singular-<x-y-z>-share.zip |
---|
13 | -- contains architecture independent data like documentation and libraries |
---|
14 | Singular-<x-y-z>-ix86-Win.zip |
---|
15 | -- contains architecture dependent executables, like the Singular program |
---|
16 | |
---|
17 | You can obtain these files from |
---|
18 | ftp://www.mathematik.uni-kl.de/pub/Math/Singular/ |
---|
19 | |
---|
20 | |
---|
21 | LICENSING |
---|
22 | ========= |
---|
23 | Please see the file COPYING contained in the distribution for license |
---|
24 | information on Singular. In particular, notice that we only grant you |
---|
25 | permission to use Singular if you have registered yourself as a |
---|
26 | Singular user by sending email to <singular@mathematik.uni-kl.de> |
---|
27 | with the subject line (or, mail body) `register'. |
---|
28 | |
---|
29 | |
---|
30 | TO INSTALL SINGULAR |
---|
31 | =================== |
---|
32 | There are two methods: |
---|
33 | (a) If you have a Windows unzip utility program (like WinZip) installed |
---|
34 | on your system: |
---|
35 | (1) double-click on the file `Singular-<x-y-z>-ix86-Win.zip' |
---|
36 | (2) double-click on the file `Singular-<x-y-z>-share.zip' |
---|
37 | thereby extract the content of the archives at a directory in |
---|
38 | which you usually install 3rd-party software. |
---|
39 | |
---|
40 | (b) Otherwise, download the file `unzip.exe' from |
---|
41 | ftp://www.mathematik.uni-kl.de/pub/Math/Singular/utils |
---|
42 | start an MS-DOS shell, move the Singular archive and unzip program |
---|
43 | to a place in which you usually install 3rd-party software and |
---|
44 | extract (unpack) the archives with the command(s): |
---|
45 | (1) unzip Singular-<x-y-z>-ix86-Win.zip |
---|
46 | (2) unzip Singular-<x-y-z>-share.zip |
---|
47 | |
---|
48 | Unpacking creates Singular specific subdirectories in such a way that |
---|
49 | multiple versions of Singular can peaceably coexist under the same |
---|
50 | root. |
---|
51 | |
---|
52 | For both unpacking methods, it is VERY IMPORTANT that the path |
---|
53 | leading to the directory where you extract the Singular archive does |
---|
54 | not contain names which are longer than 8 characters and/or |
---|
55 | which contain dots or white spaces (i.e., the names must conform with |
---|
56 | MS-DOS filename conventions). Otherwise, the on-line help system will |
---|
57 | not work. |
---|
58 | |
---|
59 | |
---|
60 | After unpacking, you will have a directory structure like: |
---|
61 | ./Singular/<x-y-z>/Singular.exe Singular executable |
---|
62 | ./Singular/<x-y-z>/libparse.exe parser for Singular libraries |
---|
63 | ./Singular/<x-y-z>/cygwin1.dll CYGWIN DLL Library |
---|
64 | ./Singular/<x-y-z>/info.exe info program |
---|
65 | ./Singular/<x-y-z>/sh.exe sh program |
---|
66 | ./Singular/LIB/<x-y-z>/ Singular libraries |
---|
67 | ./Singular/LIB/gftables/ Singular lookup tables |
---|
68 | ./Singular/doc/<x-y-z>/ documentation (ps, dvi, info) |
---|
69 | ./Singular/html/<x-y-z>/ documentation (html) |
---|
70 | ./Singular/README general information on Singular |
---|
71 | ./Singular/COPYING licence information |
---|
72 | ./Singular/INSTALL this file |
---|
73 | |
---|
74 | |
---|
75 | For the executable to work, the directory layout must look pretty much |
---|
76 | like this; the executable looks for "sibling" directories at run-time |
---|
77 | to figure out where its Singular libraries and on-line info |
---|
78 | documentation are. These constraints on the local directory layout |
---|
79 | are necessary to avoid having to hardcode pathnames into the |
---|
80 | executables, or require that environment variables be set before |
---|
81 | running the executable. In particular, you should not move or copy |
---|
82 | the Singular executables to another place. |
---|
83 | |
---|
84 | |
---|
85 | RUNNING SINGULAR |
---|
86 | ================= |
---|
87 | The easiest way to start-up Singular is to double-click on the |
---|
88 | `Singular.exe' file from your desktop. |
---|
89 | |
---|
90 | You can also start-up Singular from an MS-DOS or Bash/Sh (from Cygnus) |
---|
91 | terminal. However, for the latter case, you need to add the directory |
---|
92 | where the file `Singular.exe' resides to your PATH variable (unless |
---|
93 | you cd to that directory each time before you start Singular). Use the |
---|
94 | following commands: |
---|
95 | For the MS-DOS terminal |
---|
96 | |
---|
97 | set PATH=%PATH%;<place where you extracted Singular>\Singular\<x-y-z> |
---|
98 | |
---|
99 | or, for the Bash/Sh terminal |
---|
100 | |
---|
101 | export PATH=$PATH:<place where you extracted Singular>/Singular/<x-y-z> |
---|
102 | |
---|
103 | You also might want to adjust your personal start-up files accordingly, |
---|
104 | so that the PATH variable is set automatically each time you login. |
---|
105 | |
---|
106 | |
---|
107 | TROUBLES |
---|
108 | ========= |
---|
109 | * Singular complains that it can not find `cygwin1.dll': |
---|
110 | Make sure that the DLL library `cygwin1.dll' which is included in |
---|
111 | the distribution at `./Singular/<x-y-z>/' was either copied to a |
---|
112 | standard place on your system (like /WIN32), or that your PATH |
---|
113 | variable contains the directory where this library resides. See |
---|
114 | above for more details. |
---|
115 | |
---|
116 | * Singular can not find its Singular libraries : |
---|
117 | (1) Start up Singular, and issue the command `system("Singular");'. |
---|
118 | If this does not return the correct and expanded location of the |
---|
119 | Singular executable, then you found a bug in Singular, which we |
---|
120 | ask you to report (see below). |
---|
121 | (2) Check whether the directory containing the libraries can be |
---|
122 | found by Singular: If $bindir denotes the directory where the |
---|
123 | Singular executable resides, then Singular looks for library |
---|
124 | files as follows: |
---|
125 | 1.) In all dirs specified by the environment variable SINGULARPATH |
---|
126 | 2.) $bindir/LIB |
---|
127 | 3.) $bindir/LIB/<x-y-z> |
---|
128 | 4.) $bindir/../../Singular/LIB |
---|
129 | 5.) $bindir/../../Singular/LIB/<x-y-z> |
---|
130 | 6.) /Singular/LIB/ |
---|
131 | 7.) /Singular/LIB/<x-y-z> |
---|
132 | If one of these directories exists, then it is appended to the |
---|
133 | Singular SearchPath (in that order) and libraries are looked for |
---|
134 | in all directories contained in the Singular SearchPath. You can |
---|
135 | inspect the used SearchPath by starting up Singular with the -v |
---|
136 | option, or by issuing the command `system("with")'. |
---|
137 | (3) As a last resort, you can set the environment variable |
---|
138 | SINGULARPATH, so that the directories containing the Singular |
---|
139 | libraries and info-files are contained in the value of |
---|
140 | SINGULARPATH. Use semicolons (i.e., `;') for directory |
---|
141 | separators within the SINGULARPATH. |
---|
142 | |
---|
143 | * Singular can not display its on-line help. |
---|
144 | (1) Make sure Singular can find its Singular libraries. |
---|
145 | (2) Check whether the `info.exe' program contained in the |
---|
146 | distribution resides at the same place as the `Singular.exe' |
---|
147 | file. |
---|
148 | (3) Issue the command `system("with")' and verify that the reported |
---|
149 | "InfoProgram" exists and can be executed. |
---|
150 | (4) Check whether the directory containing the file `singular.hlp' |
---|
151 | can be found by Singular: If $bindir denotes the directory where |
---|
152 | the Singular executable resides, then Singular looks for the |
---|
153 | file 'singular.hlp' at the following places (in the specified |
---|
154 | order): |
---|
155 | 1.) $bindir/../doc/ |
---|
156 | 2.) $bindir/../info/ |
---|
157 | 3.) $bindir/../../Singular/doc/<x-y-z>/ |
---|
158 | 4.) $bindir/../../Singular/doc/ |
---|
159 | 5.) $bindir/../../info/ |
---|
160 | 6.) /Singular/doc/<x-y-z>/ |
---|
161 | 7.) /Singular/doc/ |
---|
162 | 8.) /info/ |
---|
163 | 9.) In all directories contained in the Singular SearchPath. |
---|
164 | (5) Make sure that the path leading to $bindir does not contain names |
---|
165 | which are longer than 8 characters and/or which contain dots or |
---|
166 | white spaces (i.e., the names must conform with MS-DOS filename |
---|
167 | conventions). |
---|
168 | |
---|
169 | * For any other troubles, please send mail to |
---|
170 | singular@mathematik.uni-kl.de |
---|
171 | and include the header which is displayed by starting up Singular |
---|
172 | with the `-v' option. |
---|
173 | |
---|
174 | |
---|
175 | MORE INFORMATION ABOUT SINGULAR: COMMENTS, QUESTIONS, BUG REPORTS |
---|
176 | ================================================================= |
---|
177 | More and up-to-date information about Singular is always available |
---|
178 | from |
---|
179 | http://www.mathematik.uni-kl.de/~zca/Singular |
---|
180 | We very much welcome any comments, questions, and bug reports. Please |
---|
181 | contact us at |
---|
182 | singular@mathematik.uni-kl.de |
---|
183 | |
---|
184 | |
---|
185 | GOOD LUCK and ENJOY! Your Singular team. |
---|
186 | |
---|