X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=INSTALL;h=ea43342eef7223bce3b2fcb76d5ba817166bf2fd;hb=5ee84736663824fe12474b78dace867e42893a14;hp=a7f2f88fec364aa3a098d561a05baf2b897f009a;hpb=9cbe9768e1e2685c2aceb726cbecb7a1ac082dbc;p=pspp-builds.git

diff --git a/INSTALL b/INSTALL
index a7f2f88f..ea43342e 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,5 +1,5 @@
-PSPP Installation Instructions
-******************************
+Installation Instructions for GNU pspp
+**************************************
 
 These instructions are based on the generic GNU installation
 instructions, but they have been tailored for PSPP.
@@ -44,13 +44,29 @@ The following packages are required to enable PSPPIRE, the graphical
 user interface for PSPP.  If you cannot install them or do not wish to
 use the GUI, you must run `configure' with --without-gui.
 
-    * pkg-config (http://pkg-config.freedesktop.org/wiki/). 
+    * pkg-config (http://pkg-config.freedesktop.org/wiki/).  Versions
+      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.8.0 or later, although we
-      recommend version 2.10.2 or later.
+    * GTK+ (http://www.gtk.org/), version 2.12.0 or later.
 
     * libglade (http://www.jamesh.id.au/software/libglade/), version
-      2.0 or later.
+      2.6 or later.
+
+Installing the following packages will allow your PSPP binary to read
+Gnumeric files.
+
+    * pkg-config (http://pkg-config.freedesktop.org/wiki/).  Versions
+      0.18 and 0.19 have a bug that will prevent library detection,
+      but other versions should be fine.
+
+      To cross-compile PSPP, you will likely need to set the
+      PKG_CONFIG_LIBDIR environment variable to point to an
+      appropriate pkg-config for the cross-compilation environment.
+
+    * zlib (http://www.zlib.net/).
+
+    * libxml2 (http://xmlsoft.org/).  
 
 The following packages are optional.
 
@@ -66,6 +82,9 @@ The following packages are optional.
       later.  Installing Texinfo will allow you to build PSPP
       documentation in PostScript or PDF format.
 
+    * libpq, from Postgresql (http://postgresql.org). This enables PSPP 
+      to read Postgresql databases.
+
 Basic Installation
 ==================
 
@@ -89,20 +108,36 @@ release.
   1. `cd' to the directory containing the package's source code and type
      `./configure' to configure the package for your system.
 
+     You may invoke `configure' with --help to see what options are
+     available.  The most common of these are listed under "Optional
+     Features", below.
+
+     If you installed some of the libraries that PSPP uses in a
+     non-standard location (on many systems, anywhere other than
+     /usr), you may need to provide some special flags to `configure'
+     to tell it where to find them.  For example, on GNU/Linux, if you
+     installed some libraries in /usr/local, then you need to invoke
+     it with at least the following options:
+
+	./configure LDFLAGS='-L/usr/local/lib -Wl,-rpath,/usr/local/lib' CPPFLAGS='-I/usr/local/include'
+
      Running `configure' takes awhile.  While running, it prints some
      messages telling which features it is checking for.
 
-     When `configure' completes, it may print a list of packages that
-     you must install before PSPP.  If it does, you need to install
-     those packages, then re-run this step.  Some prerequisites may be
+     If `configure' completes successfully, it prints the message
+     "PSPP configured successfully." at the end of its run.
+     Otherwise, it may stop with a list of packages that you must
+     install before PSPP.  If it does, you need to install those
+     packages, then re-run this step.  Some prerequisites may be
      omitted by passing a --without-<feature> flag to `configure' (see
      "Optional Features", below).  If you use one of these flags, then
      the feature that it disables will not be available in your PSPP
      installation.
 
      `configure' may also print a list of packages that you should
-     consider installing.  If you install them, additional features
-     will be available in your PSPP installation.
+     consider installing.  If you install them, then re-run
+     `configure', additional features will be available in your PSPP
+     installation.
 
   2. Type `make' to compile the package.
 
@@ -184,6 +219,20 @@ Optional Features
     Build the gui developer tools.  There is no reason to use this
     option unless you're involved with the development of PSPP
 
+`--without-lib{xx}'
+    Optional libraries should normally be detected and the relevant
+    functionality will be built they exist.  However, on some poorly
+    configured systems a library may exist, but be totally broken.
+    In these cases you can use --without-lib{xx} to force configure
+    to disregard it.
+
+`--enable-anachronistic-dependencies'
+   If you use this option, some of the checks for dependent libraries
+   will be relaxed, permitting configure to succeed when older versions
+   of libraries are detected.   Use of this option is not recommended.
+   If you use it, some features may be missing and the build may fail
+   with obscure error messages.
+   
 
 Defining Variables
 ==================