doc/installing.texi

   1 @c PSPP - a program for statistical analysis.
   2 @c Copyright (C) 2017 Free Software Foundation, Inc.
   3 @c Permission is granted to copy, distribute and/or modify this document
   4 @c under the terms of the GNU Free Documentation License, Version 1.3
   5 @c or any later version published by the Free Software Foundation;
   6 @c with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
   7 @c A copy of the license is included in the section entitled "GNU
   8 @c Free Documentation License".
   9 @c
  10 @node Installation
  11 @appendix Installing @pspp{}
  12 @cindex installation
  13 @cindex @pspp{}, installing
  14
  15 @cindex GNU C compiler
  16 @cindex gcc
  17 @cindex compiler, recommended
  18 @cindex compiler, gcc
  19 @pspp{} is written in ISO C and primarily targeted at UNIX-like
  20 environments.  To install @pspp{} under a UNIX-like operating system,
  21 follow the steps below.
  22
  23 @enumerate
  24 @item
  25 @code{cd} to the directory containing the @pspp{} source.
  26
  27 @cindex configure, GNU
  28 @cindex GNU configure
  29 @item
  30 Type @samp{./configure} to configure for your particular operating
  31 system and compiler.  Running @code{configure} takes a while.  While
  32 running, it displays some messages telling which features it is checking
  33 for.
  34
  35 You can optionally supply some options to @code{configure} to
  36 give it hints about how to do its job.  Type @code{./configure --help}
  37 to see a list of options.
  38
  39 @cindex compiling
  40 @item
  41 Type @samp{make} to compile the package.  If there are any errors during
  42 compilation, try to fix them.  If modifications are necessary to compile
  43 correctly under your configuration, contact the author.
  44 @xref{Bugs,,Submitting Bug Reports}, for details.
  45
  46 @cindex self-tests, running
  47 @item
  48 Type @samp{make check} to run self-tests on the compiled @pspp{} package.
  49
  50 @cindex installation
  51 @cindex @pspp{}, installing
  52 @cindex @file{/usr/local/share/pspp/}
  53 @cindex @file{/usr/local/bin/}
  54 @cindex @file{/usr/local/info/}
  55 @cindex documentation, installing
  56 @item
  57 Become the superuser and type @samp{make install} to install the
  58 @pspp{} binaries, by default in @file{/usr/local/bin/}.  The
  59 directory @file{/usr/local/share/pspp/} is created and populated with
  60 files needed by @pspp{} at runtime.  This step will also cause the
  61 @pspp{} documentation to be installed in @file{/usr/local/info/},
  62 but only if that directory already exists.
  63
  64 @item
  65 (optional) Type @samp{make clean} to delete the @pspp{} binaries
  66 from the source tree.
  67 @end enumerate