6b3b64e05174fc09423197d402f908168f55c1a6
[pspp] / doc / pspp.texi
1 \input texinfo @c -*- texinfo -*-
2 @c PSPP - a program for statistical analysis.
3 @c Copyright (C) 2017, 2019, 2020 Free Software Foundation, Inc.
4 @c Permission is granted to copy, distribute and/or modify this document
5 @c under the terms of the GNU Free Documentation License, Version 1.3
6 @c or any later version published by the Free Software Foundation;
7 @c with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
8 @c A copy of the license is included in the section entitled "GNU
9 @c Free Documentation License".
10
11 @c %**start of header
12 @setfilename pspp.info
13 @settitle PSPP
14 @c For double-sided printing, uncomment:
15 @c @setchapternewpage odd
16 @c %**end of header
17
18 @macro gui
19 graphic user interface
20 @end macro
21
22 @macro psppsyntax{FILE}
23 @html
24 <div class="pspp-syntax">
25 @end html
26 @cartouche
27 @smallexample
28 @verbatiminclude pspp-figures/\FILE\
29 @end smallexample
30 @end cartouche
31 @html
32 </div>
33 @end html
34 @end macro
35
36 @macro psppoutput{FILE}
37 @ifnothtml
38 @smallexample
39 @include pspp-figures/\FILE\.texi
40 @end smallexample
41 @end ifnothtml
42 @ifhtml
43 @cartouche
44 @html
45
46 <div class="pspp">
47 @include pspp-figures/\FILE\.html
48 </div>
49
50 @end html
51 @end cartouche
52 @end ifhtml
53 @end macro
54
55 @macro note{param1}
56 @quotation
57 @strong{Please note:} \param1\
58 @end quotation
59 @end macro
60
61 @c A macro to indicate variable names used in examples.
62 @c NOT metasyntactical variables - for that use @var
63 @macro exvar{VAR}
64 @b{\VAR\}
65 @end macro
66
67 @include version.texi
68
69 @c This macro should be used for marking command names.  For the purposes of markup,
70 @c  no distinction is made between ``commands'' and ``procedures''.
71 @macro cmd{CMDNAME}
72 @code{\CMDNAME\}
73 @end macro
74
75 @c This macro is used for fragments of command syntax that are not in themselves command names.
76 @c It does not necessarily have to be a subcommand.
77 @macro subcmd{CMDNAME}
78 @code{\CMDNAME\}
79 @end macro
80
81 @c Use this macro to refer to PSPP itself .  Not when giving a shell command line example.
82 @macro pspp
83 @sc{pspp}
84 @end macro
85
86
87 @ifset MISSING_CLICKSEQUENCE
88 @alias clicksequence = asis
89 @macro click {}
90 ->
91 @end macro
92 @end ifset
93
94 @iftex
95 @finalout
96 @end iftex
97
98 @dircategory Math
99 @direntry
100 * PSPP: (pspp).             Statistical analysis package.
101 * PSPPIRE: (pspp).          Graphical user interface to @pspp{}.
102 @end direntry
103
104 @copying
105 This manual is for GNU PSPP version @value{VERSION},
106 software for statistical analysis.
107
108 Copyright @copyright{} 1997, 1998, 2004, 2005, 2009, 2012, 2013, 2014, 2016, 2019, 2020 Free Software Foundation, Inc.
109
110 @quotation
111 Permission is granted to copy, distribute and/or modify this document
112 under the terms of the GNU Free Documentation License, Version 1.3
113 or any later version published by the Free Software Foundation;
114 with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
115 A copy of the license is included in the section entitled "GNU
116 Free Documentation License".
117 @end quotation
118 @end copying
119
120 @titlepage
121 @title PSPP Users' Guide
122 @subtitle GNU PSPP Statistical Analysis Software
123 @subtitle Release @value{VERSION}
124 @page
125 @vskip 0pt plus 1filll
126 @insertcopying
127 @end titlepage
128
129 @contents
130
131
132 @ifnottex
133 @node Top
134 @top GNU PSPP
135
136 @insertcopying
137 @end ifnottex
138
139 @menu
140 * Introduction::                Description of the package.
141 * License::                     Your rights and obligations.
142
143 * Invoking PSPP::               Starting the PSPP text-based interface.
144 * Invoking PSPPIRE::            Starting the PSPP graphical user interface.
145 * Using PSPP::                  How to use PSPP --- A brief tutorial.
146 * Language::                    Basics of the PSPP command language.
147 * Expressions::                 Numeric and string expression syntax.
148
149 * Data Input and Output::       Reading data from user files.
150 * System and Portable File IO:: Reading and writing system & portable files.
151 * Combining Data Files::        Combining data from multiple files.
152 * Manipulating Variables::      Adjusting and examining variables.
153 * Data Manipulation::           Simple operations on data.
154 * Data Selection::              Select certain cases for analysis.
155 * Conditionals and Looping::    Doing things many times or not at all.
156 * Statistics::                  Basic statistical procedures.
157 * Utilities::                   Other commands.
158
159 * Invoking pspp-convert::       Utility for converting among file formats.
160 * Invoking pspp-output::        Utility for working with viewer (SPV) files.
161 * Invoking pspp-dump-sav::      Utility for examining raw .sav files.
162 * Not Implemented::             What's not here yet
163 * Bugs::                        Known problems; submitting bug reports.
164
165 * Function Index::              Index of PSPP functions for expressions.
166 * Command Index::               Index of PSPP procedures.
167 * Concept Index::               Index of concepts.
168
169 * GNU Free Documentation License:: License for copying this manual.
170 @end menu
171
172 @include introduction.texi
173 @include license.texi
174
175 @include invoking.texi
176 @include tutorial.texi
177 @include language.texi
178 @include expressions.texi
179 @include data-io.texi
180 @include files.texi
181 @include combining.texi
182 @include variables.texi
183 @include transformation.texi
184 @include data-selection.texi
185 @include flow-control.texi
186 @include statistics.texi
187 @include utilities.texi
188
189 @include pspp-convert.texi
190 @include pspp-output.texi
191 @include pspp-dump-sav.texi
192 @include not-implemented.texi
193 @include bugs.texi
194
195 @include function-index.texi
196 @include command-index.texi
197 @include concept-index.texi
198
199 @include fdl.texi
200
201 @bye