source: git/doc/README_download.texi @ e480544

@comment -*-texinfo-*-
@comment $Id: README_download.texi,v 1.8 2001-03-02 13:09:13 Singular Exp $
@c FILE: README_download.texi
@c PURPOSE: downloading instructions, to be includeded in manual and README_ftp
@c

@ifclear VERSION
@include version.texi
@end ifclear

@heading To download @sc{Singular} for a Unix platform

Make sure that you have approximately 12MByte of free disk space and follow
these steps.

@enumerate
@item
You need to download two (archive) files:
@table @code
@item Singular-@value{VERSION}-share.tar.gz 
contains architecture independent data like documentation and libraries
(alternatively, you may also download 
@code{Singular-@value{VERSION}-share.zip}).
@item Singular-@value{VERSION}-<uname>.tar.gz
contains architecture dependent executables, like the @sc{Singular}
program.
@end table
@code{<uname>} is a description of the processor and operating
system for which @sc{Singular} is compiled. Choose one of the following:
@multitable @columnfractions .2 .8
@item @code{ix86-Linux}
@tab PC's running under Linux with @code{libc} version 6 (e.g., for SuSe
Linux distirbution version >= 6; RedHat Linux distirbution version >= 5.2).
@item @code{ix86-Linux-libc5}
@tab PC's running under Linux with @code{libc} version 5 (if you are not 
sure which @code{libc} version you have, run @code{ldd /bin/ls}).
@item @code{ix86-Win}
@tab PC's running Windows 95/98/NT/2K which have Cygwin version 1.0 (or
higher) already installed. Unless you are familiar with Cygwin, we
recommend that you download one of the self-extracting archives as
described below.
@item @code{HPUX-9}
@tab HP workstations running under HPUX version 9
@item @code{HPUX-10}
@tab HP workstations running under HPUX version 10
@item @code{SunOS-5}
@tab Sun workstations running Solaris version 5
@end multitable
Please contact us if
you can not find an appropriate architecture dependent archive.

@item
Simply change to the directory in which you wish to install
@sc{Singular} (usually wherever you install 3rd-party software):
@smallexample
cd /usr/local/  
@end smallexample

@sc{Singular} specific subdirectories will be created in such a way
that multiple versions and multiple architecture dependent files
of @sc{Singular} can peaceably coexist under the same @code{/usr/local/}
tree.

@item
Unpack the archives:
@smallexample
gzip -dc Singular-@value{VERSION}-<uname>.tar.gz | tar -pxf -
gzip -dc Singular-@value{VERSION}-share.tar.gz | tar -pxf -
@end smallexample
If you have downloaded @code{Singular-@value{VERSION}-share.zip},
unpack with 
@smallexample
unzip -u Singular-@value{VERSION}-share.zip
@end smallexample

@item 
After unpacking, see the created file
@code{Singular/@value{VERSION}/INSTALL} (which is also located at
@uref{ftp://www.mathematik.uni-kl.de/pub/Math/Singular/INSTALL_unix.html}
for details on how to finish the installation.
@end enumerate

@heading To download @sc{Singular} for Windows 95/98/NT/2K

@enumerate
@item
Download one of the following self-extracting archives:
@table @code
@item @uref{ftp://www.mathematik.uni-kl.de/pub/Math/Singular/Singular-@value{VERSION}-Compact.exe,Singular-@value{VERSION}-Compact.exe}
Minimal archive to download. Installs Singular and minimal set of needed
tools/DLLs.
@item @uref{ftp://www.mathematik.uni-kl.de/pub/Math/Singular/Singular-@value{VERSION}-Typical.exe,Singular-@value{VERSION}-Typical.exe}
Typical archive to download. Installs Singular and the XEmacs editor to
run ESingular.
@item @uref{ftp://www.mathematik.uni-kl.de/pub/Math/Singular/Singular-@value{VERSION}-Custom.exe,Singular-@value{VERSION}-Custom.exe}
Maximal archive to download. Installs Singular, XEmacs, and many Cygwin
development tools (like gcc, gdb, make, perl, etc).
@end table

@item 
Double-click (or, execute), the self-extracting archives, and
@strong{carefully} follow the instructions given there.

@item
In case of problems, see the created file 
@code{etc/INSTALL.txt} (which is also located at
@uref{ftp://www.mathematik.uni-kl.de/pub/Math/Singular/INSTALL_win.html}
for details on how to finish the installation.
@end enumerate

@heading To download @sc{Singular} for the Macintosh
The port of @sc{Singular} will be aviable soon.