X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Futilities.texi;h=db96725900d8bd8f6a89a533a3280d5805f3ebdf;hb=596aa20a73b528bf0644bcfd9e49a3188be64c6b;hp=eb30f892d570444a5036fb963090762b617e720a;hpb=9743aa05898c191b3c2d3fead5ae0315beb44bb3;p=pspp

diff --git a/doc/utilities.texi b/doc/utilities.texi
index eb30f892d5..db96725900 100644
--- a/doc/utilities.texi
+++ b/doc/utilities.texi
@@ -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
 
@@ -109,11 +118,12 @@ DOCUMENTS}.  They can be removed from the active dataset with @cmd{DROP
 DOCUMENTS}.
 
 Specify the @var{documentary text} following the @subcmd{DOCUMENT} keyword.  
-It is interpreted literally --- any quotes or other punctuation marks 
+It is interpreted literally---any quotes or other punctuation marks
 will be included in the file.
-You can extend the documentary text over as many lines as necessary.  
+You can extend the documentary text over as many lines as necessary,
+including blank lines to separate paragraphs.
 Lines are truncated at 80 bytes.  Don't forget to terminate
-the command with a dot or a blank line. @xref{ADD DOCUMENT}.
+the command with a dot at the end of a line. @xref{ADD DOCUMENT}.
 
 @node DISPLAY DOCUMENTS
 @section DISPLAY DOCUMENTS
@@ -344,7 +354,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 +371,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.
 
@@ -458,7 +482,6 @@ SET
 (output driver options)
         /HEADERS=@{NO,YES,BLANK@}
         /LENGTH=@{NONE,@var{n_lines}@}
-        /MORE=@{ON,OFF@}
         /WIDTH=@{NARROW,WIDTH,@var{n_characters}@}
         /TNUMBERS=@{VALUES,LABELS,BOTH@}
         /TVARS=@{NAMES,LABELS,BOTH@}
@@ -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}.
 
@@ -754,7 +780,6 @@ subcommands are
 @table @asis
 @item HEADERS
 @itemx LENGTH
-@itemx MORE
 @itemx WIDTH
 @itemx TNUMBERS
 The @subcmd{TNUMBERS} option sets the way in which values are displayed in output tables.
@@ -779,7 +804,6 @@ If @subcmd{TVARS} is set to @subcmd{BOTH}, then variables will be displayed with
 
 @cindex headers
 @cindex length
-@cindex more
 @cindex pager 
 @cindex width
 @cindex tnumbers
@@ -863,7 +887,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