X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Ftransformation.texi;h=5333d954ad9b9116950f2f39cdb8e0b0d9376b55;hb=1d5a97ba2afec23855a8294ff2814ab052f6777a;hp=e722b9c4c8620b19b1e473ce09389eda5ef2983b;hpb=1339492699ce7e12c9bf9fa17f9d60a66024cbd1;p=pspp-builds.git diff --git a/doc/transformation.texi b/doc/transformation.texi index e722b9c4..5333d954 100644 --- a/doc/transformation.texi +++ b/doc/transformation.texi @@ -23,7 +23,7 @@ as a rule. @display AGGREGATE - OUTFILE=@{*,'filename'@} + OUTFILE=@{*,'file-name',file_handle@} /PRESORTED /DOCUMENT /MISSING=COLUMNWISE @@ -37,9 +37,11 @@ variables called @dfn{break variables}. Several functions are available for summarizing case contents. The OUTFILE subcommand is required and must appear first. Specify a -system file by file name string or file handle (@pxref{FILE HANDLE}). +system file, portable file, or scratch file by file name or file +handle (@pxref{File Handles}). The aggregated cases are written to this file. If @samp{*} is -specified, then the aggregated cases replace the active file. +specified, then the aggregated cases replace the active file. Use of +OUTFILE to write a portable file or scratch file is a PSPP extension. By default, the active file will be sorted based on the break variables before aggregation takes place. If the active file is already sorted @@ -285,7 +287,7 @@ one or more @dfn{test} variables for each case. The target variable values are always nonnegative integers. They are never missing. The target variable is assigned an F8.2 output format. -@xref{Input/Output Formats}. Any variables, including long and short +@xref{Input and Output Formats}. Any variables, including long and short string variables, may be test variables. User-missing values of test variables are treated just like any other @@ -523,7 +525,7 @@ separate them from the previous recodings. @vindex SORT CASES @display -SORT CASES BY var_list. +SORT CASES BY var_list[(@{D|A@}] [ var_list[(@{D|A@}] ] ... @end display @cmd{SORT CASES} sorts the active file by the values of one or more @@ -532,8 +534,8 @@ variables. Specify BY and a list of variables to sort by. By default, variables are sorted in ascending order. To override sort order, specify (D) or (DOWN) after a list of variables to get descending order, or (A) or (UP) -for ascending order. These apply to the entire list of variables -preceding them. +for ascending order. These apply to all the listed variables +up until the preceding (A), (D), (UP) or (DOWN). The sort algorithms used by @cmd{SORT CASES} are stable. That is, records that have equal values of the sort variables will have the