X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Futilities.texi;h=da5b7b0daae7d3f5ae0e99f053b53e2d8c475af2;hb=refs%2Fheads%2Fpivot-table2;hp=b40d8c8e673bd62446c803f9ef2bedb01ef3c5bd;hpb=620d94c8a41811d8dc8ba8a0f500896a9a894a18;p=pspp diff --git a/doc/utilities.texi b/doc/utilities.texi index b40d8c8e67..da5b7b0daa 100644 --- a/doc/utilities.texi +++ b/doc/utilities.texi @@ -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,20 +216,19 @@ 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 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. @@ -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 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. -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 @@ -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.