source: git/doc/INSTALL_rpm.texi @ 6ce030f

@comment -*-texinfo-*-
@c FILE: INSTALL_rpm.texi
@c PURPOSE: Installation instruction for Singular on RPM based Linux systems
@c

@ifclear VERSION
@include version.texi
@end ifclear

@ifclear singularmanual
@majorheading Installation of @sc{Singular} @value{RPM_VERSION} on @sc{rpm} based @sc{Linux} systems
@end ifclear

@sc{rpm} is a powerful package manager, which can be used to build, install, query, verify, update, and erase individual software packages.
@sc{Singular} can be installed on an @sc{rpm} based @sc{Linux} system.
The installation of @sc{Singular} on a general @sc{Unix} system is described in @code{INSTALL_unix}.

@heading @sc{Singular} @sc{rpm} packages

The following @sc{Singular} @sc{rpm} packages are available.

@table @code
@item @uref{Singular-@value{RPM_VERSION}-1.i386.rpm}
contains architecture-dependent executables like the @sc{Singular} program.
@item @uref{Singular-static-@value{RPM_VERSION}-1.i386.rpm}
contains the static version of the architecture dependend executables.
@item @uref{Singular-share-@value{RPM_VERSION}-1.noarch.rpm}
contains architecture independend data like documentation and libraries.
@item @uref{Singular-desktop-@value{RPM_VERSION}-1.noarch.rpm}
contains icons and menues for @sc{gnome} and @sc{kde}.
@end table

The above @sc{rpm} packages can be downloaded from
@display
@uref{ftp://www.mathematik.uni-kl.de/pub/Math/Singular/UNIX}.
@end display

@include register.texi

@heading Usage of @sc{rpm} packages
@enumerate
@item
You can only use the @sc{Singular} @sc{rpm} packages on an @sc{rpm} based @sc{Linux} system like @sc{RedHat Linux} or @sc{SuSE Linux}.
You can check this by typing 
@smallexample
rpm
@end smallexample
in a command shell. This should produce an output like
@smallexample
RPM Version 4.0.3
Copyright (C) 1998-2000 - Red Hat, Inc.
This program may be freely redistributed under the terms of the GNU GPL

Usage: rpm @{--help@}
       rpm @{--version@}
@end smallexample
@item
To deal with @sc{rpm} packages, you can either use the @sc{rpm} command line tool @code{rpm} or a graphical @sc{rpm} frontend like e.g. @code{gnorpm} under @sc{gnome} or @code{kpackage} under @sc{kde}.
For a description of the usage of @code{rpm}, type 
@smallexample
rpm -h
@end smallexample
in a command shell.
@item
To install or deinstall @sc{rpm} packages, you have to be superuser.
To become superuser, type
@smallexample
su
@end smallexample
in a command shell and enter the root password.
@end enumerate


@heading Installation of @sc{Singular} @sc{rpm} packages

In the following, we describe how to install @sc{Singular} using the @sc{rpm} command line tool @code{rpm}.
Alternatively, you can use a graphical @sc{rpm} frontend like e.g. @code{gnorpm} under @sc{gnome} or @code{kpackage} under @sc{kde}.

@enumerate
@item
The installation requires about 26MB of free disk space under @code{/usr/local}.
You can check the free disk space by typing
@smallexample
df -h
@end smallexample
in a command shell.
@item
Different versions of @sc{Singular} @sc{rpm} packages coexist without conflicts.
@item
To install the @sc{Singular} @value{RPM_VERSION} @sc{rpm} packages, type
@smallexample
rpm -ivh \
Singular-@value{RPM_VERSION}-1.i386.rpm \
Singular-share-@value{RPM_VERSION}-1.noarch.rpm \
Singular-desktop-@value{RPM_VERSION}-1.noarch.rpm
@end smallexample
in a command shell.
@item
To deinstall the @sc{Singular} @value{RPM_VERSION} @sc{rpm} packages, type
@smallexample
rpm -e \
Singular-@value{RPM_VERSION}-1.i386.rpm \
Singular-share-@value{RPM_VERSION}-1.noarch.rpm \
Singular-desktop-@value{RPM_VERSION}-1.noarch.rpm
@end smallexample
in a command shell.
@item The @sc{Singular} binary  @sc{rpm} package @code{Singular-@value{RPM_VERSION}-1.i386.rpm} can be replaced by the @sc{Singular} static binary @sc{rpm} package @code{Singular-static-@value{RPM_VERSION}-1.i386.rpm}.
@end enumerate

@heading Starting @sc{Singular}
@enumerate
@item
To run @sc{Singular} @value{RPM_VERSION}, type
@smallexample
Singular-@value{VERSION}
@end smallexample
in a command shell.
To run @sc{Singular} @value{RPM_VERSION} under @sc{Emacs}, type
@smallexample
ESingular-@value{VERSION}
@end smallexample
in a command shell.
@item To read the @sc{Singular} @value{RPM_VERSION} manual, direct your web browser to @code{/usr/local/Singular/@value{VERSION}/html/index.htm}. 
@item
Under @sc{gnome} or @sc{kde}, click on the menu item @code{TSingular} to run @sc{Singular} @value{RPM_VERSION} in a terminal, on the menu item @code{ESingular} to run @sc{Singular} @value{RPM_VERSION} under @sc{Emacs}, or on the menu item @code{Manual} to read the @sc{Singular} @value{RPM_VERSION} manual.
@end enumerate


@include info.texi

@ifclear singularmanual
Good luck and enjoy! Your @sc{Singular} team.
@end ifclear