Installing PSPP
***************

PSPP conforms to the GNU Coding Standards.  PSPP is written in, and requires for proper operation, ANSI/ISO C.  You might want to additionally note the following points:

  * The compiler and linker must allow for significance of several characters in external identifiers.  The exact number is unknown but at least 31 is recommended.

  * The int type must be 32 bits or wider.

  * The recommended compiler is gcc 2.7.2.1 or later, but any ANSI compiler will do if it fits the above criteria.

Many UNIX variants should work out-of-the-box, as PSPP uses GNU autoconf to detect differences between environments.  Please report any problems with compilation of PSPP under UNIX and UNIX-like operating systems---portability is a major concern of the author.

The pages below give specific instructions for installing PSPP on each type of system mentioned above.

UNIX installation
=================

To install PSPP under a UNIX-like operating system, follow the steps below in order.  Some of the text below was taken directly from various Free Software Foundation sources.

 1. cd to the directory containing the PSPP source.

 2. Type ./configure to configure for your particular operating system and compiler.  Running configure takes a while.  While running, it displays some messages telling which features it is checking for.

     You can optionally supply some options to configure to give it hints about how to do its job.  Type ./configure --help to see a list of options.  One of the most useful options is --with-checker, which enables the use of the Checker memory debugger under supported operating systems.  Checker must already be installed to use this option.  Do not use --with-checker if you are not debugging PSPP itself.

 3. (optional) Edit Makefile, config.h, and pref.h. These files are produced by configure.  Note that most PSPP settings can be changed at runtime.

     pref.h is only generated by configure if it does not already exist.  (It's copied from prefh.orig.)

 4. Type make to compile the package.  If there are any errors during compilation, try to fix them.  If modifications are necessary to compile correctly under your configuration, contact the author. See Submitting Bug Reports, for details.

 5. Type make check to run self-tests on the compiled PSPP package.

 6. Become the superuser and type make install to install the PSPP binaries, by default in /usr/local/bin/.  The directory /usr/local/share/pspp/ is created and populated with files needed by PSPP at runtime.  This step will also cause the PSPP documentation to be installed in /usr/local/info/, but only if that directory already exists.

 7. (optional) Type make clean to delete the PSPP binaries from the source tree.