|
C.3 Unix installation instructions
Unix installation instructions for SINGULAR::PLURAL version 2-1-99
To install SINGULAR::PLURAL on a
Unix
platform, you need the following two
archives:
SingularPlural-2-1-99-share.tar.gz
- contains architecture independent data like documentation and libraries
(alternatively, you may also download
SingularPlural-2-1-99-share.zip ).
SingularPlural-2-1-99-<uname>.tar.gz
- contains architecture dependent executables, like the SINGULAR::PLURAL
program.
<uname> is a description of the processor and operating system
for which SINGULAR::PLURAL is compiled (e.g, ix86-Linux ). Please contact us if
you can not find an appropriate architecture dependent archive.
You can obtain these (and other) archives from
Important: Please see
COPYING
for license information on SINGULAR. Please register yourself as a
SINGULAR user by using the registration form on the SINGULAR
homepage http://www.singular.uni-kl.de.
If for some reason you cannot access the registration form, you can also
register by sending an email to singular@mathematik.uni-kl.de
with subject line register and body containing the following data:
your name, email address, organisation, country and platform(s).
To install SINGULAR
Make sure that you have approximately 12MByte of free disk space and follow
these steps.
-
Simply change to the directory in which you wish to install
SINGULAR (usually wherever you install 3rd-party software), for example:
| cd /usr/local
or
mkdir install;cd install
(you do not need root privileges in this case)
|
SINGULAR::PLURAL specific subdirectories will be created in such a way
that multiple versions and multiple architecture dependent files
of SINGULAR can peaceably coexist under the same /usr/local
tree.
-
Unpack the archives:
| gzip -dc <path_to>/SingularPlural-2-1-99-<uname>.tar.gz | tar -pxf -
gzip -dc <path_to>/SingularPlural-2-1-99-share.tar.gz | tar -pxf -
|
This creates the the directory Plural/2-1-99 with
(sub)directories |
which contain
|
<uname> |
Plural and EPlural executables
|
LIB |
SINGULAR::PLURAL libraries (*.lib files)
|
emacs |
files for the SINGULAR::PLURAL Emacs user interface
|
info |
info files of SINGULAR::PLURAL manual
|
html |
html files of SINGULAR::PLURAL manual
|
doc |
miscellaneous documentation files
|
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::PLURAL libraries and on-line
documentation files are. These constraints on the local directory layout
are necessary to avoid having to hard-code pathnames into the
executables, or require that environment variables be set before
running the executable. In particular, you must not move or copy
the SINGULAR::PLURAL executables to another place, but use soft-links
instead.
The following steps are optional:
-
Arrange that typing
Plural at the shell prompt starts up the
installed SINGULAR::PLURAL executable.
If you have root permission, do:
| ln -s `pwd`/Plural/2-1-99/<uname>/Plural /usr/local/bin/Plural-2-1-99
ln -s `pwd`/Plural/2-1-99/<uname>/EPlural /usr/local/bin/EPlural-2-1-99
ln -s /usr/local/bin/Plural-2-1-99 /usr/local/bin/Plural
ln -s /usr/local/bin/EPlural-2-1-99 /usr/local/bin/EPlural
|
Otherwise, append the directory
`pwd`/Plural/2-1-99/<uname>/ to your $PATH
environment variable. For the csh (or, tcsh ) shell do:
| set path=(`pwd`/Plural/2-1-99/<uname> $path)
| For the bash (or, ksh ) shell do:
| export PATH=`pwd`/Plural/2-1-99/<uname>/:$PATH
|
You also might want to adjust your personal start-up files
(~/.cshrc for csh , ~/.tcshrc for tcsh , or
~/.profile for bash ) accordingly,
so that the $PATH variable is set automatically each time you login.
IMPORTANT: Do never move or copy the file
Plural/2-1-99/<uname>/Plural to another
place, but use soft-links instead.
-
If you wish to use any of following features of
SINGULAR::PLURAL, make sure that the respective programs are installed on your system:
Feature | Requires |
running EPlural , or Plural within Emacs |
Emacs version
20 or higher, or, XEmacs version 20.3 or
higher (EPlural is only included in the Linux distribution,
on other Unix platforms you can download the
Singular emacs lisp files but we give no warranties for specific platforms).
|
on-line html help |
netscape browser
|
on-line info help |
info, or
tkinfo texinfo browser programs
|
TAB completion and history mechanism of ASCII-terminal interface |
shared readline
library, i.e. /usr/lib/libreadline.so
|
visualization of curves and surfaces |
surf
version 0.9 or higher (only available for Linux and Solaris).
|
You may download most of these programs from
- Customize the on-line help system:
By default, on-line help is displayed in the html format using
the netscape program.
However, this behavior can be customized in several ways
using the SINGULAR::PLURAL commands system("--browser",<browser>)
and system("--allow-net", 1) (or, by starting up SINGULAR
with the respective command line options).
In particular, creating the file
Plural/2-1-99/LIB/.singularrc and putting the
SINGULAR::PLURAL command
| system("--allow-net", 1);
| in it, allows the on-line help system to fetch its html pages
from Singular's WWW
home site
in case its local html pages are not found. That is, you may delete your
local html pages, after setting this option.
See also
the sections The online help system, Command line options, and
Startup sequence in the SINGULAR manual
for more details on customizing the on-line help system.
-
Add the line
| * Plural:(plural.hlp). A system for noncommutative polynomial computations
| to your system-wide dir file (usually /usr/info/dir or
/usr/local/info/dir and copy or soft-link the file
Plural/2-1-99/info/plural.hlp
to the directory of your dir file.
This assures that the
SINGULAR::PLURAL manual can be accessed from stand-alone texinfo
browser programs such as info or Emacs .
(It is not necessary for the use of the help system from within Plural .)
Troubleshooting
More information about SINGULAR: Comments, Questions, Bug Reports
More and up-to-date information about SINGULAR is always available
from
We very much welcome any comments, questions, and bug reports. Please
contact us at
GOOD LUCK and ENJOY!
Your SINGULAR::PLURAL team.
|