work
[pspp] / doc / installing.texi
1 @c PSPP - a program for statistical analysis.
2 @c Copyright (C) 2017, 2020 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