Add copyright and licence notices to files which lack them.

[pspp] / doc / utilities.texi

diff --git a/doc/utilities.texi b/doc/utilities.texi
index b40d8c8e673bd62446c803f9ef2bedb01ef3c5bd..c2dba0e4799653cba2f1a874c40b369a143b03a8 100644 (file)
--- 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
 
 @node Utilities
 @chapter Utilities
 


@@ -25,6 +34,7 @@ encountered in the input.
 * HOST::                        Temporarily return to the operating system.
 * INCLUDE::                     Include a file within the current one.
 * INSERT::                      Insert a file within the current one.
 * HOST::                        Temporarily return to the operating system.
 * INCLUDE::                     Include a file within the current one.
 * INSERT::                      Insert a file within the current one.

+* OUTPUT::                      Modify the appearance of the output.

 * PERMISSIONS::                 Change permissions on a file.
 * PRESERVE and RESTORE::        Saving settings and restoring them later.
 * SET::                         Adjust @pspp{} runtime parameters.
 * PERMISSIONS::                 Change permissions on a file.
 * PRESERVE and RESTORE::        Saving settings and restoring them later.
 * SET::                         Adjust @pspp{} runtime parameters.


@@ -34,7 +44,6 @@ encountered in the input.
 @end menu
 
 @node ADD DOCUMENT
 @end menu
 
 @node ADD DOCUMENT

-@comment  node-name,  next,  previous,  up

 @section ADD DOCUMENT
 @vindex  ADD DOCUMENT
 
 @section ADD DOCUMENT
 @vindex  ADD DOCUMENT
 


@@ -108,7 +117,7 @@ They can be viewed using @cmd{SYSFILE INFO} or @cmd{DISPLAY
 DOCUMENTS}.  They can be removed from the active dataset with @cmd{DROP
 DOCUMENTS}.
 
 DOCUMENTS}.  They can be removed from the active dataset with @cmd{DROP
 DOCUMENTS}.
 

-Specify the @var{documentary text} following the DOCUMENT keyword.  
+Specify the @var{documentary text} following the @subcmd{DOCUMENT} keyword.  

 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.  
 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.  


@@ -166,17 +175,16 @@ ECHO 'arbitrary text' .
 Use @cmd{ECHO} to write arbitrary text to the output stream. The text should be enclosed in quotation marks following the normal rules for string tokens (@pxref{Tokens}).
 
 @node ERASE
 Use @cmd{ECHO} to write arbitrary text to the output stream. The text should be enclosed in quotation marks following the normal rules for string tokens (@pxref{Tokens}).
 
 @node ERASE

-@comment  node-name,  next,  previous,  up

 @section ERASE
 @vindex ERASE
 
 @display
 @section ERASE
 @vindex ERASE
 
 @display

-ERASE FILE file_name.
+ERASE FILE @var{file_name}.

 @end display
 
 @cmd{ERASE FILE} deletes a file from the local filesystem.
 @end display
 
 @cmd{ERASE FILE} deletes a file from the local filesystem.

-file_name must be quoted.
-This command cannot be used if the SAFER setting is active.
+@var{file_name} must be quoted.
+This command cannot be used if the SAFER (@pxref{SET}) setting is active.

 
 
 @node EXECUTE
 
 
 @node EXECUTE


@@ -195,15 +203,15 @@ transformations to be executed.
 @vindex FILE LABEL
 
 @display
 @vindex FILE LABEL
 
 @display

-FILE LABEL file_label.
+FILE LABEL @var{file_label}.

 @end display
 
 @cmd{FILE LABEL} provides a title for the active dataset.  This
 title will be saved into system files and portable files that are
 created during this @pspp{} run.
 
 @end display
 
 @cmd{FILE LABEL} provides a title for the active dataset.  This
 title will be saved into system files and portable files that are
 created during this @pspp{} run.
 

-file_label need not be quoted.  If quotes are
-included, they become part of the file label.
+@var{file_label} should not be quoted.
+If quotes are included, they are literally interpreted and become part of the file label.

 
 @node FINISH
 @section FINISH
 
 @node FINISH
 @section FINISH


@@ -217,20 +225,19 @@ FINISH.
 control to the operating system.
 
 @node HOST
 control to the operating system.
 
 @node HOST

-@comment  node-name,  next,  previous,  up

 @section HOST
 @vindex HOST
 
 @display
 HOST.
 @section HOST
 @vindex HOST
 
 @display
 HOST.

-HOST COMMAND=['command'...].
+HOST COMMAND=['@var{command}'...].

 @end display
 
 @cmd{HOST} suspends the current @pspp{} session and temporarily returns control 
 to the operating system.
 @end display
 
 @cmd{HOST} suspends the current @pspp{} session and temporarily returns control 
 to the operating system.

-This command cannot be used if the SAFER setting is active.
+This command cannot be used if the SAFER (@pxref{SET}) setting is active.

 
 

-If the COMMAND subcommand is specified, as a sequence of shell
+If the @subcmd{COMMAND} subcommand is specified, as a sequence of shell

 commands as quoted strings within square brackets, then @pspp{} executes
 them together in a single subshell.
 
 commands as quoted strings within square brackets, then @pspp{} executes
 them together in a single subshell.
 


@@ -242,7 +249,7 @@ subshell.
 @vindex INCLUDE
 
 @display
 @vindex INCLUDE
 
 @display

-        INCLUDE [FILE=]'file-name' [ENCODING='encoding'].
+        INCLUDE [FILE=]'@var{file_name}' [ENCODING='@var{encoding}'].

 @end display
 
 @cmd{INCLUDE} causes the @pspp{} command processor to read an
 @end display
 
 @cmd{INCLUDE} causes the @pspp{} command processor to read an


@@ -254,21 +261,21 @@ Include files may be nested to any depth, up to the limit of available
 memory.
 
 The @cmd{INSERT} command (@pxref{INSERT}) is a more flexible
 memory.
 
 The @cmd{INSERT} command (@pxref{INSERT}) is a more flexible

-alternative to @cmd{INCLUDE}.  An INCLUDE command acts the same as
-INSERT with ERROR=STOP CD=NO SYNTAX=BATCH specified.
+alternative to @cmd{INCLUDE}.  An @cmd{INCLUDE} command acts the same as
+@cmd{INSERT} with @subcmd{ERROR=STOP CD=NO SYNTAX=BATCH} specified.

 
 

-The optional ENCODING subcommand has the same meaning as on INSERT.
+The optional @subcmd{ENCODING} subcommand has the same meaning as with @cmd{INSERT}.

 
 @node INSERT
 @section INSERT
 @vindex INSERT
 
 @display
 
 @node INSERT
 @section INSERT
 @vindex INSERT
 
 @display

-     INSERT [FILE=]'file-name'
+     INSERT [FILE=]'@var{file_name}'

         [CD=@{NO,YES@}]
         [ERROR=@{CONTINUE,STOP@}]
         [SYNTAX=@{BATCH,INTERACTIVE@}]
         [CD=@{NO,YES@}]
         [ERROR=@{CONTINUE,STOP@}]
         [SYNTAX=@{BATCH,INTERACTIVE@}]

-        [ENCODING='encoding'].
+        [ENCODING=@{LOCALE, '@var{charset_name}'@}].

 @end display
 
 @cmd{INSERT} is similar to @cmd{INCLUDE} (@pxref{INCLUDE}) 
 @end display
 
 @cmd{INSERT} is similar to @cmd{INCLUDE} (@pxref{INCLUDE}) 


@@ -276,7 +283,7 @@ but somewhat more flexible.
 It causes the command processor to read a file as if it were embedded in the 
 current command file.
 
 It causes the command processor to read a file as if it were embedded in the 
 current command file.
 

-If @samp{CD=YES} is specified, then before including the file, the
+If @subcmd{CD=YES} is specified, then before including the file, the

 current directory  will be changed to the directory of the included
 file.  
 The default setting is @samp{CD=NO}.
 current directory  will be changed to the directory of the included
 file.  
 The default setting is @samp{CD=NO}.


@@ -286,28 +293,29 @@ changed explicitly (with the @cmd{CD} command, or a subsequent
 It will not revert to its original setting even after the included
 file is finished processing.
 
 It will not revert to its original setting even after the included
 file is finished processing.
 

-If @samp{ERROR=STOP} is specified, errors encountered in the
+If @subcmd{ERROR=STOP} is specified, errors encountered in the

 inserted file will cause processing to immediately cease.
 Otherwise processing will continue at the next command.
 inserted file will cause processing to immediately cease.
 Otherwise processing will continue at the next command.

-The default setting is @samp{ERROR=CONTINUE}.
+The default setting is @subcmd{ERROR=CONTINUE}.

 
 

-If @samp{SYNTAX=INTERACTIVE} is specified then the syntax contained in
+If @subcmd{SYNTAX=INTERACTIVE} is specified then the syntax contained in

 the included file must conform to interactive syntax
 conventions. @xref{Syntax Variants}.
 the included file must conform to interactive syntax
 conventions. @xref{Syntax Variants}.

-The default setting is @samp{SYNTAX=BATCH}.
+The default setting is @subcmd{SYNTAX=BATCH}.

 
 

-ENCODING optionally specifies the character set used by the included
+@subcmd{ENCODING} optionally specifies the character set used by the included

 file.  Its argument, which is not case-sensitive, must be in one of
 the following forms:
 
 @table @asis
 file.  Its argument, which is not case-sensitive, must be in one of
 the following forms:
 
 @table @asis

-@item @code{Locale}
-The encoding used by the system locale, or as overridden by the SET
-LOCALE command (@pxref{SET}).  On Unix systems, environment variables,
-e.g.@: @env{LANG} or @env{LC_ALL}, determine the system locale.
-
-@item IANA character set name
-One of the character set names listed by IANA at
+@item @subcmd{LOCALE}
+The encoding used by the system locale, or as overridden by the 
+@cmd{SET} command (@pxref{SET}).  On GNU/Linux and other Unix-like systems,
+environment variables, e.g.@: @env{LANG} or @env{LC_ALL}, determine the
+system locale.
+
+@item @var{charset_name}
+One of the character set names listed by @acronym{IANA} at

 @uref{http://www.iana.org/assignments/character-sets}.  Some examples
 are @code{ASCII} (United States), @code{ISO-8859-1} (western Europe),
 @code{EUC-JP} (Japan), and @code{windows-1252} (Windows).  Not all
 @uref{http://www.iana.org/assignments/character-sets}.  Some examples
 are @code{ASCII} (United States), @code{ISO-8859-1} (western Europe),
 @code{EUC-JP} (Japan), and @code{windows-1252} (Windows).  Not all


@@ -316,26 +324,62 @@ systems support all character sets.
 @item @code{Auto,@var{encoding}}
 Automatically detects whether a syntax file is encoded in an Unicode
 encoding such as UTF-8, UTF-16, or UTF-32.  If it is not, then @pspp{}
 @item @code{Auto,@var{encoding}}
 Automatically detects whether a syntax file is encoded in an Unicode
 encoding such as UTF-8, UTF-16, or UTF-32.  If it is not, then @pspp{}

-generally assumes that the file is encoded in @var{encoding} (an IANA
+generally assumes that the file is encoded in @var{encoding} (an @acronym{IANA}

 character set name).  However, if @var{encoding} is UTF-8, and the
 syntax file is not valid UTF-8, @pspp{} instead assumes that the file
 is encoded in @code{windows-1252}.
 
 character set name).  However, if @var{encoding} is UTF-8, and the
 syntax file is not valid UTF-8, @pspp{} instead assumes that the file
 is encoded in @code{windows-1252}.
 

-For best results, @var{encoding} should be an ASCII-compatible
-encoding (the most common locale encodings are all ASCII-compatible),
-because encodings that are not ASCII compatible cannot be
+For best results, @var{encoding} should be an @acronym{ASCII}-compatible
+encoding (the most common locale encodings are all @acronym{ASCII}-compatible),
+because encodings that are not @acronym{ASCII} compatible cannot be

 automatically distinguished from UTF-8.
 
 @item @code{Auto}
 @item @code{Auto,Locale}
 Automatic detection, as above, with the default encoding taken from
 automatically distinguished from UTF-8.
 
 @item @code{Auto}
 @item @code{Auto,Locale}
 Automatic detection, as above, with the default encoding taken from

-the system locale or the setting on SET LOCALE.
+the system locale or the setting on @subcmd{SET LOCALE}.

 @end table
 
 When ENCODING is not specified, the default is taken from the
 @option{--syntax-encoding} command option, if it was specified, and
 otherwise it is @code{Auto}.
 
 @end table
 
 When ENCODING is not specified, the default is taken from the
 @option{--syntax-encoding} command option, if it was specified, and
 otherwise it is @code{Auto}.
 

+@node OUTPUT
+@section OUTPUT
+@vindex OUTPUT
+@cindex precision, of output
+@cindex decimal places
+
+@display
+OUTPUT MODIFY
+       /SELECT TABLES
+       /TABLECELLS SELECT = [ @{SIGNIFICANCE, COUNT@} ]
+                   FORMAT = @var{fmt_spec}.
+@end display
+@note{In the above synopsis the characters @samp{[} and @samp{]} are literals.
+They must appear in the syntax to be interpreted.}
+
+@cmd{OUTPUT} changes the appearance of the tables in which results are printed.
+In particular, it can be used to set the format and precision to which results are displayed.
+
+After running this command, the default table appearance parameters will have been modified and  each 
+new output table generated will use the new parameters.
+
+Following @code{/TABLECELLS SELECT =} a list of cell classes must appear, enclosed in square
+brackets.  This list determines the classes of values should be selected for modification.
+Each class can be:
+
+@table @asis
+@item SIGNIFICANCE
+Significance of tests (p-values).
+
+@item COUNT
+Counts or sums of weights.
+@end table
+
+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.
+

 @node PERMISSIONS
 @section PERMISSIONS
 @vindex PERMISSIONS
 @node PERMISSIONS
 @section PERMISSIONS
 @vindex PERMISSIONS


@@ -345,19 +389,19 @@ otherwise it is @code{Auto}.
 
 @display
 PERMISSIONS
 
 @display
 PERMISSIONS

-        FILE='file-name'
+        FILE='@var{file_name}'

         /PERMISSIONS = @{READONLY,WRITEABLE@}.
 @end display
 
 @cmd{PERMISSIONS} changes the permissions of a file.  
 There is one mandatory subcommand which specifies the permissions to
 which the file should be changed.  
         /PERMISSIONS = @{READONLY,WRITEABLE@}.
 @end display
 
 @cmd{PERMISSIONS} changes the permissions of a file.  
 There is one mandatory subcommand which specifies the permissions to
 which the file should be changed.  

-If you set a file's  permission  to READONLY, then the file will become
+If you set a file's  permission  to @subcmd{READONLY}, then the file will become

 unwritable either by you or anyone else on the system.
 unwritable either by you or anyone else on the system.

-If you set the permission to WRITEABLE, then the file will become
+If you set the permission to @subcmd{WRITEABLE}, then the file will become

 writeable by you; the permissions afforded to others will be
 unchanged.
 writeable by you; the permissions afforded to others will be
 unchanged.

-This command cannot be used if the SAFER setting is active.
+This command cannot be used if the @subcmd{SAFER} (@pxref{SET}) setting is active.

 
 
 @node PRESERVE and RESTORE
 
 
 @node PRESERVE and RESTORE


@@ -386,30 +430,31 @@ SET
 (data input)
         /BLANKS=@{SYSMIS,'.',number@}
         /DECIMAL=@{DOT,COMMA@}
 (data input)
         /BLANKS=@{SYSMIS,'.',number@}
         /DECIMAL=@{DOT,COMMA@}

-        /FORMAT=fmt_spec
-        /EPOCH=@{AUTOMATIC,year@}
+        /FORMAT=@var{fmt_spec}
+        /EPOCH=@{AUTOMATIC,@var{year}@}

         /RIB=@{NATIVE,MSBFIRST,LSBFIRST,VAX@}
         /RRB=@{NATIVE,ISL,ISB,IDL,IDB,VF,VD,VG,ZS,ZL@}
 
 (interaction)
         /RIB=@{NATIVE,MSBFIRST,LSBFIRST,VAX@}
         /RRB=@{NATIVE,ISL,ISB,IDL,IDB,VF,VD,VG,ZS,ZL@}
 
 (interaction)

-        /MXERRS=max_errs
-        /MXWARNS=max_warnings
-        /WORKSPACE=workspace_size
+        /MXERRS=@var{max_errs}
+        /MXWARNS=@var{max_warnings}
+        /WORKSPACE=@var{workspace_size}

 
 (syntax execution)
 
 (syntax execution)

-        /LOCALE='locale'
+        /LOCALE='@var{locale}'

         /MEXPAND=@{ON,OFF@}
         /MEXPAND=@{ON,OFF@}

-        /MITERATE=max_iterations
-        /MNEST=max_nest
+        /MITERATE=@var{max_iterations}
+        /MNEST=@var{max_nest}

         /MPRINT=@{ON,OFF@}
         /MPRINT=@{ON,OFF@}

-        /MXLOOPS=max_loops
-        /SEED=@{RANDOM,seed_value@}
+        /MXLOOPS=@var{max_loops}
+        /SEED=@{RANDOM,@var{seed_value}@}

         /UNDEFINED=@{WARN,NOWARN@}
         /UNDEFINED=@{WARN,NOWARN@}

+        /FUZZBITS=@var{fuzzbits}

 
 (data output)
 
 (data output)

-        /CC@{A,B,C,D,E@}=@{'npre,pre,suf,nsuf','npre.pre.suf.nsuf'@}
+        /CC@{A,B,C,D,E@}=@{'@var{npre},@var{pre},@var{suf},@var{nsuf}','@var{npre}.@var{pre}.@var{suf}.@var{nsuf}'@}

         /DECIMAL=@{DOT,COMMA@}
         /DECIMAL=@{DOT,COMMA@}

-        /FORMAT=fmt_spec
+        /FORMAT=@var{fmt_spec}

         /WIB=@{NATIVE,MSBFIRST,LSBFIRST,VAX@}
         /WRB=@{NATIVE,ISL,ISB,IDL,IDB,VF,VD,VG,ZS,ZL@}
 
         /WIB=@{NATIVE,MSBFIRST,LSBFIRST,VAX@}
         /WRB=@{NATIVE,ISL,ISB,IDL,IDB,VF,VD,VG,ZS,ZL@}
 


@@ -421,13 +466,14 @@ SET
 
 (output driver options)
         /HEADERS=@{NO,YES,BLANK@}
 
 (output driver options)
         /HEADERS=@{NO,YES,BLANK@}

-        /LENGTH=@{NONE,length_in_lines@}
+        /LENGTH=@{NONE,@var{n_lines}@}

         /MORE=@{ON,OFF@}
         /MORE=@{ON,OFF@}

-        /WIDTH=@{NARROW,WIDTH,n_characters@}
+        /WIDTH=@{NARROW,WIDTH,@var{n_characters}@}

         /TNUMBERS=@{VALUES,LABELS,BOTH@}
         /TNUMBERS=@{VALUES,LABELS,BOTH@}

+        /TVARS=@{NAMES,LABELS,BOTH@}

 
 (logging)
 
 (logging)

-        /JOURNAL=@{ON,OFF@} ['file-name']
+        /JOURNAL=@{ON,OFF@} ['@var{file_name}']

 
 (system files)
         /COMPRESSION=@{ON,OFF@}
 
 (system files)
         /COMPRESSION=@{ON,OFF@}


@@ -435,22 +481,22 @@ SET
 
 (miscellaneous)
         /SAFER=ON
 
 (miscellaneous)
         /SAFER=ON

-        /LOCALE='string'
+        /LOCALE='@var{string}'

 
 
 (obsolete settings accepted for compatibility, but ignored)
 
 
 (obsolete settings accepted for compatibility, but ignored)

-        /BOXSTRING=@{'xxx','xxxxxxxxxxx'@}
+        /BOXSTRING=@{'@var{xxx}','@var{xxxxxxxxxxx}'@}

         /CASE=@{UPPER,UPLOW@}
         /CPI=cpi_value
         /HIGHRES=@{ON,OFF@}
         /CASE=@{UPPER,UPLOW@}
         /CPI=cpi_value
         /HIGHRES=@{ON,OFF@}

-        /HISTOGRAM='c'
+        /HISTOGRAM='@var{c}'

         /LOWRES=@{AUTO,ON,OFF@}
         /LOWRES=@{AUTO,ON,OFF@}

-        /LPI=lpi_value
+        /LPI=@var{lpi_value}

         /MENUS=@{STANDARD,EXTENDED@}
         /MENUS=@{STANDARD,EXTENDED@}

-        /MXMEMORY=max_memory
+        /MXMEMORY=@var{max_memory}

         /SCRIPTTAB='c'
         /SCRIPTTAB='c'

-        /TB1=@{'xxx','xxxxxxxxxxx'@}
-        /TBFONTS='string'
+        /TB1=@{'@var{xxx}','@var{xxxxxxxxxxx}'@}
+        /TBFONTS='@var{string}'

         /XSORT=@{YES,NO@}
 @end display
 
         /XSORT=@{YES,NO@}
 @end display
 


@@ -458,8 +504,8 @@ SET
 @pspp{}'s execution.  Since there are many subcommands to this command, its
 subcommands will be examined in groups.
 
 @pspp{}'s execution.  Since there are many subcommands to this command, its
 subcommands will be examined in groups.
 

-On subcommands that take boolean values, ON and YES are synonym, and
-as are OFF and NO, when used as subcommand values.
+For subcommands that take boolean values, @subcmd{ON} and @subcmd{YES} are synonymous, 
+as are @subcmd{OFF} and @subcmd{NO}, when used as subcommand values.

 
 The data input subcommands affect the way that data is read from data
 files.  The data input subcommands are
 
 The data input subcommands affect the way that data is read from data
 files.  The data input subcommands are


@@ -474,12 +520,14 @@ default.  Any real value may be assigned.
 
 @item DECIMAL
 @anchor{SET DECIMAL}
 
 @item DECIMAL
 @anchor{SET DECIMAL}

-This value may be set to DOT or COMMA.
-Setting it to DOT causes the decimal point character to be
+This value may be set to @subcmd{DOT} or @subcmd{COMMA}.
+Setting it to @subcmd{DOT} causes the decimal point character to be

 @samp{.} and the grouping character to be @samp{,}.
 @samp{.} and the grouping character to be @samp{,}.

-Setting it to COMMA
+Setting it to @subcmd{COMMA}

 causes the decimal point character to be @samp{,} and the grouping
 character to be @samp{.}.
 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
 The default value is determined from the system locale.
 
 @item FORMAT


@@ -492,7 +540,7 @@ Specifies the range of years used when a 2-digit year is read from a
 data file or used in a date construction expression (@pxref{Date
 Construction}).  If a 4-digit year is specified for the epoch, then
 2-digit years are interpreted starting from that year, known as the
 data file or used in a date construction expression (@pxref{Date
 Construction}).  If a 4-digit year is specified for the epoch, then
 2-digit years are interpreted starting from that year, known as the

-epoch.  If AUTOMATIC (the default) is specified, then the epoch begins
+epoch.  If @subcmd{AUTOMATIC} (the default) is specified, then the epoch begins

 69 years before the current date.
 
 @item RIB
 69 years before the current date.
 
 @item RIB


@@ -500,11 +548,11 @@ epoch.  If AUTOMATIC (the default) is specified, then the epoch begins
 
 @pspp{} extension to set the byte ordering (endianness) used for reading
 data in IB or PIB format (@pxref{Binary and Hexadecimal Numeric
 
 @pspp{} extension to set the byte ordering (endianness) used for reading
 data in IB or PIB format (@pxref{Binary and Hexadecimal Numeric

-Formats}).  In MSBFIRST ordering, the most-significant byte appears at
-the left end of a IB or PIB field.  In LSBFIRST ordering, the
-least-significant byte appears at the left end.  VAX ordering is like
-MSBFIRST, except that each pair of bytes is in reverse order.  NATIVE,
-the default, is equivalent to MSBFIRST or LSBFIRST depending on the
+Formats}).  In @subcmd{MSBFIRST} ordering, the most-significant byte appears at
+the left end of a IB or PIB field.  In @subcmd{LSBFIRST} ordering, the
+least-significant byte appears at the left end.  @subcmd{VAX} ordering is like
+@subcmd{MSBFIRST}, except that each pair of bytes is in reverse order.  @subcmd{NATIVE},
+the default, is equivalent to @subcmd{MSBFIRST} or @subcmd{LSBFIRST} depending on the

 native format of the machine running @pspp{}.
 
 @item RRB
 native format of the machine running @pspp{}.
 
 @item RRB


@@ -582,9 +630,9 @@ execute.  The syntax execution subcommands are
 @item LOCALE
 Overrides the system locale for the purpose of reading and writing
 syntax and data files.  The argument should be a locale name in the
 @item LOCALE
 Overrides the system locale for the purpose of reading and writing
 syntax and data files.  The argument should be a locale name in the

-general form @code{language_country.encoding}, where @code{language}
-and @code{country} are 2-character language and country abbreviations,
-respectively, and @code{encoding} is an IANA character set name.
+general form @code{@var{language}_@var{country}.@var{encoding}}, where @var{language}
+and @var{country} are 2-character language and country abbreviations,
+respectively, and @var{encoding} is an @acronym{IANA} character set name.

 Example locales are @code{en_US.UTF-8} (UTF-8 encoded English as
 spoken in the United States) and @code{ja_JP.EUC-JP} (EUC-JP encoded
 Japanese as spoken in Japan).
 Example locales are @code{en_US.UTF-8} (UTF-8 encoded English as
 spoken in the United States) and @code{ja_JP.EUC-JP} (EUC-JP encoded
 Japanese as spoken in Japan).


@@ -597,7 +645,7 @@ Currently not used.
 
 @item MXLOOPS
 The maximum number of iterations for an uncontrolled loop (@pxref{LOOP}).
 
 @item MXLOOPS
 The maximum number of iterations for an uncontrolled loop (@pxref{LOOP}).

-The default MXLOOPS is 40.
+The default @var{max_loops} is 40.

 
 @item SEED
 The initial pseudo-random number seed.  Set to a real number or to
 
 @item SEED
 The initial pseudo-random number seed.  Set to a real number or to


@@ -606,8 +654,15 @@ RANDOM, which will obtain an initial seed from the current time of day.
 @item UNDEFINED
 Currently not used.
 
 @item UNDEFINED
 Currently not used.
 

+@item FUZZBITS
+@anchor{SET FUZZBITS}
+The maximum number of bits of errors in the least-significant places
+to accept for rounding up a value that is almost halfway between two
+possibilities for rounding with the RND operator (@pxref{Miscellaneous
+Mathematics}).  The default @var{fuzzbits} is 6.
+

 @item WORKSPACE
 @item WORKSPACE

-The maximum amount of memory that @pspp{} will use to store data being processed.
+The maximum amount of memory (in kilobytes) that @pspp{} will use to store data being processed.

 If memory in excess of the workspace size is required, then @pspp{} will start
 to use temporary files to store the data.
 Setting a higher value will, in general, mean procedures will run faster, 
 If memory in excess of the workspace size is required, then @pspp{} will start
 to use temporary files to store the data.
 Setting a higher value will, in general, mean procedures will run faster, 


@@ -633,8 +688,8 @@ Set up custom currency formats.  @xref{Custom Currency Formats}, for
 details.
 
 @item DECIMAL
 details.
 
 @item DECIMAL

-The default DOT setting causes the decimal point character to be
-@samp{.}.  A setting of COMMA causes the decimal point character to be
+The default @subcmd{DOT} setting causes the decimal point character to be
+@samp{.}.  A setting of @subcmd{COMMA} causes the decimal point character to be

 @samp{,}.
 
 @item FORMAT
 @samp{,}.
 
 @item FORMAT


@@ -646,11 +701,11 @@ default is F8.2.  @xref{Input and Output Formats}.
 
 @pspp{} extension to set the byte ordering (endianness) used for writing
 data in IB or PIB format (@pxref{Binary and Hexadecimal Numeric
 
 @pspp{} extension to set the byte ordering (endianness) used for writing
 data in IB or PIB format (@pxref{Binary and Hexadecimal Numeric

-Formats}).  In MSBFIRST ordering, the most-significant byte appears at
-the left end of a IB or PIB field.  In LSBFIRST ordering, the
-least-significant byte appears at the left end.  VAX ordering is like
-MSBFIRST, except that each pair of bytes is in reverse order.  NATIVE,
-the default, is equivalent to MSBFIRST or LSBFIRST depending on the
+Formats}).  In @subcmd{MSBFIRST} ordering, the most-significant byte appears at
+the left end of a IB or PIB field.  In @subcmd{LSBFIRST} ordering, the
+least-significant byte appears at the left end.  @subcmd{VAX} ordering is like
+@subcmd{MSBFIRST}, except that each pair of bytes is in reverse order.  @subcmd{NATIVE},
+the default, is equivalent to @subcmd{MSBFIRST} or @subcmd{LSBFIRST} depending on the

 native format of the machine running @pspp{}.
 
 @item WRB
 native format of the machine running @pspp{}.
 
 @item WRB


@@ -658,7 +713,7 @@ native format of the machine running @pspp{}.
 
 @pspp{} extension to set the floating-point format used for writing data in
 RB format (@pxref{Binary and Hexadecimal Numeric Formats}).  The choices
 
 @pspp{} extension to set the floating-point format used for writing data in
 RB format (@pxref{Binary and Hexadecimal Numeric Formats}).  The choices

-are the same as SET RIB.  The default is NATIVE.
+are the same as @subcmd{SET RIB}.  The default is @subcmd{NATIVE}.

 @end table
 
 In the @pspp{} text-based interface, the output routing subcommands
 @end table
 
 In the @pspp{} text-based interface, the output routing subcommands


@@ -687,18 +742,18 @@ These output routing subcommands are:
 
 @table @asis
 @item ERRORS
 
 @table @asis
 @item ERRORS

-Applies to error and warning messages.  The default is BOTH.
+Applies to error and warning messages.  The default is @subcmd{BOTH}.

 
 @item MESSAGES
 
 @item MESSAGES

-Applies to notes.  The default is BOTH.
+Applies to notes.  The default is @subcmd{BOTH}.

 
 @item PRINTBACK
 Determines whether the syntax used for input is printed back as part
 
 @item PRINTBACK
 Determines whether the syntax used for input is printed back as part

-of the output.  The default is NONE.
+of the output.  The default is @subcmd{NONE}.

 
 @item RESULTS
 Applies to everything not in one of the above categories, such as the
 
 @item RESULTS
 Applies to everything not in one of the above categories, such as the

-results of statistical procedures.  The default is BOTH.
+results of statistical procedures.  The default is @subcmd{BOTH}.

 @end table
 
 These subcommands have no effect on output in the @pspp{} GUI
 @end table
 
 These subcommands have no effect on output in the @pspp{} GUI


@@ -713,15 +768,24 @@ subcommands are
 @itemx MORE
 @itemx WIDTH
 @itemx TNUMBERS
 @itemx MORE
 @itemx WIDTH
 @itemx TNUMBERS

-The TNUMBERS option sets the way in which values are displayed in output tables.
-The valid settings are VALUES, LABELS and BOTH.
-If TNUMBERS is set to VALUES, then all values are displayed with their literal value 
+The @subcmd{TNUMBERS} option sets the way in which values are displayed in output tables.
+The valid settings are @subcmd{VALUES}, @subcmd{LABELS} and @subcmd{BOTH}.
+If @subcmd{TNUMBERS} is set to @subcmd{VALUES}, then all values are displayed with their literal value 

 (which for a numeric value is a number and for a string value an alphanumeric string).
 (which for a numeric value is a number and for a string value an alphanumeric string).

-If TNUMBERS is set to LABELS, then values are displayed using their assigned labels if any.
+If @subcmd{TNUMBERS} is set to @subcmd{LABELS}, then values are displayed using their assigned labels if any.

 (@xref{VALUE LABELS}.)
 If the a value has no label, then it will be displayed using its literal value.
 (@xref{VALUE LABELS}.)
 If the a value has no label, then it will be displayed using its literal value.

-If TNUMBERS is set to BOTH, then values will be displayed with both their label
-(if any) and their literal value in parenthesis.
+If @subcmd{TNUMBERS} is set to @subcmd{BOTH}, then values will be displayed with both their label
+(if any) and their literal value in parentheses.
+@item TVARS
+The @subcmd{TVARS} option sets the way in which variables are displayed in output tables.
+The valid settings are @subcmd{NAMES}, @subcmd{LABELS} and @subcmd{BOTH}.
+If @subcmd{TVARS} is set to @subcmd{NAMES}, then all variables are displayed using their names.
+If @subcmd{TVARS} is set to @subcmd{LABELS}, then variables are displayed using their label if one
+has been set.  If no label has been set, then the name will be used.
+(@xref{VARIABLE LABELS}.)
+If @subcmd{TVARS} is set to @subcmd{BOTH}, then variables will be displayed with both their label
+(if any) and their name in parentheses.

 @end table
 
 @cindex headers
 @end table
 
 @cindex headers


@@ -739,10 +803,10 @@ files.  These subcommands are
 @item JOURNAL
 @itemx LOG
 These subcommands, which are synonyms, control the journal.  The
 @item JOURNAL
 @itemx LOG
 These subcommands, which are synonyms, control the journal.  The

-default is ON, which causes commands entered interactively to be
+default is @subcmd{ON}, which causes commands entered interactively to be

 written to the journal file.  Commands included from syntax files that
 are included interactively and error messages printed by @pspp{} are also
 written to the journal file.  Commands included from syntax files that
 are included interactively and error messages printed by @pspp{} are also

-written to the journal file, prefixed by @samp{>}.  OFF disables use
+written to the journal file, prefixed by @samp{>}.  @subcmd{OFF} disables use

 of the journal.
 
 The journal is named @file{pspp.jnl} by default.  A different name may
 of the journal.
 
 The journal is named @file{pspp.jnl} by default.  A different name may


@@ -758,7 +822,7 @@ Not currently used.
 
 @item SCOMPRESSION
 Whether system files created by @cmd{SAVE} or @cmd{XSAVE} are
 
 @item SCOMPRESSION
 Whether system files created by @cmd{SAVE} or @cmd{XSAVE} are

-compressed by default.  The default is ON.
+compressed by default.  The default is @subcmd{ON}.

 @end table
 
 Security subcommands affect the operations that commands are allowed to
 @end table
 
 Security subcommands affect the operations that commands are allowed to


@@ -770,11 +834,11 @@ Setting this option disables the following operations:
 
 @itemize @bullet
 @item
 
 @itemize @bullet
 @item

-The ERASE command.
+The @cmd{ERASE} command.

 @item
 @item

-The HOST command.
+The @cmd{HOST} command.

 @item
 @item

-The PERMISSIONS command.
+The @cmd{PERMISSIONS} command.

 @item
 Pipes (file names beginning or ending with @samp{|}).
 @end itemize
 @item
 Pipes (file names beginning or ending with @samp{|}).
 @end itemize


@@ -803,21 +867,18 @@ dependent.
 The following are all examples of acceptable syntax on common GNU/Linux
 systems.
 @example
 The following are all examples of acceptable syntax on common GNU/Linux
 systems.
 @example

-

 SET LOCALE='iso-8859-1'.
 
 SET LOCALE='ru_RU.cp1251'.
 
 SET LOCALE='japanese'.
 SET LOCALE='iso-8859-1'.
 
 SET LOCALE='ru_RU.cp1251'.
 
 SET LOCALE='japanese'.

-

 @end example
 
 @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
 
 @node SHOW
 of the system's locale.
 @end table
 
 @node SHOW

-@comment  node-name,  next,  previous,  up

 @section SHOW
 @vindex SHOW
 
 @section SHOW
 @vindex SHOW
 


@@ -836,10 +897,12 @@ SHOW
         [DIRECTORY]
         [ENVIRONMENT]
         [FORMAT]
         [DIRECTORY]
         [ENVIRONMENT]
         [FORMAT]

+        [FUZZBITS]

         [LENGTH]
         [MXERRS]
         [MXLOOPS]
         [MXWARNS]
         [LENGTH]
         [MXERRS]
         [MXLOOPS]
         [MXWARNS]

+        [N]

         [SCOMPRESSION]
         [TEMPDIR]
         [UNDEFINED]
         [SCOMPRESSION]
         [TEMPDIR]
         [UNDEFINED]


@@ -852,38 +915,41 @@ SHOW
 @cmd{SHOW} can be used to display the current state of @pspp{}'s execution
 parameters.  Parameters that can be changed using @cmd{SET}
 (@pxref{SET}), can be examined using @cmd{SHOW} using the subcommand
 @cmd{SHOW} can be used to display the current state of @pspp{}'s execution
 parameters.  Parameters that can be changed using @cmd{SET}
 (@pxref{SET}), can be examined using @cmd{SHOW} using the subcommand

-with the same name.  @code{SHOW} supports the following additional
+with the same name.  @cmd{SHOW} supports the following additional

 subcommands:
 
 subcommands:
 

-@table @code
-@item ALL
+@table @asis
+@item @subcmd{ALL}

 Show all settings.
 Show all settings.

-@item CC
-Show all custom currency settings (CCA through CCE).
-@item DIRECTORY
+@item @subcmd{CC}
+Show all custom currency settings (@subcmd{CCA} through @subcmd{CCE}).
+@item @subcmd{DIRECTORY}

 Shows the current working directory.
 Shows the current working directory.

-@item ENVIRONMENT
+@item @subcmd{ENVIRONMENT}

 Shows the operating system details.
 Shows the operating system details.

-@item TEMPDIR
+@item @subcmd{N}
+Reports the number of cases in the active dataset.  The reported number is not
+weighted.  If no dataset is defined, then @samp{Unknown} will be reported.
+@item @subcmd{TEMPDIR}

 Shows the path of the directory where temporary files will be stored.
 Shows the path of the directory where temporary files will be stored.

-@item VERSION
+@item @subcmd{VERSION}

 Shows the version of this installation of @pspp{}.
 Shows the version of this installation of @pspp{}.

-@item WARRANTY
+@item @subcmd{WARRANTY}

 Show details of the lack of warranty for @pspp{}.
 Show details of the lack of warranty for @pspp{}.

-@item COPYING / LICENSE
+@item @subcmd{COPYING} / @subcmd{LICENSE}

 Display the terms of @pspp{}'s copyright licence (@pxref{License}).
 @end table
 
 Display the terms of @pspp{}'s copyright licence (@pxref{License}).
 @end table
 

-Specifying @cmd{SHOW} without any subcommands is equivalent to SHOW ALL.
+Specifying @cmd{SHOW} without any subcommands is equivalent to @subcmd{SHOW ALL}.

 
 @node SUBTITLE
 @section SUBTITLE
 @vindex SUBTITLE
 
 @display
 
 @node SUBTITLE
 @section SUBTITLE
 @vindex SUBTITLE
 
 @display

-SUBTITLE 'subtitle_string'.
+SUBTITLE '@var{subtitle_string}'.

   or
   or

-SUBTITLE subtitle_string.
+SUBTITLE @var{subtitle_string}.

 @end display
 
 @cmd{SUBTITLE} provides a subtitle to a particular @pspp{}
 @end display
 
 @cmd{SUBTITLE} provides a subtitle to a particular @pspp{}


@@ -899,9 +965,9 @@ converted to all uppercase.
 @vindex TITLE
 
 @display
 @vindex TITLE
 
 @display

-TITLE 'title_string'.
+TITLE '@var{title_string}'.

   or
   or

-TITLE title_string.
+TITLE @var{title_string}.

 @end display
 
 @cmd{TITLE} provides a title to a particular @pspp{} run.
 @end display
 
 @cmd{TITLE} provides a title to a particular @pspp{} run.