Add support for reading and writing SPV files.
[pspp] / doc / utilities.texi
index eb30f892d570444a5036fb963090762b617e720a..598431d5efa43c40daf960dcfaa4bb5b549b4b01 100644 (file)
@@ -1,3 +1,12 @@
+@c PSPP - a program for statistical analysis.
+@c Copyright (C) 2017 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 Utilities
 @chapter Utilities
 
@@ -344,7 +353,7 @@ otherwise it is @code{Auto}.
 @display
 OUTPUT MODIFY
        /SELECT TABLES
-       /TABLECELLS SELECT = [ @{SIGNIFICANCE, COUNT@} ]
+       /TABLECELLS SELECT = [ @var{class}... ]
                    FORMAT = @var{fmt_spec}.
 @end display
 @note{In the above synopsis the characters @samp{[} and @samp{]} are literals.
@@ -361,13 +370,27 @@ brackets.  This list determines the classes of values should be selected for mod
 Each class can be:
 
 @table @asis
+@item RESIDUAL
+Residual values.  Default: @t{F40.2}.
+
+@item CORRELATION
+Correlations.  Default: @t{F40.3}.
+
+@item PERCENT
+Percentages.  Default: @t{PCT40.1}.
+
 @item SIGNIFICANCE
-Significance of tests (p-values).
+Significance of tests (p-values).  Default: @t{F40.3}.
 
 @item COUNT
-Counts or sums of weights.
+Counts or sums of weights.  For a weighted data set, the default is
+the weight variable's print format.  For an unweighted data set, the
+default is F40.0.
 @end table
 
+For most other numeric values that appear in tables, @code{SET FORMAT}
+may be used to specify the format (@pxref{SET FORMAT}).
+
 The value of @var{fmt_spec} must be a valid output format (@pxref{Input and Output Formats}).
 Note that not all possible formats are meaningful for all classes.
 
@@ -517,9 +540,12 @@ Setting it to @subcmd{DOT} causes the decimal point character to be
 Setting it to @subcmd{COMMA}
 causes the decimal point character to be @samp{,} and the grouping
 character to be @samp{.}.
+If the setting is @subcmd{COMMA}, then @samp{,} will not be treated
+as a field separator in the @cmd{DATA LIST} command (@pxref{DATA LIST}).
 The default value is determined from the system locale.
 
 @item FORMAT
+@anchor{SET FORMAT}
 Allows the default numeric input/output format to be specified.  The
 default is F8.2.  @xref{Input and Output Formats}.
 
@@ -863,7 +889,7 @@ SET LOCALE='ru_RU.cp1251'.
 SET LOCALE='japanese'.
 @end example
 
-Contrary to the intuition, this command does not affect any aspect 
+Contrary to intuition, this command does not affect any aspect 
 of the system's locale.
 @end table