i18n: Test converting between unknown encodings too.
[pspp-builds.git] / doc / installing.texi
1 @node Installation
2 @appendix Installing PSPP
3 @cindex installation
4 @cindex PSPP, installing
5
6 @cindex GNU C compiler
7 @cindex gcc
8 @cindex compiler, recommended
9 @cindex compiler, gcc
10 PSPP is written in ISO C and primarily targeted at UNIX-like
11 environments.  To install PSPP under a UNIX-like operating system,
12 follow the steps below.
13
14 @enumerate
15 @item
16 @code{cd} to the directory containing the PSPP source.
17
18 @cindex configure, GNU
19 @cindex GNU configure
20 @item
21 Type @samp{./configure} to configure for your particular operating
22 system and compiler.  Running @code{configure} takes a while.  While
23 running, it displays some messages telling which features it is checking
24 for.
25
26 You can optionally supply some options to @code{configure} to
27 give it hints about how to do its job.  Type @code{./configure --help}
28 to see a list of options.
29
30 @cindex compiling
31 @item
32 Type @samp{make} to compile the package.  If there are any errors during
33 compilation, try to fix them.  If modifications are necessary to compile
34 correctly under your configuration, contact the author.
35 @xref{Bugs,,Submitting Bug Reports}, for details.
36
37 @cindex self-tests, running
38 @item
39 Type @samp{make check} to run self-tests on the compiled PSPP package.
40
41 @cindex installation
42 @cindex PSPP, installing
43 @cindex @file{/usr/local/share/pspp/}
44 @cindex @file{/usr/local/bin/}
45 @cindex @file{/usr/local/info/}
46 @cindex documentation, installing
47 @item
48 Become the superuser and type @samp{make install} to install the
49 PSPP binaries, by default in @file{/usr/local/bin/}.  The
50 directory @file{/usr/local/share/pspp/} is created and populated with
51 files needed by PSPP at runtime.  This step will also cause the
52 PSPP documentation to be installed in @file{/usr/local/info/},
53 but only if that directory already exists.
54
55 @item
56 (optional) Type @samp{make clean} to delete the PSPP binaries
57 from the source tree.
58 @end enumerate