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 psppimage{FILE}
  37 @cartouche
  38 @ifhtml
  39 @image{screenshots/\FILE\-ad} @c Adwaita theme is better for web pages.
  40 @end ifhtml
  41 @iftex
  42 @image{screenshots/\FILE\-hc,433.62pt} @c High Contrast theme, width \\the\\hsize
  43 @end iftex
  44 @ifinfo
  45 @image{screenshots/\FILE\-ad} @c Adwaita theme for stand aloneinfo
  46 @end ifinfo
  47 @end cartouche
  48 @end macro
  49
  50 @macro psppoutput{FILE}
  51 @c Use @image for Info and for plaintext output.
  52 @ifinfo
  53
  54 @noindent @image{pspp-figures/\FILE\}
  55
  56 @end ifinfo
  57 @ifplaintext
  58
  59 @noindent @image{pspp-figures/\FILE\}
  60
  61 @end ifplaintext
  62 @c Use HTML for HTML output.
  63 @ifhtml
  64 @cartouche
  65 @html
  66
  67 <div class="pspp">
  68 @include pspp-figures/\FILE\.html
  69 </div>
  70
  71 @end html
  72 @end cartouche
  73 @end ifhtml
  74 @c Use the Texi-fied version of the plaintext output for other output formats.
  75 @c Some of these could do better, but we have not yet implemented it.
  76 @ifnotinfo
  77 @ifnotplaintext
  78 @ifnothtml
  79 @smallexample
  80 @include pspp-figures/\FILE\.texi
  81 @end smallexample
  82 @end ifnothtml
  83 @end ifnotplaintext
  84 @end ifnotinfo
  85 @end macro
  86
  87 @macro note{param1}
  88 @quotation
  89 @strong{Please note:} \param1\
  90 @end quotation
  91 @end macro
  92
  93 @ifnottex
  94 @macro times{}
  95 ×
  96 @end macro
  97 @macro ne{}
  98 ≠
  99 @end macro
 100 @end ifnottex
 101
 102 @c A macro to indicate variable names used in examples.
 103 @c NOT metasyntactical variables - for that use @var
 104 @macro exvar{VAR}
 105 @b{\VAR\}
 106 @end macro
 107
 108 @include version.texi
 109
 110 @c This macro should be used for marking command names.  For the purposes of markup,
 111 @c  no distinction is made between ``commands'' and ``procedures''.
 112 @macro cmd{CMDNAME}
 113 @code{\CMDNAME\}
 114 @end macro
 115
 116 @c This macro is used for fragments of command syntax that are not in themselves command names.
 117 @c It does not necessarily have to be a subcommand.
 118 @macro subcmd{CMDNAME}
 119 @code{\CMDNAME\}
 120 @end macro
 121
 122 @c Use this macro to refer to PSPP itself .  Not when giving a shell command line example.
 123 @macro pspp
 124 @sc{pspp}
 125 @end macro
 126
 127 @iftex
 128 @finalout
 129 @end iftex
 130
 131 @dircategory Math
 132 @direntry
 133 * PSPP: (pspp).             Statistical analysis package.
 134 * PSPPIRE: (pspp).          Graphical user interface to @pspp{}.
 135 @end direntry
 136
 137 @copying
 138 This manual is for GNU PSPP version @value{VERSION},
 139 software for statistical analysis.
 140
 141 Copyright @copyright{} 1997, 1998, 2004, 2005, 2009, 2012, 2013, 2014, 2016, 2019, 2020 Free Software Foundation, Inc.
 142
 143 @quotation
 144 Permission is granted to copy, distribute and/or modify this document
 145 under the terms of the GNU Free Documentation License, Version 1.3
 146 or any later version published by the Free Software Foundation;
 147 with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
 148 A copy of the license is included in the section entitled "GNU
 149 Free Documentation License".
 150 @end quotation
 151 @end copying
 152
 153 @titlepage
 154 @title PSPP Users' Guide
 155 @subtitle GNU PSPP Statistical Analysis Software
 156 @subtitle Release @value{VERSION}
 157 @page
 158 @vskip 0pt plus 1filll
 159 @insertcopying
 160 @end titlepage
 161
 162 @contents
 163
 164
 165 @ifnottex
 166 @node Top
 167 @top GNU PSPP
 168
 169 @insertcopying
 170 @end ifnottex
 171
 172 @menu
 173 * Introduction::                Description of the package.
 174 * License::                     Your rights and obligations.
 175
 176 * Invoking PSPP::               Starting the PSPP text-based interface.
 177 * Invoking PSPPIRE::            Starting the PSPP graphical user interface.
 178 * Using PSPP::                  How to use PSPP --- A brief tutorial.
 179 * Language::                    Basics of the PSPP command language.
 180 * Expressions::                 Numeric and string expression syntax.
 181
 182 * Data Input and Output::       Reading data from user files.
 183 * System and Portable File IO:: Reading and writing system & portable files.
 184 * Combining Data Files::        Combining data from multiple files.
 185 * Manipulating Variables::      Adjusting and examining variables.
 186 * Data Manipulation::           Simple operations on data.
 187 * Data Selection::              Select certain cases for analysis.
 188 * Conditionals and Looping::    Doing things many times or not at all.
 189 * Statistics::                  Basic statistical procedures.
 190 * Matrices::                    Matrix operations and transformations.
 191 * Utilities::                   Other commands.
 192
 193 * Invoking pspp-convert::       Utility for converting among file formats.
 194 * Invoking pspp-output::        Utility for working with viewer (SPV) files.
 195 * Invoking pspp-dump-sav::      Utility for examining raw .sav files.
 196 * Not Implemented::             What's not here yet
 197 * Bugs::                        Known problems; submitting bug reports.
 198
 199 * Function Index::              Index of PSPP functions for expressions.
 200 * Command Index::               Index of PSPP procedures.
 201 * Concept Index::               Index of concepts.
 202
 203 * GNU Free Documentation License:: License for copying this manual.
 204 @end menu
 205
 206 @include introduction.texi
 207 @include license.texi
 208
 209 @include invoking.texi
 210 @include tutorial.texi
 211 @include language.texi
 212 @include expressions.texi
 213 @include data-io.texi
 214 @include files.texi
 215 @include combining.texi
 216 @include variables.texi
 217 @include transformation.texi
 218 @include data-selection.texi
 219 @include flow-control.texi
 220 @include statistics.texi
 221 @include matrices.texi
 222 @include utilities.texi
 223
 224 @include pspp-convert.texi
 225 @include pspp-output.texi
 226 @include pspp-dump-sav.texi
 227 @include not-implemented.texi
 228 @include bugs.texi
 229
 230 @include function-index.texi
 231 @include command-index.texi
 232 @include concept-index.texi
 233
 234 @include fdl.texi
 235
 236 @bye