Add support for reading and writing SPV files.
[pspp] / INSTALL
diff --git a/INSTALL b/INSTALL
index 3d6d20e9dce77c863bf58c4b63ddff519a24158e..25e9a6623604dae4f8699fe0ea3d6113405552a5 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -2,7 +2,8 @@ Installation Instructions for GNU pspp
 **************************************
 
 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
 ========
@@ -22,6 +23,8 @@ 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
@@ -33,7 +36,11 @@ 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
@@ -48,21 +55,27 @@ The following packages are required to install PSPP:
       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.  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 (in which case you will get no graphing
@@ -80,28 +93,19 @@ use the GUI, you must run `configure' with --without-gui.
       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.18.0 or later.
+      It has been reported that versions prior to 3.22.x give problems,
+      so a recent version is recommended.
 
     * GtkSourceView (http://projects.gnome.org/gtksourceview/) 
       version 3.4.0 or later.
 
-The following packages are optional:
-
-Installing the following packages will allow your PSPP program to read
-Gnumeric files.
+    * GNU Spread Sheet Widget (http://www.gnu.org/software/ssw)
 
-    * libxml2 (http://xmlsoft.org/).  
-
-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.
-
     * libreadline and libhistory
       (http://tiswww.case.edu/php/chet/readline/rltop.html).  Without
       them, interactive command editing and history features in the
@@ -211,7 +215,7 @@ details on some of the pertinent environment variables.
 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