X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Futilities.texi;h=18a45095e986af89d3c1f26a93169fbddc90f2da;hb=refs%2Fheads%2Fctables7;hp=a5db44b5a6312b94a8c97641a663e2f961f2168e;hpb=fc64edfca5e53e7a463dd25ab0c79cf135c33531;p=pspp diff --git a/doc/utilities.texi b/doc/utilities.texi index a5db44b5a6..18a45095e9 100644 --- a/doc/utilities.texi +++ b/doc/utilities.texi @@ -497,10 +497,6 @@ SET (syntax execution) /LOCALE='@var{locale}' - /MEXPAND=@{ON,OFF@} - /MITERATE=@var{max_iterations} - /MNEST=@var{max_nest} - /MPRINT=@{ON,OFF@} /MXLOOPS=@var{max_loops} /SEED=@{RANDOM,@var{seed_value}@} /UNDEFINED=@{WARN,NOWARN@} @@ -510,6 +506,8 @@ SET /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=@var{fmt_spec} + /MDISPLAY=@{TEXT,TABLES@} + /SMALL=@var{number} /WIB=@{NATIVE,MSBFIRST,LSBFIRST,VAX@} /WRB=@{NATIVE,ISL,ISB,IDL,IDB,VF,VD,VG,ZS,ZL@} @@ -525,33 +523,33 @@ SET /WIDTH=@{NARROW,WIDTH,@var{n_characters}@} /TNUMBERS=@{VALUES,LABELS,BOTH@} /TVARS=@{NAMES,LABELS,BOTH@} + /TLOOK=@{NONE,@var{file}@} (logging) /JOURNAL=@{ON,OFF@} ['@var{file_name}'] (system files) - /COMPRESSION=@{ON,OFF@} /SCOMPRESSION=@{ON,OFF@} (miscellaneous) /SAFER=ON /LOCALE='@var{string}' - -(obsolete settings accepted for compatibility, but ignored) - /BOXSTRING=@{'@var{xxx}','@var{xxxxxxxxxxx}'@} - /CASE=@{UPPER,UPLOW@} - /CPI=cpi_value - /HIGHRES=@{ON,OFF@} - /HISTOGRAM='@var{c}' - /LOWRES=@{AUTO,ON,OFF@} - /LPI=@var{lpi_value} - /MENUS=@{STANDARD,EXTENDED@} - /MXMEMORY=@var{max_memory} - /SCRIPTTAB='c' - /TB1=@{'@var{xxx}','@var{xxxxxxxxxxx}'@} - /TBFONTS='@var{string}' - /XSORT=@{YES,NO@} +(macros) + /MEXPAND=@{ON,OFF@} + /MPRINT=@{ON,OFF@} + /MITERATE=@var{number} + /MNEST=@var{number} + +(settings not yet implemented, but accepted and ignored) + /BASETEXTDIRECTION=@{AUTOMATIC,RIGHTTOLEFT,LEFTTORIGHT@} + /BLOCK='@var{c}' + /BOX=@{'@var{xxx}','@var{xxxxxxxxxxx}'@} + /CACHE=@{ON,OFF@} + /CELLSBREAK=@var{number} + /COMPRESSION=@{ON,OFF@} + /CMPTRANS=@{ON,OFF@} + /HEADER=@{NO,YES,BLANK@} @end display @cmd{SET} allows the user to adjust several parameters relating to @@ -692,17 +690,15 @@ 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). -@item MEXPAND -@itemx MITERATE -@itemx MNEST -@itemx MPRINT -Currently not used. - @item MXLOOPS -The maximum number of iterations for an uncontrolled loop (@pxref{LOOP}). -The default @var{max_loops} is 40. +@anchor{SET MXLOOPS} + +The maximum number of iterations for an uncontrolled loop +(@pxref{LOOP}), and for any loop in the matrix language (@pxref{Matrix +LOOP and BREAK Commands}). The default @var{max_loops} is 40. @item SEED +@anchor{SET SEED} The initial pseudo-random number seed. Set it to a real number or to RANDOM, to obtain an initial seed from the current time of day. @@ -751,6 +747,23 @@ The default @subcmd{DOT} setting causes the decimal point character to be Allows the default numeric input/output format to be specified. The default is F8.2. @xref{Input and Output Formats}. +@item MDISPLAY +@anchor{SET MDISPLAY} + +Controls how the @code{PRINT} command within +@code{MATRIX}@dots{}@code{END MATRIX} outputs matrices. With the +default @subcmd{TEXT}, @code{PRINT} outputs matrices as text. Change +this setting to @code{TABLES} to instead output matrices as pivot +tables. @xref{Matrix PRINT Command}, for more information. + +@item SMALL +This controls how @pspp{} formats small numbers in pivot tables, in +cases where @pspp{} does not otherwise have a well-defined format for +the numbers. When such a number has a magnitude less than the value +set here, @pspp{} formats the number in scientific notation; +otherwise, it formats it in standard notation. The default is 0.0001. +Set a value of 0 to disable scientific notation. + @item WIB @anchor{SET WIB} @@ -840,6 +853,13 @@ has been set. If no label has been set, then the name is used. (@xref{VARIABLE LABELS}.) If @subcmd{TVARS} is set to @subcmd{BOTH}, then variables are displayed with both their label (if any) and their name in parentheses. +@item TLOOK +The @subcmd{TLOOK} option sets the style used for subsequent table +output. Specifying @subcmd{NONE} makes @pspp{} use the default +built-in style. Otherwise, specifying @var{file} makes @pspp{} search +for an @file{.stt} or @file{.tlo} file in the same way as specifying +@option{--table-look=@var{file}} the @pspp{} command line (@pxref{Main +Options}). @end table @cindex headers @@ -870,9 +890,6 @@ System file subcommands affect the default format of system files produced by @pspp{}. These subcommands are @table @asis -@item COMPRESSION -Not currently used. - @item SCOMPRESSION Whether system files created by @cmd{SAVE} or @cmd{XSAVE} are compressed by default. The default is @subcmd{ON}. @@ -931,6 +948,46 @@ Contrary to intuition, this command does not affect any aspect of the system's locale. @end table +The following subcommands affect the interpretation of macros. + +@table @asis +@item MEXPAND +@anchor{SET MEXPAND} +Controls whether macros are expanded. The default is ON. + +@item MPRINT +@anchor{SET MPRINT} +Controls whether the expansion of macros is included in output. This +is separate from whether command syntax in general is included in +output. The default is OFF. + +@item MITERATE +@anchor{SET MITERATE} +Limits the number of iterations executed in @code{!DO} loops within +macros. This does not affect other language constructs such as +@cmd{LOOP}. This must be set to a positive integer. The default is +1000. + +@item MNEST +@anchor{SET MNEST} +Limits the number of levels of nested macro expansions. This must be +set to a positive integer. The default is 50. +@end table + +The following subcommands are not yet implemented, but PSPP accepts +them and ignores the settings. + +@table @asis +@item BASETEXTDIRECTION +@itemx BLOCK +@itemx BOX +@itemx CACHE +@itemx CELLSBREAK +@itemx COMPRESSION +@itemx CMPTRANS +@itemx HEADER +@end table + @node SHOW @section SHOW @vindex SHOW @@ -952,6 +1009,10 @@ SHOW [FORMAT] [FUZZBITS] [LENGTH] + [MEXPAND] + [MPRINT] + [MITERATE] + [MNEST] [MXERRS] [MXLOOPS] [MXWARNS]