**************************************
These instructions are based on the generic GNU installation
-instructions, but they have been tailored for PSPP.
+instructions, but they have been tailored for PSPP. These instructions
+apply only to people wishing to build and install PSPP from source.
Overview
========
tar -xzf pspp-*.tar.gz
cd pspp-*
./configure
- make
+ make
sudo make install
Obviously, you should replace 'pspp-*' in the above, with the name of
-the tarball you are installing. If any part of this process fails, then
-it's likely that one or more of the necessary prerequisites is missing
-from your system. Read on to find out how to correct this.
+the tarball you are installing.
+
+In 99% of cases, that is all you have to do - FINISHED!
+
+
+
+
+If any part of the above process fails, then it is
+likely that one or more of the necessary prerequisites is missing
+from your system. The following paragraphs contain highly detailed
+information which will help you fix this.
+
Before You Install
==================
Before you install PSPP, you will need to install certain prerequisite
packages. You may also want to install other packages that enable
-additional functionality in PSPP.
+additional functionality in PSPP. Please note, if you are installing
+any of the libararies mentioned below using pre-prepared binary
+packages provided by popular GNU/Linux vendors, you may need to ensure
+that you install the "development" versions (normally postfixed with
+-dev or -devel).
If you do not know whether you have these installed already, you may
proceed to "Basic Installation", below. The PSPP configuration
The following packages are required to install PSPP:
- * An ANSI C compiler and tool chain. On Unix-like systems, we
+ * A C compiler and tool chain. On Unix-like systems, we
recommend GCC, but any modern compilation environment should
work. On Microsoft Windows, Cygwin (http://www.cygwin.com/) and
MinGW (http://www.mingw.org/) are known to work.
* The GNU Scientific Library (http://www.gnu.org/software/gsl/),
- version 1.8 or later, including libgslcblas included with GSL.
+ version 1.13 or later, including libgslcblas included with GSL.
* Perl (http://www.perl.org/), version 5.005_03 or later. Perl is
required during build but not after installation.
+ * Python (https://python.org/), version 2.7 or later (Python 3 is
+ fine). Some tests require Python; if it is missing, those tests
+ will be skipped. PSPP does not otherwise require Python.
+
* iconv, which should be installed as part of a Unix-like system.
If you don't have a version already, you can install GNU
libiconv (http://www.gnu.org/software/libiconv/).
- * libintl, from GNU gettext (http://ww.gnu.org/software/gettext).
+ * libintl, from GNU gettext (http://www.gnu.org/software/gettext).
GNU libc includes an integrated libintl, so there is no need to
separately install libintl on a GNU/Linux system.
+ * zlib (http://www.zlib.net/).
+
+ * libxml2 (http://xmlsoft.org/).
+
The following packages are required to enable PSPP's graphing
features. If you cannot arrange to install them, you must run
-`configure' with --without-cairo.
+`configure' with --without-cairo (in which case you will get no graphing
+capability).
* Cairo (http://cairographics.org/), version 1.12 or later.
0.18 and 0.19 have a bug that will prevent library detection,
but other versions should be fine.
- * GTK+ (http://www.gtk.org/), version 3.4.0 or later.
+ * GTK+ (http://www.gtk.org/), version 3.22.0 or later.
- * GtkSourceView (http://projects.gnome.org/gtksourceview/)
+ * GtkSourceView (http://projects.gnome.org/gtksourceview/)
version 3.4.0 or later.
+ * GNU Spread Sheet Widget (http://www.gnu.org/software/ssw)
-Installing the following packages will allow your PSPP binary to read
-Gnumeric files.
-
- * zlib (http://www.zlib.net/).
-
- * libxml2 (http://xmlsoft.org/).
-
-Installing the following packages will allow your PSPP binary to write
-OpenDocument text (ODT) files:
-
- * libxml2 (http://xmlsoft.org/).
-
-The following packages are optional.
+The following packages are optional:
- * libncurses (http://www.gnu.org/software/ncurses/). Without it,
- PSPP will assume it is running in an 80x25 terminal.
+Other optional packages:
* libreadline and libhistory
(http://tiswww.case.edu/php/chet/readline/rltop.html). Without
later. Installing Texinfo will allow you to build PSPP
documentation in PostScript or PDF format.
- * libpq, from Postgresql (http://postgresql.org). This enables PSPP
+ * libpq, from Postgresql (http://postgresql.org). This enables PSPP
to read Postgresql databases. The tests for the Postgresql
interface, but not the Postgresql interface itself, requires the
Postgresql server to be installed.
Basic Installation
==================
-These are installation instructions specific to PSPP (including PSPPIRE,
+These are installation instructions specific to PSPP (including PSPPIRE,
the graphic user interface). These instructions contain the
information most commonly needed by people wishing to build the
program from source. More detailed information can be found in the
by setting variables in the command line or in the environment. Here
is an example:
- ./configure CC=c89 CFLAGS=-O2 LIBS=-lposix
+ ./configure CC=c89 CFLAGS=-O0 LIBS=-lposix
To cross-compile PSPP, you will likely need to set the
PKG_CONFIG_LIBDIR environment variable to point to an
You can cause programs to be installed with an extra prefix or
suffix on their names by giving `configure' the option
-`--program-prefix=PREFIX' or `--program-suffix=SUFFIX'.
+`--program-prefix=PREFIX' or `--program-suffix=SUFFIX'.
Optional Features
=================
This option is useful for building a package which can be installed
into an arbitrary directory and freely copied to any other directory.
If you use this option, you will probably want to install the pspp
- with a command similar to "make install DESTDIR=<distination>".
+ with a command similar to "make install DESTDIR=<destination>".
Defining Variables
==================