X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Futilities.texi;h=2d22f2bba77763eb1757444e9345a33b0bd25bee;hb=refs%2Fheads%2Fdataset;hp=158177b6884f6435e006099722643f66e5082e5b;hpb=68d837b6f9edf4151a8df34f65123b10b35612ea;p=pspp diff --git a/doc/utilities.texi b/doc/utilities.texi index 158177b688..2d22f2bba7 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. @@ -334,6 +335,42 @@ 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 @@ -403,6 +440,7 @@ SET /MXLOOPS=@var{max_loops} /SEED=@{RANDOM,@var{seed_value}@} /UNDEFINED=@{WARN,NOWARN@} + /FUZZBITS=@var{fuzzbits} (data output) /CC@{A,B,C,D,E@}=@{'@var{npre},@var{pre},@var{suf},@var{nsuf}','@var{npre}.@var{pre}.@var{suf}.@var{nsuf}'@} @@ -479,6 +517,8 @@ Setting it to @subcmd{DOT} causes the decimal point character to be Setting it to @subcmd{COMMA} causes the decimal point character to be @samp{,} and the grouping character to be @samp{.}. +If the setting is @subcmd{COMMA}, then @samp{,} will not be treated +as a field separator in the @cmd{DATA LIST} command (@pxref{DATA LIST}). The default value is determined from the system locale. @item FORMAT @@ -605,6 +645,13 @@ RANDOM, which will obtain an initial seed from the current time of day. @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 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 @@ -818,7 +865,7 @@ SET LOCALE='ru_RU.cp1251'. SET LOCALE='japanese'. @end example -Contrary to the intuition, this command does not affect any aspect +Contrary to intuition, this command does not affect any aspect of the system's locale. @end table @@ -841,6 +888,7 @@ SHOW [DIRECTORY] [ENVIRONMENT] [FORMAT] + [FUZZBITS] [LENGTH] [MXERRS] [MXLOOPS]