pivot table procedure conceptually works
[pspp] / doc / utilities.texi
index 941451fdc4858b8c1a6a2b734dccbc821a224438..da5b7b0daae7d3f5ae0e99f053b53e2d8c475af2 100644 (file)
@@ -25,6 +25,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.
+* 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.
@@ -34,7 +35,6 @@ encountered in the input.
 @end menu
 
 @node ADD DOCUMENT
-@comment  node-name,  next,  previous,  up
 @section ADD DOCUMENT
 @vindex  ADD DOCUMENT
 
@@ -108,7 +108,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}.
 
-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.  
@@ -166,17 +166,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
-@comment  node-name,  next,  previous,  up
 @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.
-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
@@ -195,15 +194,15 @@ transformations to be executed.
 @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.
 
-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
@@ -217,18 +216,17 @@ FINISH.
 control to the operating system.
 
 @node HOST
-@comment  node-name,  next,  previous,  up
 @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.
-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 @subcmd{COMMAND} subcommand is specified, as a sequence of shell
 commands as quoted strings within square brackets, then @pspp{} executes
@@ -242,7 +240,7 @@ subshell.
 @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
@@ -254,21 +252,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
-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 @subcmd{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
-     INSERT [FILE=]'file-name'
+     INSERT [FILE=]'@var{file_name}'
         [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}) 
@@ -276,7 +274,7 @@ but somewhat more flexible.
 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}.
@@ -286,28 +284,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.
 
-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.
-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 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
-@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
@@ -316,26 +315,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{}
-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}.
 
-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
-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}.
 
+@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
@@ -345,19 +380,19 @@ otherwise it is @code{Auto}.
 
 @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.  
-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.
-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.
-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
@@ -386,30 +421,30 @@ SET
 (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)
-        /MXERRS=max_errs
-        /MXWARNS=max_warnings
-        /WORKSPACE=workspace_size
+        /MXERRS=@var{max_errs}
+        /MXWARNS=@var{max_warnings}
+        /WORKSPACE=@var{workspace_size}
 
 (syntax execution)
-        /LOCALE='locale'
+        /LOCALE='@var{locale}'
         /MEXPAND=@{ON,OFF@}
-        /MITERATE=max_iterations
-        /MNEST=max_nest
+        /MITERATE=@var{max_iterations}
+        /MNEST=@var{max_nest}
         /MPRINT=@{ON,OFF@}
-        /MXLOOPS=max_loops
-        /SEED=@{RANDOM,seed_value@}
+        /MXLOOPS=@var{max_loops}
+        /SEED=@{RANDOM,@var{seed_value}@}
         /UNDEFINED=@{WARN,NOWARN@}
 
 (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@}
-        /FORMAT=fmt_spec
+        /FORMAT=@var{fmt_spec}
         /WIB=@{NATIVE,MSBFIRST,LSBFIRST,VAX@}
         /WRB=@{NATIVE,ISL,ISB,IDL,IDB,VF,VD,VG,ZS,ZL@}
 
@@ -421,13 +456,14 @@ SET
 
 (output driver options)
         /HEADERS=@{NO,YES,BLANK@}
-        /LENGTH=@{NONE,length_in_lines@}
+        /LENGTH=@{NONE,@var{n_lines}@}
         /MORE=@{ON,OFF@}
-        /WIDTH=@{NARROW,WIDTH,n_characters@}
+        /WIDTH=@{NARROW,WIDTH,@var{n_characters}@}
         /TNUMBERS=@{VALUES,LABELS,BOTH@}
+        /TVARS=@{NAMES,LABELS,BOTH@}
 
 (logging)
-        /JOURNAL=@{ON,OFF@} ['file-name']
+        /JOURNAL=@{ON,OFF@} ['@var{file_name}']
 
 (system files)
         /COMPRESSION=@{ON,OFF@}
@@ -435,22 +471,22 @@ SET
 
 (miscellaneous)
         /SAFER=ON
-        /LOCALE='string'
+        /LOCALE='@var{string}'
 
 
 (obsolete settings accepted for compatibility, but ignored)
-        /BOXSTRING=@{'xxx','xxxxxxxxxxx'@}
+        /BOXSTRING=@{'@var{xxx}','@var{xxxxxxxxxxx}'@}
         /CASE=@{UPPER,UPLOW@}
         /CPI=cpi_value
         /HIGHRES=@{ON,OFF@}
-        /HISTOGRAM='c'
+        /HISTOGRAM='@var{c}'
         /LOWRES=@{AUTO,ON,OFF@}
-        /LPI=lpi_value
+        /LPI=@var{lpi_value}
         /MENUS=@{STANDARD,EXTENDED@}
-        /MXMEMORY=max_memory
+        /MXMEMORY=@var{max_memory}
         /SCRIPTTAB='c'
-        /TB1=@{'xxx','xxxxxxxxxxx'@}
-        /TBFONTS='string'
+        /TB1=@{'@var{xxx}','@var{xxxxxxxxxxx}'@}
+        /TBFONTS='@var{string}'
         /XSORT=@{YES,NO@}
 @end display
 
@@ -458,8 +494,8 @@ SET
 @pspp{}'s execution.  Since there are many subcommands to this command, its
 subcommands will be examined in groups.
 
-For subcommands that take boolean values, ON and YES are synonymous, 
-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
@@ -474,10 +510,10 @@ default.  Any real value may be assigned.
 
 @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{,}.
-Setting it to COMMA
+Setting it to @subcmd{COMMA}
 causes the decimal point character to be @samp{,} and the grouping
 character to be @samp{.}.
 The default value is determined from the system locale.
@@ -492,7 +528,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
-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
@@ -500,11 +536,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
-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
@@ -582,9 +618,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
-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).
@@ -597,7 +633,7 @@ Currently not used.
 
 @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
@@ -607,7 +643,7 @@ RANDOM, which will obtain an initial seed from the current time of day.
 Currently not used.
 
 @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, 
@@ -633,8 +669,8 @@ Set up custom currency formats.  @xref{Custom Currency Formats}, for
 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
@@ -646,11 +682,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
-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
@@ -658,7 +694,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
-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
@@ -687,18 +723,18 @@ These output routing subcommands are:
 
 @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
-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
-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
-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
@@ -713,15 +749,24 @@ subcommands are
 @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).
-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.
-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
@@ -739,10 +784,10 @@ files.  These subcommands are
 @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, 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
@@ -758,7 +803,7 @@ Not currently used.
 
 @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
@@ -770,11 +815,11 @@ Setting this option disables the following operations:
 
 @itemize @bullet
 @item
-The ERASE command.
+The @cmd{ERASE} command.
 @item
-The HOST command.
+The @cmd{HOST} command.
 @item
-The PERMISSIONS command.
+The @cmd{PERMISSIONS} command.
 @item
 Pipes (file names beginning or ending with @samp{|}).
 @end itemize
@@ -803,13 +848,11 @@ dependent.
 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'.
-
 @end example
 
 Contrary to the intuition, this command does not affect any aspect 
@@ -817,7 +860,6 @@ of the system's locale.
 @end table
 
 @node SHOW
-@comment  node-name,  next,  previous,  up
 @section SHOW
 @vindex SHOW
 
@@ -840,6 +882,7 @@ SHOW
         [MXERRS]
         [MXLOOPS]
         [MXWARNS]
+        [N]
         [SCOMPRESSION]
         [TEMPDIR]
         [UNDEFINED]
@@ -852,38 +895,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
-with the same name.  @code{SHOW} supports the following additional
+with the same name.  @cmd{SHOW} supports the following additional
 subcommands:
 
-@table @code
-@item ALL
+@table @asis
+@item @subcmd{ALL}
 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.
-@item ENVIRONMENT
+@item @subcmd{ENVIRONMENT}
 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.
-@item VERSION
+@item @subcmd{VERSION}
 Shows the version of this installation of @pspp{}.
-@item WARRANTY
+@item @subcmd{WARRANTY}
 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
 
-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
-SUBTITLE 'subtitle_string'.
+SUBTITLE '@var{subtitle_string}'.
   or
-SUBTITLE subtitle_string.
+SUBTITLE @var{subtitle_string}.
 @end display
 
 @cmd{SUBTITLE} provides a subtitle to a particular @pspp{}
@@ -899,9 +945,9 @@ converted to all uppercase.
 @vindex TITLE
 
 @display
-TITLE 'title_string'.
+TITLE '@var{title_string}'.
   or
-TITLE title_string.
+TITLE @var{title_string}.
 @end display
 
 @cmd{TITLE} provides a title to a particular @pspp{} run.