platform.doc

@comment -*-texinfo-*-
@comment this file contains Release notes and various howto's

@c The following directives are necessary for proper compilation
@c with emacs (C-c C-e C-r).  Please keep it as it is.  Since it
@c is wrapped in `@ignore' and `@end ignore' it does not harm `tex' or
@c `makeinfo' but is a great help in editing this file (emacs
@c ignores the `@ignore').
@ignore
%**start
\input texinfo.tex
@setfilename platform.info
@node Installation and Platform Specifics
@menu
* Installation and Platform Specifics::
@end menu
@node Installation and Platform Specifics, Index, SINGULAR libraries, Top
@chapter Installation and Platform Specifics
%**end
@end ignore

@menu
* News and changes::
* Singular 3 and Singular 4::
* libSingular::
* Download instructions::
* Unix installation instructions::
* Windows installation instructions::
* Macintosh installation instructions::
@end menu

@c ----------------------------------------------------------
@node News and changes
@section News and changes
@cindex news
@cindex changes

@include NEWS.texi

@c ----------------------------------------------------------
@node Singular 3 and Singular 4
@section Singular 3 and Singular 4
@cindex Singular 3 and Singular 4

@include changes_in_singular4.texi

@c ----------------------------------------------
@node libSingular
@section libSingular
@cindex libSingular
@cindex GMP
@cindex signal handler

@code{libSingular} is the C++-library version of @sc{Singular}.@*
@code{Singular/libsingular.h} is the main include file,
@code{-lSingular} the link parameter,@*
@code{lib/pkgconfig/Singular.pc} provides all parameters in the pkconfig format.

It contains all parts of @sc{Singular} with the following exceptions:
@enumerate
@item
memory allocation functions for GMP
(see @code{mmInit} in @code{Singular/tesths.cc})
@item
signal handlers
(see @code{init_signals} in @code{Singular/cntrlc.cc}).@*
At least a handler for @code{SIGCHLD} must be installed
for the routines from @ref{parallel_lib}, @ref{modstd_lib}, @ref{modnormal_lib}, @ref{tasks_lib}.@*
If the child was started by @code{libSingular} the handler
has to call @code{sig_chld_hdl} from @code{Singular/links/ssiLink.cc}
or implement something similiar (call @code{slClose(l)} for ssi links).
@item
error handlers for factory, NTL
(see @code{init_signals} in @code{Singular/cntrlc.cc}).@*
@end enumerate
@c ----------------------------------------------------------
@node Download instructions
@section Download instructions
@cindex downloading
@cindex instructions, downloading
@cindex howto, download

@sc{Singular} is available as source and binary program for most common hard-
and software platforms.
Instructions to download and install @sc{Singular} can be found
at
@display
@uref{http://www.singular.uni-kl.de/index.php/singular-download.html}.
@end display

Release versions of @sc{Singular} are also available
from our FTP site
@display
@uref{ftp://www.mathematik.uni-kl.de/pub/Math/Singular/src/4-1-1/}.
@end display

@c @include README_download.texi

@c ----------------------------------------------------------
@node Unix installation instructions
@section Unix installation instructions
@cindex Unix installation
@cindex instructions, Unix installation
@cindex howto, install on Unix

Install binaries:
@uref{http://www.singular.uni-kl.de/index.php/singular-download/install-linuxunix.html}

or build it yourself:
@itemize
@item
Install the necessary packages:
  @itemize
  @item
  libtool
  @item
  gnu make
  @item
  gcc, g++
  @item
  libreadline
  @item
  gmp
  @item
  ntl
  @item
  libcdd
  @end itemize
@item
Install flint 2.5:
@code{./configure --with-gmp=/usr --prefix=$HOME/tmp --disable-shared}
@*@code{make && make install}
@item
Install Singular
@code{./configure --with-flint=$HOME/tmp --enable-gfanlib --prefix=$HOME/Singular4}
@*@code{make && make install}
@*(@code{$prefix/bin/Singular} is the main execuatble)
@item (optional)
install 4ti2
@item (optional)
install surf/surfer
@item (optional)
install normaliz 2.8 (or newer)
@end itemize

See also
@url{https://github.com/Singular/Sources/wiki/Step-by-Step-Installation-Instructions-for-Singular}
which includes instructions adapted for debian and fedora based systems.

@c ----------------------------------------------------------
@node Windows installation instructions
@section Windows installation instructions
@cindex Windows installation
@cindex instructions, Windows installation
@cindex howto, install on Windows

Singular relies on Cygwin as its environment under Windows.
There is a 32bit and a 64bit version of Cygwin.

@url{http://www.singular.uni-kl.de/index.php/singular-download/install-windows.html}

@c ----------------------------------------------------------
@node Macintosh installation instructions
@section Macintosh installation instructions
@cindex Macintosh installation
@cindex instructions, Macintosh installation
@cindex howto, install on Macintosh

@strong{Installation of the provided binaries}
@url{http://www.singular.uni-kl.de/index.php/singular-download/install-mac-os.html}