source: git/doc/TROUBLESHOOTING_win.texi @ f83eff

spielwiese
Last change on this file since f83eff was 3de58c, checked in by Hans Schönemann <hannes@…>, 23 years ago
*hannes: merge-2-0-2 git-svn-id: file:///usr/local/Singular/svn/trunk@5618 2c84dea3-7e68-4137-9b89-c4e89433aadc
  • Property mode set to 100644
File size: 9.1 KB
Line 
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
20Make sure that (1) the @code{BasicCygwin} component was not de-selected
21during a custom installation; (2) the destination folder chosen during
22the installation does not contain folder names which are longer than 8
23characters, or contain spaces or periods; (3) the installation did not
24generate any error messages; and (4) you have rebooted your machine after a
25successful installation (Win95/98 only).
26@item
27Make sure the DLL @code{cygwin1.dll} is installed on your
28system: Say, @code{C:\} is the folder which you have chosen as the
29destination folder during the installation, then the  @code{cygwin1.dll}
30should be located at  @code{C:\bin\cygwin1.dll}.
31@item
32If the problem pertains, please try to localize the source of the
33problem as explained below, and, in any event, @emph{please send} an email
34to  @email{singular@@mathematik.uni-kl-de} with a description of your problem.
35@item
36Make sure the directories @code{C:\bin} and @code{C:\usr\local\bin}(if
37you have chosen another destination folder, substitute @code{C:} by
38this folder) are contained in your @code{PATH} environment variable. To
39check this, open an MS-DOS shell and type in @code{PATH}. If these
40directories 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}
44file:
45@example
46SET PATH=C:\BIN;%PATH%;C:\USR\LOCAL\BIN
47@end example
48On Windows NT/2000 add a similar statements in your @code{Environment}
49control panel.
50
51
52@item
53Make sure your chosen destination folder is correctly mounted to the
54root 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
57mount
58@end example
59This should produce an output which looks like:
60@example
61Device              Directory           Type         Flags
62C:                  /                   system       textmode
63@end example
64If not, make sure that the @code{mount.exe} command is contained in this
65directory, and then type at the MS-DOS prompt:
66@example
67mount -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.
73Repeat the installation, and make sure that:
74@*On Windows 95/98, the file @code{C:\AUTOEXEC.BAT} is not
75hidden 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:\}
83by the destination folder chosen during the installation).
84@*Open a Bash shell and type in @code{/usr/local/bin/xemacs}.
85If 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.
88Remove 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")})
96or 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.
104For 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
108pressing a left button copies it to a buffer, click on a middle-button pastes current buffer to
109the 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
112mouse 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
114calling the Singular to work in the following manner: marking the region with a left-button,
115pressing @code{Enter}, and then right mouse button to paste.
116To enable this non-default feature, right-click on the Singular shortcut
117on your desktop, check Properties, click on tab Options,
118where check the "Quick-Edit Mode" and "Insert (Exclusive) Mode" boxes and apply changes.
119On 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
132Open - All Users. Then you go to  the Program Files folder and you'll see
133the Singular 2.0 folder there, which is to be deleted. The shortcuts on the Desktop
134could be removed directly using the Explorer.
135@*(C3) For Win9X users : open the file Autoexec.bat
136For WinNT and Win2K users : click  Start->Settings->Control Panel->System->Environment.
137
138@*For all OS:
139Just 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}).
140You can leave the PATH variable as it is,
141but 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
143directory where Singular could be installed.
144But 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_
149variable 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
159The 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}.
160See more info on .singularrc in the manual.
161
162@end table
163
164For any other troubles, please visit the @strong{Singular Forum}
165at @uref{http://www.singular.uni-kl.de/forum} or
166send an email to @email{singular@@mathematik.uni-kl.de}
167and include the header which is displayed by starting up @sc{Singular}
168with the @code{-v} option, and a description of your machine and
169operating system.
170
171
172@ifclear singularmanual
173@heading More information about @sc{Singular}: Comments, Questions, Bug Reports
174More and up-to-date information about @sc{Singular} is always available
175from
176@display
177@uref{http://www.singular.uni-kl.de}.
178@end display
179We very much welcome any comments, questions, and bug reports. Please
180contact us at
181@display
182@email{singular@@mathematik.uni-kl.de}.
183@end display
184
185GOOD LUCK and ENJOY!
186Your @sc{Singular} team.
187@end ifclear
188
Note: See TracBrowser for help on using the repository browser.