From bdb8cb5a8380b919657c252fe1c39525c4f2bbfc Mon Sep 17 00:00:00 2001 From: Ben Pfaff Date: Fri, 29 Jan 2010 11:15:32 -0800 Subject: [PATCH] Add README.Git that advises a working version of Gnulib. --- README.CVS | 46 --------------------------------- README.Git | 76 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 76 insertions(+), 46 deletions(-) delete mode 100644 README.CVS create mode 100644 README.Git diff --git a/README.CVS b/README.CVS deleted file mode 100644 index 2e45fefa..00000000 --- a/README.CVS +++ /dev/null @@ -1,46 +0,0 @@ -To build this project from the sources direct from the cvs archive, -you must install the prerequisites listed in README, plus the -following: - - * Autoconf 2.60 (or later). - - * Automake 1.10 (or later). - - * Gettext 0.17 (or later). - - * GNU M4 1.4.9 (or later). - - * pkg-config 0.21 (or later). - - * gperf 3.0.1 (or later). - - * Gnulib, from Git at . - If you do not have Git installed, up-to-date snapshots are - at . - Note that Gnulib does not require any form of installation: - simply checking it out into a directory is sufficient. We - recommend checking out gnulib into a directory named `gnulib' - at the same level as PSPP. - - * libtool 1.5.22 (or later). - - * Texinfo 4.7 or later, to build the documentation. - -Once you have these installed, execute - make -f Smake -If you checked Gnulib out in a directory named `gnulib' at the same -level as PSPP, then this is sufficient. Otherwise, provide the -location of GNULIB on the `make' command line: - make -f Smake GNULIB=/gnulib/base/directory/name - -After executing Smake, you may configure the source tree in the usual -way with ./configure, e.g. - ./configure -For a list of options: - ./configure --help - -To test: - make check - -For a very thorough test: - make distcheck diff --git a/README.Git b/README.Git new file mode 100644 index 00000000..4c5eae60 --- /dev/null +++ b/README.Git @@ -0,0 +1,76 @@ +Prerequisites for Building PSPP from Git +---------------------------------------- + +To build this project from the sources direct from the Git archive, +you must install the prerequisites listed in README, plus the +following: + + * Autoconf 2.60 (or later). + + * Automake 1.10 (or later). + + * Gettext 0.17 (or later). + + * GNU M4 1.4.9 (or later). + + * pkg-config 0.21 (or later). + + * gperf 3.0.1 (or later). + + * Gnulib (see below for details). + + * libtool 1.5.22 (or later). + + * Texinfo 4.7 or later, to build the documentation. + +After you install PSPP's prerequisites, you must obtain a copy of +Gnulib, then bootstrap the tree, as described in the sections below. +After that, you may follow the procedure described in INSTALL. + +Obtaining Gnulib +---------------- + +This version of PSPP should work with the Gnulib commit shown below. +Gnulib does not maintain a stable API or ABI, so it is possible that +PSPP will not work with older or newer versions of Gnulib. + + commit c5588be343f580be8e87d99e043dcdf3d7606759 + Author: Paolo Bonzini + Date: Thu Dec 3 18:39:47 2009 +0100 + + exclude: Fix header file problems. + +To clone Gnulib into a directory named "gnulib" using Git, and then +check out this particular commit, run these commands: + git clone git://git.savannah.gnu.org/gnulib.git gnulib + cd gnulib + git checkout $COMMIT +where $COMMIT should be replaced by the commit number listed above +(usually it is sufficient to just type the first 6 or so digits). + +If you do not have Git installed, then you may alternately download +http://git.savannah.gnu.org/gitweb/?p=gnulib.git;a=snapshot;h=$COMMIT;sf=tgz +where $COMMIT is, again, at least the first few digits of the commit +number listed above. This download will yield a tar.gz file that you +may extract with "gunzip" and "tar" to yield identical results. + +Bootstrapping +------------- + +Once you have Gnulib installed, PSPP must be "bootstrapped" using the +following command: + make -f Smake +If you checked Gnulib out in a directory named `gnulib' at the same +level as PSPP, then this is sufficient. Otherwise, provide the +location of GNULIB on the `make' command line: + make -f Smake GNULIB=/gnulib/base/directory/name + +After executing Smake, follow the procedure described in INSTALL to +build and install PSPP. On some systems this may be as simple as: + ./configure + make + +Once PSPP is built, you may run its self-tests with: + make check +or for a more thorough test: + make distcheck -- 2.30.2