\input texinfo @c -*- texinfo -*-
@c PSPP - a program for statistical analysis.
@c Copyright (C) 2017, 2019, 2020, 2023 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 %**start of header
@setfilename pspp.info
@settitle PSPP
@c For double-sided printing, uncomment:
@c @setchapternewpage odd
@c %**end of header

@macro gui
graphic user interface
@end macro

@macro psppsyntax{FILE}
@html
<div class="pspp-syntax">
@end html
@cartouche
@smallexample
@verbatiminclude pspp-figures/\FILE\
@end smallexample
@end cartouche
@html
</div>
@end html
@end macro

@macro psppimage{FILE}
@cartouche
@ifhtml
@image{screenshots/\FILE\-ad} @c Adwaita theme is better for web pages.
@end ifhtml
@iftex
@image{screenshots/\FILE\-hc,433.62pt} @c High Contrast theme, width \\the\\hsize
@end iftex
@ifinfo
@image{screenshots/\FILE\-ad} @c Adwaita theme for stand aloneinfo
@end ifinfo
@end cartouche
@end macro

@macro psppoutput{FILE}
@c Use @image for Info and for plaintext output.
@ifinfo

@noindent @image{pspp-figures/\FILE\}

@end ifinfo
@ifplaintext

@noindent @image{pspp-figures/\FILE\}

@end ifplaintext
@c Use HTML for HTML output.
@ifhtml
@cartouche
@html

<div class="pspp">
@include pspp-figures/\FILE\.html
</div>

@end html
@end cartouche
@end ifhtml
@c Use the Texi-fied version of the plaintext output for other output formats.
@c Some of these could do better, but we have not yet implemented it.
@ifnotinfo
@ifnotplaintext
@ifnothtml
@smallexample
@include pspp-figures/\FILE\.texi
@end smallexample
@end ifnothtml
@end ifnotplaintext
@end ifnotinfo
@end macro

@macro note{param1}
@quotation
@strong{Please note:} \param1\
@end quotation
@end macro

@ifnottex
@macro times{}
×
@end macro
@macro ne{}
≠
@end macro
@end ifnottex

@c A macro to indicate variable names used in examples.
@c NOT metasyntactical variables - for that use @var
@macro exvar{VAR}
@b{\VAR\}
@end macro

@include version.texi

@c This macro should be used for marking command names.  For the purposes of markup,
@c  no distinction is made between ``commands'' and ``procedures''.
@macro cmd{CMDNAME}
@code{\CMDNAME\}
@end macro

@c This macro is used for fragments of command syntax that are not in themselves command names.
@c It does not necessarily have to be a subcommand.
@macro subcmd{CMDNAME}
@code{\CMDNAME\}
@end macro

@c Use this macro to refer to PSPP itself .  Not when giving a shell command line example.
@macro pspp
@sc{pspp}
@end macro

@iftex
@finalout
@end iftex

@dircategory Math
@direntry
* PSPP: (pspp).             Statistical analysis package.
* PSPPIRE: (pspp).          Graphical user interface to @pspp{}.
@end direntry

@copying
This manual is for GNU PSPP version @value{VERSION},
software for statistical analysis.

Copyright @copyright{} 1997, 1998, 2004, 2005, 2009, 2012, 2013, 2014, 2016, 2019, 2020, 2023 Free Software Foundation, Inc.

@quotation
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the section entitled "GNU
Free Documentation License".
@end quotation
@end copying

@titlepage
@title PSPP Users' Guide
@subtitle GNU PSPP Statistical Analysis Software
@subtitle Release @value{VERSION}
@page
@vskip 0pt plus 1filll
@insertcopying
@end titlepage

@contents


@ifnottex
@node Top
@top GNU PSPP

@insertcopying
@end ifnottex

@menu
* Introduction::                Description of the package.
* License::                     Your rights and obligations.

* Invoking PSPP::               Starting the PSPP text-based interface.
* Invoking PSPPIRE::            Starting the PSPP graphical user interface.
* Using PSPP::                  How to use PSPP --- A brief tutorial.
* Language::                    Basics of the PSPP command language.
* Expressions::                 Numeric and string expression syntax.

* Data Input and Output::       Reading data from user files.
* System and Portable File IO:: Reading and writing system & portable files.
* Combining Data Files::        Combining data from multiple files.
* Manipulating Variables::      Adjusting and examining variables.
* Data Manipulation::           Simple operations on data.
* Data Selection::              Select certain cases for analysis.
* Conditionals and Looping::    Doing things many times or not at all.
* Statistics::                  Basic statistical procedures.
* Matrices::                    Matrix operations and transformations.
* Utilities::                   Other commands.

* Invoking pspp-convert::       Utility for converting among file formats.
* Invoking pspp-output::        Utility for working with viewer (SPV) files.
* Invoking pspp-dump-sav::      Utility for examining raw .sav files.
* Not Implemented::             What's not here yet
* Bugs::                        Known problems; submitting bug reports.

* Function Index::              Index of PSPP functions for expressions.
* Command Index::               Index of PSPP procedures.
* Concept Index::               Index of concepts.

* GNU Free Documentation License:: License for copying this manual.
@end menu

@include introduction.texi
@include license.texi

@include invoking.texi
@include tutorial.texi
@include language.texi
@include expressions.texi
@include data-io.texi
@include files.texi
@include combining.texi
@include variables.texi
@include transformation.texi
@include data-selection.texi
@include flow-control.texi
@include statistics.texi
@include matrices.texi
@include utilities.texi

@include pspp-convert.texi
@include pspp-output.texi
@include pspp-dump-sav.texi
@include not-implemented.texi
@include bugs.texi

@include function-index.texi
@include command-index.texi
@include concept-index.texi

@include fdl.texi

@bye