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--share.tar.gz -- contains architecture-independent data like documentation or libraries Singular--.tar.gz -- contains architecture dependent executables, like the Singular program where is the version number of Singular (e.g., 1.2.0) and 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--share.tar.gz .tar.gz | tar -pxf - gzip -dc Singular-- | 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: .//bin/Singular- executable(s) ./info/singular.hlp info file ./Singular/LIB// Singular libraries ./Singular/doc// documentation (ps, dvi, info) ./Singular/html// 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`.//bin/Singular- /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-.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-.tar.gz | tar -pxf - This adds .//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- 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---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.