source: git/INSTALL.win @ 2afef4

                         Singular version 1.2
                     University of Kaiserslautern
     Department of Mathematics   Centre for Computer Algebra
          Authors: G.-M. Greuel, G. Pfister, H. Schoenemann
                  (C) 1986-1998 All Rights Reserved

             WINDOWS 95/NT INSTALLATION INSTRUCTIONS FOR SINGULAR
             =====================================================

TBC 

To install Singular on a Unix platform, you need at least the
following two files: 

Singular-<x.y.z>-share.tar.gz 
   -- contains architecture-independent data like documentation or libraries

Singular-<x.y.z>-<uname description>.tar.gz
   -- contains architecture dependent executables, like the Singular program

where <x.y.z> is the version number of Singular (e.g., 1.2.0) and 
<uname description> is a description of the processor and operating
system for which Singular is compiled (e.g, ix86-Linux). 
You can obtain these files from  
ftp://www.mathematik.uni-kl.de/pub/Math/Singular/.

TO INSTALL SINGULAR
===================
Simply cd to the directory in which you wish to install SINGULAR,
and then unpack the architecture independent tar file, followed by
the architecture-dependent files for those architectures you use.

  cd /usr/local/        # or wherever you install 3rd-party software
  gzip -dc Singular-<x.y.z>-share.tar.gz .tar.gz | tar -pxf -
  gzip -dc Singular-<x.y.z>-<uname description> | tar -pxf -

Replace `/usr/local/' with what you like, but it probably ought not
have `Singular' or a version number in it - that directory is expected
to be the common prefix for installed software, and Singular-specific
subdirectories of it will be created.  The directories are arranged
in such a way that multiple versions of Singular can peaceably coexist
under the same `/usr/local/' tree.

After unpacking, you will have a directory structure like:

  ./<uname description>/bin/Singular-<x.y.z>    executable(s)
  ./info/singular.hlp                           info file
  ./Singular/LIB/<x.y.z>/                       Singular libraries
  ./Singular/doc/<x.y.z>/                       documentation (ps, dvi, info)
  ./Singular/html/<x.y.z>/                      documentation (html)


For the executable to work, the directory layout must look pretty much
like this; the executable looks for "sibling" directories at run-time
to figure out where its Singular libraries and on-line info
documentation are.  These constraints on the local directory layout
are necessary to avoid having to hardcode pathnames into the
executables, or require that environment variables be set before
running the executable. In particular, you should not move or copy
the Singular executables to another place, but use soft-links
instead. For example, to install Singular on your system, use
something like:
 ln -s `pwd`./<uname description>/bin/Singular-<x.y.z> /usr/local/bin/Singular


TO INSTALL THE ON-LINE DOCUMENTATION
=====================================
Singular needs the `info' program for its on-line documentation. If
you do not have the `info' program installed on your system, you may
obtain it from
ftp://www.mathematik.uni-kl.de/pub/Math/Singular/utils/
by downloading the respective info-<uname description>.tar.gz file.

To install, simply cd to the directory where you unpacked the other
tar files and then unpack the info tar file.

  cd /usr/local/      # i.e., wherever you have unpacked Singular tar files
  gzip -dc info-<uname description>.tar.gz | tar -pxf -

This adds
  ./<uname description>/bin/info                info program
to the above directory structure and ensures that the `info' program
is found at run-time.


TROUBLES
=========

* For HPUX systems: 
  The /etc/termcap files which are pre-installed on these systems are
  broken which leads to messages like

   Name collision between 9826 9836

  when Singular is started. To fix this, you can get fixed termcap
  files from 
  ftp://www.mathematik.uni-kl.de/pub/Math/Singular/utils
  by downloading the files termcap-<uname-description> and either
  replace your /etc/termcap file by the file found there, or view, and 
  redo the respective changes by diff'ing the downloaded and the
  original file.

* For Linux systems:
  Due to some incompatibilities of shared libraries, the start-up of
  Singular might fail with messages like 
    
   Can not find shared library ....

  To fix this, download and install
   
   Singular-<x.y.z>-<uname description>-static.tar.gz 
 
  which contains statically linked executables.

* For AIX systems:
  The default 'info' program of the system is not GNU's hypertext
  system which we need to display the on-line documentation. Therefore,
  the distribution of the AIX executable already contains the 'info'
  program we need. If you remove this program, make sure that the GNU
  info program is executed if you call 'info' from your shell.

* For any other troubles, please send mail to
   singular@mathematik.uni-kl.de

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

More and up-to-date information about Singular is always available
from 
           http://www.mathematik.uni-kl.de/~zca/Singular
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.