changed linreg_cache.coeff to **

[pspp-builds.git] / doc / transformation.texi

diff --git a/doc/transformation.texi b/doc/transformation.texi
index d94c1366e63621211aad53e990e6246e9e16145f..327f67391210f640b810dc798d284cb2fa522e64 100644 (file)
--- a/doc/transformation.texi
+++ b/doc/transformation.texi
@@ -23,7 +23,7 @@ as a rule.
 
 @display
 AGGREGATE 
 
 @display
 AGGREGATE 

-        OUTFILE=@{*,'filename'@}          
+        OUTFILE=@{*,'file-name',file_handle@}

         /PRESORTED
         /DOCUMENT
         /MISSING=COLUMNWISE
         /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
 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
 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
 
 By default, the active file will be sorted based on the break variables
 before aggregation takes place.  If the active file is already sorted


@@ -386,7 +388,8 @@ specified are discarded.  If the VARIABLES subcommand is omitted, all
 variables are selected for transposition.
 
 The variables specified by NEWNAMES, which must be a string variable, is
 variables are selected for transposition.
 
 The variables specified by NEWNAMES, which must be a string variable, is

-used to give names to the variables created by @cmd{FLIP}.  If
+used to give names to the variables created by @cmd{FLIP}.  Only the
+first 8 characters of the variable are used.  If

 NEWNAMES is not
 specified then the default is a variable named CASE_LBL, if it exists.
 If it does not then the variables created by FLIP are named VAR000
 NEWNAMES is not
 specified then the default is a variable named CASE_LBL, if it exists.
 If it does not then the variables created by FLIP are named VAR000


@@ -400,11 +403,12 @@ extensions are added, starting with 1, until a unique name is found or
 there are no remaining possibilities.  If the latter occurs then the
 FLIP operation aborts.
 
 there are no remaining possibilities.  If the latter occurs then the
 FLIP operation aborts.
 

-The resultant dictionary contains a CASE_LBL variable, which stores the
-names of the variables in the dictionary before the transposition.  If
-the active file is subsequently transposed using @cmd{FLIP}, this
-variable can
-be used to recreate the original variable names.
+The resultant dictionary contains a CASE_LBL variable, a string
+variable of width 8, which stores the names of the variables in the
+dictionary before the transposition.  Variables names longer than 8
+characters are truncated.  If the active file is subsequently
+transposed using @cmd{FLIP}, this variable can be used to recreate the
+original variable names.

 
 FLIP honors @cmd{N OF CASES} (@pxref{N OF CASES}).  It ignores
 @cmd{TEMPORARY} (@pxref{TEMPORARY}), so that ``temporary''
 
 FLIP honors @cmd{N OF CASES} (@pxref{N OF CASES}).  It ignores
 @cmd{TEMPORARY} (@pxref{TEMPORARY}), so that ``temporary''