sys-file-reader: Accept document records with no document lines.
[pspp] / doc / pspp.texi
1 \input texinfo @c -*- texinfo -*-
2 @c PSPP - a program for statistical analysis.
3 @c Copyright (C) 2017 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
19 @macro note{param1}
20 @quotation
21 @strong{Please note:} \param1\
22 @end quotation
23 @end macro
24
25 @include version.texi
26
27 @c This macro should be used for marking command names.  For the purposes of markup, 
28 @c  no distinction is made between ``commands'' and ``procedures''.
29 @macro cmd{CMDNAME}
30 @code{\CMDNAME\}
31 @end macro
32
33 @c This macro is used for fragments of command syntax that are not in themselves command names.
34 @c It does not necessarily have to be a subcommand.
35 @macro subcmd{CMDNAME}
36 @code{\CMDNAME\}
37 @end macro
38
39 @c Use this macro to refer to PSPP itself .  Not when giving a shell command line example.
40 @macro pspp
41 @sc{pspp}
42 @end macro
43
44
45 @ifset MISSING_CLICKSEQUENCE
46 @alias clicksequence = asis
47 @macro click {}
48 ->
49 @end macro
50 @end ifset
51
52 @iftex
53 @finalout
54 @end iftex
55
56 @dircategory Math
57 @direntry
58 * PSPP: (pspp).             Statistical analysis package.
59 * PSPPIRE: (pspp).          Graphical user interface to @pspp{}.
60 @end direntry
61
62 @copying
63 This manual is for GNU PSPP version @value{VERSION},
64 software for statistical analysis.
65
66 Copyright @copyright{} 1997, 1998, 2004, 2005, 2009, 2012, 2013, 2014, 2016 Free Software Foundation, Inc.
67
68 @quotation
69 Permission is granted to copy, distribute and/or modify this document
70 under the terms of the GNU Free Documentation License, Version 1.3
71 or any later version published by the Free Software Foundation;
72 with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
73 A copy of the license is included in the section entitled "GNU
74 Free Documentation License".
75 @end quotation
76 @end copying
77
78 @titlepage
79 @title PSPP Users' Guide
80 @subtitle GNU PSPP Statistical Analysis Software
81 @subtitle Release @value{VERSION}
82 @page
83 @vskip 0pt plus 1filll
84 @insertcopying
85 @end titlepage
86
87 @c @chapheading Acknowledgements
88 The authors wish to thank Network Theory Ltd 
89 @url{http://www.network-theory.co.uk}
90 for their financial support 
91 in the production of this manual.
92
93
94 @contents
95
96
97 @ifnottex
98 @node Top
99 @top GNU PSPP
100
101 @insertcopying
102 @end ifnottex
103
104 @menu
105 * Introduction::                Description of the package.
106 * License::                     Your rights and obligations.
107
108 * Invoking PSPP::               Starting the PSPP text-based interface.
109 * Invoking PSPPIRE::            Starting the PSPP graphical user interface.
110 * Using PSPP::                  How to use PSPP --- A brief tutorial.
111 * Language::                    Basics of the PSPP command language.
112 * Expressions::                 Numeric and string expression syntax.
113
114 * Data Input and Output::       Reading data from user files.
115 * System and Portable File IO:: Reading and writing system & portable files.
116 * Combining Data Files::        Combining data from multiple files.
117 * Variable Attributes::         Adjusting and examining variables.
118 * Data Manipulation::           Simple operations on data.
119 * Data Selection::              Select certain cases for analysis.
120 * Conditionals and Looping::    Doing things many times or not at all.
121 * Statistics::                  Basic statistical procedures.
122 * Utilities::                   Other commands.
123
124 * Invoking pspp-convert::       Utility for converting among file formats.
125 * Invoking pspp-dump-sav::      Utility for examining raw .sav files.
126 * Not Implemented::             What's not here yet
127 * Bugs::                        Known problems; submitting bug reports.
128
129 * Function Index::              Index of PSPP functions for expressions.
130 * Command Index::               Index of PSPP procedures.
131 * Concept Index::               Index of concepts.
132
133 * GNU Free Documentation License:: License for copying this manual.
134 @end menu
135
136 @include introduction.texi
137 @include license.texi
138
139 @include invoking.texi
140 @include tutorial.texi
141 @include language.texi
142 @include expressions.texi
143 @include data-io.texi
144 @include files.texi
145 @include combining.texi
146 @include variables.texi
147 @include transformation.texi
148 @include data-selection.texi
149 @include flow-control.texi
150 @include statistics.texi
151 @include utilities.texi
152
153 @include pspp-convert.texi
154 @include pspp-dump-sav.texi
155 @include not-implemented.texi
156 @include bugs.texi
157
158 @include function-index.texi
159 @include command-index.texi
160 @include concept-index.texi
161
162 @include fdl.texi
163
164 @bye
165
166 @c Local Variables:
167 @c use (texinfo-multiple-files-update "pspp.texi")  in emacs to keep these files consistent
168 @c compile-command: "makeinfo pspp.texi"
169 @c End: