1 | @comment -*-texinfo-*- |
---|
2 | @comment $Id: INSTALL_win.texi,v 1.4 2000-05-30 07:38:39 obachman Exp $ |
---|
3 | @c FILE: INSTALL.texi |
---|
4 | @c PURPOSE: Installation instructions for Singular on MSWindows |
---|
5 | @c This file is displayed during installation and copied to |
---|
6 | @c /etc/INSTALL |
---|
7 | |
---|
8 | @ifclear VERSION |
---|
9 | @include version.texi |
---|
10 | @end ifclear |
---|
11 | |
---|
12 | @ifclear singularmanual |
---|
13 | @majorheading Installation innstructions for Singular on MSWINDOWS. |
---|
14 | @end ifclear |
---|
15 | |
---|
16 | To install @sc{Singular} on a PC running Windows 95/98/NT/2K, you need |
---|
17 | to download @emph{one} of the following three archive files: |
---|
18 | |
---|
19 | @table @code |
---|
20 | @item Singular-@value{VERSION}-Compact. exe |
---|
21 | Minimal archive to download. Installs Singular and minimal set of needed |
---|
22 | tools/DLLs. |
---|
23 | @item Singular-@value{VERSION}-Typical. exe |
---|
24 | Typical archive to download. Installs Singular and the XEmacs editor to |
---|
25 | run ESingular. |
---|
26 | @item Singular-@value{VERSION}-Custom. exe |
---|
27 | Maximal archive to download. Installs Singular, XEmacs, and many Cygwin |
---|
28 | development tools (like gcc, gdb, make, perl, etc). |
---|
29 | @end table |
---|
30 | |
---|
31 | You can obtain these (and other) archives from |
---|
32 | @display |
---|
33 | @uref{ftp://www.mathematik.uni-kl.de/pub/Math/Singular/Development}. |
---|
34 | @end display |
---|
35 | |
---|
36 | @ifclear singularmanual |
---|
37 | @strong{Important:} Please see |
---|
38 | @ifhtml |
---|
39 | @uref{COPYING.html, COPYING} |
---|
40 | @end ifhtml |
---|
41 | @ifnothtml |
---|
42 | the file COPYING contained in the distribution |
---|
43 | @end ifnothtml |
---|
44 | for license |
---|
45 | information on @sc{Singular}. In particular, notice that we only grant you |
---|
46 | permission to use @sc{Singular} if you have registered yourself as a |
---|
47 | @sc{Singular} user by sending email to @email{singular@@mathematik.uni-kl.de} |
---|
48 | with the subject line (or, mail body) @code{register}. |
---|
49 | @end ifclear |
---|
50 | |
---|
51 | @heading To install SINGULAR |
---|
52 | |
---|
53 | @enumerate |
---|
54 | @item |
---|
55 | If you have Cygwin B19 or B20 installed on your |
---|
56 | system, then uninstall it. Especially make sure that you delete the |
---|
57 | @code{/} and @code{/bin} mount points (i.e., execute the commands @code{umount |
---|
58 | /} and @code{umount /bin} before deleting the installed Cygwin |
---|
59 | programs). |
---|
60 | @item |
---|
61 | If you have Cygwin version 1.0 or higher installed on your system, you |
---|
62 | should either delete it, or, do not install the Cygwin component contained |
---|
63 | in the @sc{Singular} installation archives. |
---|
64 | @item |
---|
65 | If you are running Windows NT/2000, make sure that you are logged on as |
---|
66 | @code{Administrator}. |
---|
67 | @item |
---|
68 | Execute the self-extracting archive (e.g., double-click on it) and |
---|
69 | @strong{carefully} follow the instructions given there. |
---|
70 | @item |
---|
71 | When asked for the installation folder, you should simply choose a drive |
---|
72 | (you may choose a subfolder, but this is not as convenient as a drive). |
---|
73 | @strong{Important:} If you have Cygwin already installed on your system, |
---|
74 | make sure that the folder you choose is mounted to the root of your |
---|
75 | (Cygwin) file system. |
---|
76 | @* Among others, the folowing subfolders will be created: |
---|
77 | @itemize @code |
---|
78 | @item bin |
---|
79 | contains the basic cygwin DLLs and tools |
---|
80 | @item etc |
---|
81 | contains miscellanous configuration and documentation file (like a FAQ |
---|
82 | and README file) |
---|
83 | @item tmp |
---|
84 | for temporary files |
---|
85 | @item usr |
---|
86 | contains subfolders which contain the @sc{Singular} and XEmacs program and |
---|
87 | documentation. |
---|
88 | @end itemize |
---|
89 | @item |
---|
90 | When asked for the Setup Type, choose @code{Typical}, unless you know |
---|
91 | what you are doing. |
---|
92 | @* If you choose @code{Compact}, the XEmacs editor is |
---|
93 | excluded from the installation. |
---|
94 | @* If you choose @code{Custom}, make sure that you do @emph{not} |
---|
95 | de-select the @code{BasicCygwin} component, unless you already have |
---|
96 | Cygwin version 1.0 (or higher) installed on your system. |
---|
97 | @* If you have the @emph{Cygwin} port of XEmacs version 21.1.10 (or higher) |
---|
98 | already installed on your system, you can safely de-selct the |
---|
99 | @code{XEmacs} component. All other version of Emacs (resp. XEmacs) have |
---|
100 | some quirks and do not work right together with @sc{Singular} (i.e., |
---|
101 | running @code{Esingular} results in problems). |
---|
102 | @* You only should install the @code{AdditionalCygwin} component, if you |
---|
103 | plan on doing some software-develpment with cygwin. This component |
---|
104 | contains, among others, the gcc compiler, gdb debugger, a cygwin port of |
---|
105 | perl, the cvs version control system, and many other |
---|
106 | software-development tools and libraries (you basically get what we use |
---|
107 | as our environment for building @sc{Singular}). |
---|
108 | @item |
---|
109 | At the end, you @emph{should} reboot your computer. Otherwise, some |
---|
110 | @end enumerate |
---|
111 | |
---|
112 | @heading Uninstalling Singular |
---|
113 | |
---|
114 | @heading Troubleshooting |
---|
115 | |
---|
116 | @itemize @bullet |
---|
117 | @item For any other troubles: |
---|
118 | @*Please send an email to @email{singular@@mathematik.uni-kl.de} |
---|
119 | and include the header which is displayed by starting up @sc{Singular} |
---|
120 | with the @code{-v} option, and a description of your machine (issue the |
---|
121 | command @code{uname -a} on your shell) in your report. |
---|
122 | @end itemize |
---|
123 | |
---|
124 | |
---|
125 | @heading More information about @sc{Singular}: Comments, Questions, Bug Reports |
---|
126 | More and up-to-date information about @sc{Singular} is always available |
---|
127 | from |
---|
128 | @display |
---|
129 | @uref{http://www.singular.uni-kl.de}. |
---|
130 | @end display |
---|
131 | We very much welcome any comments, questions, and bug reports. Please |
---|
132 | contact us at |
---|
133 | @display |
---|
134 | @email{singular@@mathematik.uni-kl.de}. |
---|
135 | @end display |
---|
136 | |
---|
137 | @ifclear singularmanual |
---|
138 | GOOD LUCK and ENJOY! |
---|
139 | Your @sc{Singular} team. |
---|
140 | @end ifclear |
---|
141 | |
---|