source: git/INSTALL.win @ b8661e0

spielwiese
Last change on this file since b8661e0 was eb4fa6, checked in by Hans Schönemann <hannes@…>, 25 years ago
* hannes: bug 15 recorded (incomplete decomp. in primdecGTZ in char 3) git-svn-id: file:///usr/local/Singular/svn/trunk@3525 2c84dea3-7e68-4137-9b89-c4e89433aadc
  • Property mode set to 100644
File size: 7.9 KB
Line 
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       ===========================================================
9To install Singular on for Windows 95/NT, you need the following two
10archives:
11
12Singular-<x-y-z>-share.zip
13   -- contains architecture independent data like documentation and libraries
14Singular-<x-y-z>-ix86-Win.zip
15   -- contains architecture dependent executables, like the Singular program
16
17You can obtain these files from
18        ftp://www.mathematik.uni-kl.de/pub/Math/Singular/
19
20
21LICENSING
22=========
23Please see the file COPYING contained in the distribution for license
24information on Singular. In particular, notice that we only grant you
25permission to use Singular if you have registered yourself as a
26Singular user by sending email to <singular@mathematik.uni-kl.de>
27with the subject line (or, mail body) `register'.
28
29
30TO INSTALL SINGULAR
31===================
32There 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
48Unpacking creates Singular specific subdirectories in such a way that
49multiple versions of Singular can peaceably coexist under the same
50root.
51
52For both unpacking methods, it is VERY IMPORTANT that the path
53leading to the directory where you extract the Singular archive does
54not contain names which are longer than 8 characters and/or
55which contain dots or white spaces (i.e., the names must conform with
56MS-DOS filename conventions). Otherwise, the on-line help system will
57not work.
58
59
60After 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
75For the executable to work, the directory layout must look pretty much
76like this; the executable looks for "sibling" directories at run-time
77to figure out where its Singular libraries and on-line info
78documentation are.  These constraints on the local directory layout
79are necessary to avoid having to hardcode pathnames into the
80executables, or require that environment variables be set before
81running the executable. In particular, you should not move or copy
82the Singular executables to another place.
83
84
85RUNNING SINGULAR
86=================
87The easiest way to start-up Singular is to double-click on the
88`Singular.exe' file from your desktop.
89
90You can also start-up Singular from an MS-DOS or Bash/Sh (from Cygnus)
91terminal. However, for the latter case, you need to add the directory
92where the file `Singular.exe' resides to your PATH variable (unless
93you cd to that directory each time before you start Singular). Use the
94following commands:
95For the MS-DOS terminal
96
97  set PATH=%PATH%;<place where you extracted Singular>\Singular\<x-y-z>
98
99or, for the Bash/Sh terminal
100
101  export PATH=$PATH:<place where you extracted Singular>/Singular/<x-y-z>
102
103You also might want to adjust your personal start-up files accordingly,
104so that the PATH variable is set automatically each time you login.
105
106
107TROUBLES
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
175MORE INFORMATION ABOUT SINGULAR: COMMENTS, QUESTIONS, BUG REPORTS
176=================================================================
177More and up-to-date information about Singular is always available
178from
179           http://www.mathematik.uni-kl.de/~zca/Singular
180We very much welcome any comments, questions, and bug reports. Please
181contact us at 
182                    singular@mathematik.uni-kl.de
183
184
185GOOD LUCK and ENJOY!                         Your Singular team.
186
Note: See TracBrowser for help on using the repository browser.