casereader: New function casereader_truncate().
[pspp-builds.git] / README.Git
1 Prerequisites for Building PSPP from Git
2 ----------------------------------------
3
4 To build this project from the sources direct from the Git archive,
5 you must install the prerequisites listed in README, plus the
6 following:
7
8         * Autoconf 2.60 (or later).
9
10         * Automake 1.10 (or later).
11
12         * Gettext 0.17 (or later).
13
14         * GNU M4 1.4.9 (or later).
15
16         * pkg-config 0.21 (or later).
17
18         * gperf 3.0.1 (or later).
19
20         * Gnulib (see below for details).
21
22         * libtool 1.5.22 (or later).
23
24         * Texinfo 4.7 or later, to build the documentation.
25
26 After you install PSPP's prerequisites, you must obtain a copy of
27 Gnulib, then bootstrap the tree, as described in the sections below.
28 After that, you may follow the procedure described in INSTALL.
29
30 Obtaining Gnulib
31 ----------------
32
33 This version of PSPP should work with the Gnulib commit shown below.
34 Gnulib does not maintain a stable API or ABI, so it is possible that
35 PSPP will not work with older or newer versions of Gnulib.
36
37     commit e21985ad14508137d75b0dccf064adfc4e5888c6
38     Author: Bruno Haible <bruno@clisp.org>
39     Date:   Mon Sep 28 23:25:49 2009 +0200
40
41         Avoid identifier clash with POSIX function 'remove' defined as a macro.
42
43 To clone Gnulib into a directory named "gnulib" using Git, and then
44 check out this particular commit, run these commands:
45         git clone git://git.savannah.gnu.org/gnulib.git gnulib
46         cd gnulib
47         git checkout $COMMIT
48 where $COMMIT should be replaced by the commit number listed above
49 (usually it is sufficient to just type the first 6 or so digits).
50
51 If you do not have Git installed, then you may alternately download
52 http://git.savannah.gnu.org/gitweb/?p=gnulib.git;a=snapshot;h=$COMMIT;sf=tgz
53 where $COMMIT is, again, at least the first few digits of the commit
54 number listed above.  This download will yield a tar.gz file that you
55 may extract with "gunzip" and "tar" to yield identical results.
56
57 Bootstrapping
58 -------------
59
60 Once you have Gnulib installed, PSPP must be "bootstrapped" using the
61 following command:
62         make -f Smake
63 If you checked Gnulib out in a directory named `gnulib' at the same
64 level as PSPP, then this is sufficient.  Otherwise, provide the
65 location of GNULIB on the `make' command line:
66         make -f Smake GNULIB=/gnulib/base/directory/name
67
68 After executing Smake, follow the procedure described in INSTALL to
69 build and install PSPP.  On some systems this may be as simple as:
70         ./configure
71         make
72
73 Once PSPP is built, you may run its self-tests with:
74         make check
75 or for a more thorough test:
76         make distcheck