**************************************
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
========
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.
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/).
+
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.5 or later.
+ * Cairo (http://cairographics.org/), version 1.12 or later.
* Pango (http://www.pango.org/), version 1.22 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 2.24.0 or later.
+ * GTK+ (http://www.gtk.org/), version 3.4.0 or later.
* GtkSourceView (http://projects.gnome.org/gtksourceview/)
- version 2.2 or later.
+ version 3.4.0 or later.
+The following packages are optional:
-Installing the following packages will allow your PSPP binary to read
+Installing the following packages will allow your PSPP program to read
Gnumeric files.
- * zlib (http://www.zlib.net/).
-
* libxml2 (http://xmlsoft.org/).
-Installing the following packages will allow your PSPP binary to write
+Installing the following packages will allow your PSPP program to write
OpenDocument text (ODT) files:
* libxml2 (http://xmlsoft.org/).
-The following packages are optional.
+Other optional packages:
* libncurses (http://www.gnu.org/software/ncurses/). Without it,
PSPP will assume it is running in an 80x25 terminal.
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
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
==================
`configure --help' for more details.
----------------------------------------------------------------------
-Copyright (C) 1994, 1995, 1996, 1999, 2000, 2001, 2002, 2004, 2005, 2007 Free
+Copyright (C) 1994, 1995, 1996, 1999, 2000, 2001, 2002, 2004, 2005, 2007, 2013 Free
Software Foundation, Inc.
This file is free documentation; the Free Software Foundation gives