projects / pspp / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
Add support for reading and writing SPV files.
[pspp] / INSTALL
diff --git a/INSTALL b/INSTALL
index acc4bfa0ad49379e78321a89938007c14149a3ad..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
 **************************************
 
 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
 ========
 
 Overview
 ========
@@ -22,6 +23,8 @@ the tarball you are installing.
 In 99% of cases, that is all you have to do - FINISHED! 
 
 
 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
 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
 
 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
 
 If you do not know whether you have these installed already, you may
 proceed to "Basic Installation", below.  The PSPP configuration
@@ -48,27 +55,33 @@ 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/),
       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.
 
 
     * 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/).
 
     * 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/).
 
       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
 capability).
 
 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
 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.
 
 
     * Pango (http://www.pango.org/), version 1.22 or later.
 
@@ -80,29 +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.
 
       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.  However
-      it must be Gtk+ 2.something  - The Gtk+-3.x series will NOT work!
+    * 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/) 
 
     * GtkSourceView (http://projects.gnome.org/gtksourceview/) 
-      version 2.2 or later.
-
-The following packages are optional:
+      version 3.4.0 or later.
 
 
-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:
 
 
 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
     * libreadline and libhistory
       (http://tiswww.case.edu/php/chet/readline/rltop.html).  Without
       them, interactive command editing and history features in the
@@ -212,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:
 
 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
 
 To cross-compile PSPP, you will likely need to set the
 PKG_CONFIG_LIBDIR environment variable to point to an
Unnamed repository; edit this file to name it for gitweb.