X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Finstalling.texi;h=7af54a3664e864d5406e66d4837cb86e483d5496;hb=bc5c6c1953ada1737620e27e6a968392a38d8c8f;hp=97f82ec515c9cdb9e3f02e629e3b937c4becab1a;hpb=1fc3af93c0ba6cbaf7ef09edc979096b6f16dd6f;p=pspp diff --git a/doc/installing.texi b/doc/installing.texi index 97f82ec515..7af54a3664 100644 --- a/doc/installing.texi +++ b/doc/installing.texi @@ -1,54 +1,28 @@ -@node Installation, Configuration, Concept Index, Top -@appendix Installing PSPP +@c PSPP - a program for statistical analysis. +@c Copyright (C) 2017, 2020 Free Software Foundation, Inc. +@c Permission is granted to copy, distribute and/or modify this document +@c under the terms of the GNU Free Documentation License, Version 1.3 +@c or any later version published by the Free Software Foundation; +@c with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. +@c A copy of the license is included in the section entitled "GNU +@c Free Documentation License". +@c +@node Installation +@appendix Installing @pspp{} @cindex installation -@cindex PSPP, installing +@cindex @pspp{}, installing @cindex GNU C compiler @cindex gcc @cindex compiler, recommended @cindex compiler, gcc -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: - -@itemize @bullet -@item -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. - -@item -The @code{int} type must be 32 bits or wider. - -@item -The recommended compiler is gcc 2.7.2.1 or later, but any ANSI compiler -will do if it fits the above criteria. -@end itemize - -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. - -@menu -* UNIX installation:: Installing on UNIX-like environments. -@end menu - -@node UNIX installation, , Installation, Installation -@section UNIX installation -@cindex UNIX, installing PSPP under -@cindex installation, under UNIX -@noindent -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. +@pspp{} is written in ISO C and primarily targeted at UNIX-like +environments. To install @pspp{} under a UNIX-like operating system, +follow the steps below. @enumerate @item -@code{cd} to the directory containing the PSPP source. +@code{cd} to the directory containing the @pspp{} source. @cindex configure, GNU @cindex GNU configure @@ -60,23 +34,7 @@ for. You can optionally supply some options to @code{configure} to give it hints about how to do its job. Type @code{./configure --help} -to see a list of options. One of the most useful options is -@samp{--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 @samp{--with-checker} if you -are not debugging PSPP itself. - -@cindex @file{Makefile} -@cindex @file{config.h} -@cindex @file{pref.h} -@cindex makefile -@item -(optional) Edit @file{Makefile}, @file{config.h}, and @file{pref.h}. -These files are produced by @code{configure}. Note that most PSPP -settings can be changed at runtime. - -@file{pref.h} is only generated by @code{configure} if it does not -already exist. (It's copied from @file{prefh.orig}.) +to see a list of options. @cindex compiling @item @@ -87,24 +45,23 @@ correctly under your configuration, contact the author. @cindex self-tests, running @item -Type @samp{make check} to run self-tests on the compiled PSPP package. +Type @samp{make check} to run self-tests on the compiled @pspp{} package. @cindex installation -@cindex PSPP, installing +@cindex @pspp{}, installing @cindex @file{/usr/local/share/pspp/} @cindex @file{/usr/local/bin/} @cindex @file{/usr/local/info/} @cindex documentation, installing @item Become the superuser and type @samp{make install} to install the -PSPP binaries, by default in @file{/usr/local/bin/}. The +@pspp{} binaries, by default in @file{/usr/local/bin/}. The directory @file{/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 @file{/usr/local/info/}, +files needed by @pspp{} at runtime. This step will also cause the +@pspp{} documentation to be installed in @file{/usr/local/info/}, but only if that directory already exists. @item -(optional) Type @samp{make clean} to delete the PSPP binaries +(optional) Type @samp{make clean} to delete the @pspp{} binaries from the source tree. @end enumerate -@setfilename ignored