     [file version.texi not included]

Troubleshooting for Singular on MS Windows.
*******************************************

On startup, the DLL cygwin1.dll can not be found.

       * Make sure that (1) the BasicCygwin component was not de-selected during a custom installation; (2) the destination folder chosen during the installation does not contain folder names which are longer than 8 characters, or contain spaces or periods; (3) the installation did not generate any error messages; and (4) you have rebooted your machine after a successful installation (Win95/98 only).

       * Make sure the DLL cygwin1.dll is installed on your system: Say, C:\ is the folder which you have chosen as the destination folder during the installation, then the  cygwin1.dll should be located at  C:\bin\cygwin1.dll.

       * If the problem pertains, please try to localize the source of the problem as explained below, and, in any event, please send an email to  singular@mathematik.uni-kl-de with a description of your problem.

       * Make sure the directories C:\bin and C:\usr\local\bin(if you have chosen another destination folder, substitute C: by this folder) are contained in your PATH environment variable. To check this, open an MS-DOS shell and type in PATH. If these directories are not contained in the listings of directories of the PATH variable, set them as follows and then (on Win95/98) restart your computer :

          On Windows 95/98, add the following line to your AUTOEXEC.BAT file:

               SET PATH=C:\BIN;%PATH%;C:\USR\LOCAL\BIN

          On Windows NT/2000 add a similar statements in your Environment control panel.

       * Make sure your chosen destination folder is correctly mounted to the root of your (Cygwin) file system: Open an MS-DOS shell, cd (change directory) to your chosen destination folder, and type in

               mount

          This should produce an output which looks like:

               Device              Directory           Type         Flags
               C:                  /                   system       textmode

          If not, make sure that the mount.exe command is contained in this directory, and then type at the MS-DOS prompt:

               mount -s -f -t C:\ /

During the installation, an error is displayed complaining that an environment variable can not be set.
     Repeat the installation, and make sure that:

     On Windows 95/98, the file C:\AUTOEXEC.BAT is not hidden and not write-protected.

     On Windows NT/2K, you are logged on either as user Administrator or as a user with the Administrator rights during the installation.


On start-up of ESingular, the xemacs editor can not be found.

     Make sure that (1) the folder C:\usr\local\bin is contained in your PATH (see above for details) and (2) that the file C:\usr\local\bin\xemacs exists (as above, substitute C:\ by the destination folder chosen during the installation).

     Open a Bash shell and type in /usr/local/bin/xemacs. If this fails, make sure your root is correctly mounted (see above).


On a Laptop which is not connected to the network, Xemacs hangs.
     Remove your network card and restart Xemacs.


What help systems are available for SINGULAR?

     There are following help files in Your_Singular_Directory\usr\local\Singular\VERSION:

      \info\singular.hlp - Singular Manual in texinfo format,

      \html\Manual.hlp - Singular Manual in Windows Help format,

      \html\*.htm (in the Typical and Custom setup components) - Singular Manual in HTML format.

      You can tell Singular which help to use either from command-line (e.g. system("--browser","winhlp")) or add this command to the file \LIB\.singularrc.


There are Singular.exe, TSingular.exe and ESingular.exe files. What is the difference between them?

     The most important executables in ..\usr\local\Singular\VERSION\ix86-Win are :

      runESingular.exe - Singular inside the Xemacs editor (appears only if XEmacs is installed),

      runTSingular.exe - Singular inside the Cygwin xterm application,

      Singular.exe - could be run from the command line either in a Bash shell, or in a DOS window. For the reason of convenience a file Singular-VERSION.exe is just a link to Singular.exe.


How do I cut and paste with the mouse?

     First of all, we remind what we call Unix-like cut and paste with the mouse : marking a region while pressing a left button copies it to a buffer, click on a middle-button pastes current buffer to the current cursor position.

      TSingular and ESingular - under xterm and Xemacs, cut and paste works like under Unix

      Singular.exe from a Bash shell - you can copy and paste a region selected with the mouse using the CTRL-Insert (for copying) and CTRL-Shift (for paste) keys.

      Singular.exe from a DOS window - under Windows NT/2K, you can configure the shortcut calling the Singular to work in the following manner: marking the region with a left-button, pressing Enter, and then right mouse button to paste. To enable this non-default feature, right-click on the Singular shortcut on your desktop, check Properties, click on tab Options, where check the "Quick-Edit Mode" and "Insert (Exclusive) Mode" boxes and apply changes. On Windows 95/98, this unfortunately doesn't work properly.


How to uninstall Singular-2-0-0 manually?

     Appears on  : all Windows family OS

     Solution : The installation of Singular-2-0-0 for Windows consists of the three following components:

     (C1) Essential files ( in e.g. C:\Program Files\Singular)

     (C2) Shortcuts in Start Menu and on the Desktop

     (C3) Registry entries (WinNT, Win2K) or Autoexec.bat entries (Win9X)

     To uninstall it, do the following :

     (C1) Could be removed directly using the Explorer

     (C2) To delete the shortcuts: right click on the Start button, select Open - All Users. Then you go to  the Program Files folder and you'll see the Singular 2.0 folder there, which is to be deleted. The shortcuts on the Desktop could be removed directly using the Explorer.

     (C3) For Win9X users : open the file Autoexec.bat For WinNT and Win2K users : click  Start->Settings->Control Panel->System->Environment.

     For all OS: Just remove the line HOME=... if it corresponds to Singular-2-0-0 (i.e. if it looks like HOME=C:\Program Files\Singular\home\Singular). You can leave the PATH variable as it is, but if you want to clean it anyway, try to figure out paths in it, which look like C:\Program Files\Singular\;C:\Program Files\Singular\bin; C:\Program Files\Singular\usr\local\bin. Here "C:\Program Files\Singular" indicates the default directory where Singular could be installed. But don't delete the string Path itself!


Question : How to configure Singular-2-0-0 for use by many users on the WinNT or Win2K?

     OS applied : WinNT, Win2K.

     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_ variable HOME, which overruns the system one for the current user.

     Assume you have Singular-2-0-0 installed in the C:\Program Files\Singular directory and your user is named NewUser.

     1) Create the directory, say, C:\Program Files\Singular\home\NewUser

     2) Copy and edit the files .profile and .bashrc to this directory from the C:\Program Files\Singular\home\Singular.

     3) Set _User_ variable HOME to 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.

     4) Apply changes

     The Singular-specific global settings for all the users you can add to the .singularrc file, which you can find in C:\Program Files\Singular\usr\local\Singular\2-0-0\LIB. See more info on .singularrc in the manual.

For any other troubles, please visit the Singular Forum at http://www.singular.uni-kl.de/forum or send an email to singular@mathematik.uni-kl.de and include the header which is displayed by starting up SINGULAR with the -v option, and a description of your machine and operating system.

More information about SINGULAR: Comments, Questions, Bug Reports
=================================================================

More and up-to-date information about SINGULAR is always available from

     http://www.singular.uni-kl.de.

We very much welcome any comments, questions, and bug reports. Please contact us at

     singular@mathematik.uni-kl.de.

GOOD LUCK and ENJOY! Your SINGULAR team.