1 | @comment -*-texinfo-*- |
---|
2 | @comment $Id: TROUBLESHOOTING_win.texi,v 1.2 2001-08-27 14:40:04 Singular 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 Troubleshooting for Singular on MS Windows. |
---|
14 | @end ifclear |
---|
15 | |
---|
16 | @table @strong |
---|
17 | @item On startup, the DLL @code{cygwin1.dll} can not be found. |
---|
18 | @itemize |
---|
19 | @item |
---|
20 | Make sure that (1) the @code{BasicCygwin} component was not de-selected |
---|
21 | during a custom installation; (2) the destination folder chosen during |
---|
22 | the installation does not contain folder names which are longer than 8 |
---|
23 | characters, or contain spaces or periods; (3) the installation did not |
---|
24 | generate any error messages; and (4) you have rebooted your machine after a |
---|
25 | successful installation (Win95/98 only). |
---|
26 | @item |
---|
27 | Make sure the DLL @code{cygwin1.dll} is installed on your |
---|
28 | system: Say, @code{C:\} is the folder which you have chosen as the |
---|
29 | destination folder during the installation, then the @code{cygwin1.dll} |
---|
30 | should be located at @code{C:\bin\cygwin1.dll}. |
---|
31 | @item |
---|
32 | If the problem pertains, please try to localize the source of the |
---|
33 | problem as explained below, and, in any event, @emph{please send} an email |
---|
34 | to @email{singular@@mathematik.uni-kl-de} with a description of your problem. |
---|
35 | @item |
---|
36 | Make sure the directories @code{C:\bin} and @code{C:\usr\local\bin}(if |
---|
37 | you have chosen another destination folder, substitute @code{C:} by |
---|
38 | this folder) are contained in your @code{PATH} environment variable. To |
---|
39 | check this, open an MS-DOS shell and type in @code{PATH}. If these |
---|
40 | directories are not contained in the listings of directories of the |
---|
41 | @code{PATH} variable, set them as follows and then (on Win95/98) |
---|
42 | @emph{restart} your computer : |
---|
43 | @*On Windows 95/98, add the following line to your @code{AUTOEXEC.BAT} |
---|
44 | file: |
---|
45 | @example |
---|
46 | SET PATH=C:\BIN;%PATH%;C:\USR\LOCAL\BIN |
---|
47 | @end example |
---|
48 | On Windows NT/2000 add a similar statements in your @code{Environment} |
---|
49 | control panel. |
---|
50 | |
---|
51 | |
---|
52 | @item |
---|
53 | Make sure your chosen destination folder is correctly mounted to the |
---|
54 | root of your (Cygwin) file system: Open an MS-DOS shell, @code{cd} |
---|
55 | (change directory) to your chosen destination folder, and type in |
---|
56 | @example |
---|
57 | mount |
---|
58 | @end example |
---|
59 | This should produce an output which looks like: |
---|
60 | @example |
---|
61 | Device Directory Type Flags |
---|
62 | C: / system textmode |
---|
63 | @end example |
---|
64 | If not, make sure that the @code{mount.exe} command is contained in this |
---|
65 | directory, and then type at the MS-DOS prompt: |
---|
66 | @example |
---|
67 | mount -s -f -t C:\ / |
---|
68 | @end example |
---|
69 | @end itemize |
---|
70 | |
---|
71 | |
---|
72 | @item During the installation, an error is displayed complaining that an environment variable can not be set. |
---|
73 | Repeat the installation, and make sure that: |
---|
74 | @*On Windows 95/98, the file @code{C:\AUTOEXEC.BAT} is not |
---|
75 | hidden and not write-protected. |
---|
76 | @*On Windows NT/2K, you are logged on either as user |
---|
77 | @code{Administrator} or as a user with the Administrator rights during the installation. |
---|
78 | |
---|
79 | @item @*On start-up of @code{ESingular}, the @code{xemacs} editor can not be found. |
---|
80 | @*Make sure that (1) the folder @code{C:\usr\local\bin} is contained in your |
---|
81 | @code{PATH} (see above for details) and (2) that the file |
---|
82 | @code{C:\usr\local\bin\xemacs} exists (as above, substitute @code{C:\} |
---|
83 | by the destination folder chosen during the installation). |
---|
84 | @*Open a Bash shell and type in @code{/usr/local/bin/xemacs}. |
---|
85 | If this fails, make sure your root is correctly mounted (see above). |
---|
86 | |
---|
87 | @item @*On a Laptop which is not connected to the network, Xemacs hangs. |
---|
88 | Remove your network card and restart Xemacs. |
---|
89 | |
---|
90 | @item @*What help systems are available for @sc{Singular}? |
---|
91 | @*There are following help files in @code{Your_Singular_Directory\usr\local\Singular\@value{VERSION}}: |
---|
92 | @* @code{\info\singular.hlp} - Singular Manual in texinfo format, |
---|
93 | @* @code{\html\Manual.hlp} - Singular Manual in Windows Help format, |
---|
94 | @* @code{\html\*.htm} (in the Typical and Custom setup components) - Singular Manual in HTML format. |
---|
95 | @* You can tell Singular which help to use either from command-line (e.g. @code{system("--browser","winhlp")}) |
---|
96 | or add this command to the file @code{\LIB\.singularrc}. |
---|
97 | |
---|
98 | |
---|
99 | @item @*There are @code{Singular.exe}, @code{TSingular.exe} and @code{ESingular.exe} files. What is the difference between them? |
---|
100 | @*The most important executables in @code{..\usr\local\Singular\@value{VERSION}\ix86-Win} are : |
---|
101 | @* @code{runESingular.exe} - Singular inside the Xemacs editor (appears only if XEmacs is installed), |
---|
102 | @* @code{runTSingular.exe} - Singular inside the Cygwin xterm application, |
---|
103 | @* @code{Singular.exe} - could be run from the command line either in a Bash shell, or in a DOS window. |
---|
104 | For the reason of convenience a file @code{Singular-@value{VERSION}.exe} is just a link to @code{Singular.exe}. |
---|
105 | |
---|
106 | @item @*How do I cut and paste with the mouse? |
---|
107 | @*First of all, we remind what we call Unix-like cut and paste with the mouse : marking a region while |
---|
108 | pressing a left button copies it to a buffer, click on a middle-button pastes current buffer to |
---|
109 | the current cursor position. |
---|
110 | @* @code{TSingular} and @code{ESingular} - under xterm and Xemacs, cut and paste works like under Unix |
---|
111 | @* @code{Singular.exe} from a Bash shell - you can copy and paste a region selected with the |
---|
112 | mouse using the @code{CTRL-Insert} (for copying) and @code{CTRL-Shift} (for paste) keys. |
---|
113 | @* @code{Singular.exe} from a DOS window - under Windows NT/2K, you can configure the shortcut |
---|
114 | calling the Singular to work in the following manner: marking the region with a left-button, |
---|
115 | pressing @code{Enter}, and then right mouse button to paste. |
---|
116 | To enable this non-default feature, right-click on the Singular shortcut |
---|
117 | on your desktop, check Properties, click on tab Options, |
---|
118 | where check the "Quick-Edit Mode" and "Insert (Exclusive) Mode" boxes and apply changes. |
---|
119 | On Windows 95/98, this unfortunately doesn't work properly. |
---|
120 | |
---|
121 | @item @*How to uninstall Singular-2-0-0 manually? |
---|
122 | @*Appears on : all Windows family OS |
---|
123 | @*Solution : The installation of Singular-2-0-0 for Windows consists of the three following components: |
---|
124 | @*(C1) Essential files ( in e.g. @code{C:\Program Files\Singular}) |
---|
125 | @*(C2) Shortcuts in Start Menu and on the Desktop |
---|
126 | @*(C3) Registry entries (WinNT, Win2K) or Autoexec.bat entries (Win9X) |
---|
127 | |
---|
128 | @*To uninstall it, do the following : |
---|
129 | |
---|
130 | @*(C1) Could be removed directly using the Explorer |
---|
131 | @*(C2) To delete the shortcuts: right click on the Start button, select |
---|
132 | Open - All Users. Then you go to the Program Files folder and you'll see |
---|
133 | the Singular 2.0 folder there, which is to be deleted. The shortcuts on the Desktop |
---|
134 | could be removed directly using the Explorer. |
---|
135 | @*(C3) For Win9X users : open the file Autoexec.bat |
---|
136 | For WinNT and Win2K users : click Start->Settings->Control Panel->System->Environment. |
---|
137 | |
---|
138 | @*For all OS: |
---|
139 | Just remove the line HOME=... if it corresponds to Singular-2-0-0 (i.e. if it looks like @code{HOME=C:\Program Files\Singular\home\Singular}). |
---|
140 | You can leave the PATH variable as it is, |
---|
141 | but if you want to clean it anyway, try to figure out paths in it, which look like |
---|
142 | @code{C:\Program Files\Singular\;C:\Program Files\Singular\bin; C:\Program Files\Singular\usr\local\bin}. Here "C:\Program Files\Singular" indicates the default |
---|
143 | directory where Singular could be installed. |
---|
144 | But don't delete the string Path itself! |
---|
145 | |
---|
146 | @item @*Question : How to configure Singular-2-0-0 for use by many users on the WinNT or Win2K? |
---|
147 | @*OS applied : WinNT, Win2K. |
---|
148 | @*Answer : You are installing Singular-2-0-0 with the administrator rights, the _System_ variables Path and HOME are set by default. There exist also a _User_ |
---|
149 | variable HOME, which overruns the system one for the current user. |
---|
150 | |
---|
151 | @*Assume you have Singular-2-0-0 installed in the @code{C:\Program Files\Singular} directory and your user is named @code{NewUser}. |
---|
152 | |
---|
153 | @*1) Create the directory, say, @code{C:\Program Files\Singular\home\NewUser} |
---|
154 | @*2) Copy and edit the files .profile and .bashrc to this directory from the |
---|
155 | @code{C:\Program Files\Singular\home\Singular}. |
---|
156 | @*3) Set _User_ variable HOME to @code{C:\Program Files\Singular\home\NewUser} by clicking and editing Start->Settings->Control Panel->System->Environment. User variables are listed in the respective subwindow below. |
---|
157 | @*4) Apply changes |
---|
158 | |
---|
159 | The Singular-specific global settings for all the users you can add to the .singularrc file, which you can find in @code{C:\Program Files\Singular\usr\local\Singular\2-0-0\LIB}. |
---|
160 | See more info on .singularrc in the manual. |
---|
161 | |
---|
162 | @end table |
---|
163 | |
---|
164 | For any other troubles, please visit the @strong{Singular Forum} |
---|
165 | at @uref{http://www.singular.uni-kl.de/forum} or |
---|
166 | send an email to @email{singular@@mathematik.uni-kl.de} |
---|
167 | and include the header which is displayed by starting up @sc{Singular} |
---|
168 | with the @code{-v} option, and a description of your machine and |
---|
169 | operating system. |
---|
170 | |
---|
171 | |
---|
172 | @ifclear singularmanual |
---|
173 | @heading More information about @sc{Singular}: Comments, Questions, Bug Reports |
---|
174 | More and up-to-date information about @sc{Singular} is always available |
---|
175 | from |
---|
176 | @display |
---|
177 | @uref{http://www.singular.uni-kl.de}. |
---|
178 | @end display |
---|
179 | We very much welcome any comments, questions, and bug reports. Please |
---|
180 | contact us at |
---|
181 | @display |
---|
182 | @email{singular@@mathematik.uni-kl.de}. |
---|
183 | @end display |
---|
184 | |
---|
185 | GOOD LUCK and ENJOY! |
---|
186 | Your @sc{Singular} team. |
---|
187 | @end ifclear |
---|
188 | |
---|