Don't create histograms for string variables.

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

diff --git a/doc/transformation.texi b/doc/transformation.texi
index d8b08a45c7f99ef5cdbcca584f0e326523d8655a..5eedba64f742fd566ba75a5c65ccf347d7d6f3ee 100644 (file)
--- a/doc/transformation.texi
+++ b/doc/transformation.texi
@@ -1,4 +1,4 @@
-@node Data Manipulation, Data Selection, Variable Attributes, Top
+@node Data Manipulation

 @chapter Data transformations
 @cindex transformations
 
 @chapter Data transformations
 @cindex transformations
 


@@ -17,7 +17,7 @@ as a rule.
 * SORT CASES::                  Sort the active file.
 @end menu
 
 * SORT CASES::                  Sort the active file.
 @end menu
 

-@node AGGREGATE, AUTORECODE, Data Manipulation, Data Manipulation
+@node AGGREGATE

 @section AGGREGATE
 @vindex AGGREGATE
 
 @section AGGREGATE
 @vindex AGGREGATE
 


@@ -83,7 +83,7 @@ list.
 Each set must have exactly as many source variables as aggregation
 variables.  Each aggregation variable receives the results of applying
 the specified aggregation function to the corresponding source
 Each set must have exactly as many source variables as aggregation
 variables.  Each aggregation variable receives the results of applying
 the specified aggregation function to the corresponding source

-variable.  The MEAN, SD, and SUM aggregation functions may only be
+variable.  The MEAN, MEDIAN, SD, and SUM aggregation functions may only be

 applied to numeric variables.  All the rest may be applied to numeric
 and short and long string variables.
 
 applied to numeric variables.  All the rest may be applied to numeric
 and short and long string variables.
 


@@ -128,6 +128,9 @@ dictionary information from the source variable.
 Arithmetic mean.  Limited to numeric values.  The default format is
 F8.2.
 
 Arithmetic mean.  Limited to numeric values.  The default format is
 F8.2.
 

+@item MEDIAN(var_name)
+The median value.  Limited to numeric values.  The default format is F8.2.
+

 @item MIN(var_name)
 Minimum value.  The aggregation variable receives the complete
 dictionary information from the source variable.
 @item MIN(var_name)
 Minimum value.  The aggregation variable receives the complete
 dictionary information from the source variable.


@@ -194,7 +197,7 @@ will cause the period to be interpreted as the end of the command.)
 @cmd{AGGREGATE} both ignores and cancels the current @cmd{SPLIT FILE}
 settings (@pxref{SPLIT FILE}).
 
 @cmd{AGGREGATE} both ignores and cancels the current @cmd{SPLIT FILE}
 settings (@pxref{SPLIT FILE}).
 

-@node AUTORECODE, COMPUTE, AGGREGATE, Data Manipulation
+@node AUTORECODE

 @section AUTORECODE
 @vindex AUTORECODE
 
 @section AUTORECODE
 @vindex AUTORECODE
 


@@ -224,7 +227,7 @@ PRINT is currently ignored.
 
 @cmd{AUTORECODE} is a procedure.  It causes the data to be read.
 
 
 @cmd{AUTORECODE} is a procedure.  It causes the data to be read.
 

-@node COMPUTE, COUNT, AUTORECODE, Data Manipulation
+@node COMPUTE

 @section COMPUTE
 @vindex COMPUTE
 
 @section COMPUTE
 @vindex COMPUTE
 


@@ -264,7 +267,7 @@ When @cmd{COMPUTE} is specified following @cmd{TEMPORARY}
 (@pxref{TEMPORARY}), the @cmd{LAG} function may not be used
 (@pxref{LAG}).
 
 (@pxref{TEMPORARY}), the @cmd{LAG} function may not be used
 (@pxref{LAG}).
 

-@node COUNT, FLIP, COMPUTE, Data Manipulation
+@node COUNT

 @section COUNT
 @vindex COUNT
 
 @section COUNT
 @vindex COUNT
 


@@ -368,7 +371,7 @@ DESCRIPTIVES QVALID /STATISTICS=MEAN.
 @end example
 @end enumerate
 
 @end example
 @end enumerate
 

-@node FLIP, IF, COUNT, Data Manipulation
+@node FLIP

 @section FLIP
 @vindex FLIP
 
 @section FLIP
 @vindex FLIP
 


@@ -414,7 +417,7 @@ FLIP honors @cmd{N OF CASES} (@pxref{N OF CASES}).  It ignores
 @cmd{TEMPORARY} (@pxref{TEMPORARY}), so that ``temporary''
 transformations become permanent.
 
 @cmd{TEMPORARY} (@pxref{TEMPORARY}), so that ``temporary''
 transformations become permanent.
 

-@node IF, RECODE, FLIP, Data Manipulation
+@node IF

 @section IF
 @vindex IF
 
 @section IF
 @vindex IF
 


@@ -452,7 +455,7 @@ When @cmd{IF} is specified following @cmd{TEMPORARY}
 (@pxref{TEMPORARY}), the @cmd{LAG} function may not be used
 (@pxref{LAG}).
 
 (@pxref{TEMPORARY}), the @cmd{LAG} function may not be used
 (@pxref{LAG}).
 

-@node RECODE, SORT CASES, IF, Data Manipulation
+@node RECODE

 @section RECODE
 @vindex RECODE
 
 @section RECODE
 @vindex RECODE
 


@@ -505,8 +508,8 @@ src_value matches any user- or system-missing value.  SYSMIS matches the
 system missing value only.  ELSE is a catch-all that matches anything.
 It should be the last src_value specified.
 
 system missing value only.  ELSE is a catch-all that matches anything.
 It should be the last src_value specified.
 

-Numeric and string dest_value's should also be self-explanatory.  COPY
-causes the input values to be copied to the output.  This is only value
+Numeric and string dest_value's should be self-explanatory.  COPY
+causes the input values to be copied to the output.  This is only valid

 if the source and target variables are of the same type.  SYSMIS
 indicates the system-missing value.
 
 if the source and target variables are of the same type.  SYSMIS
 indicates the system-missing value.
 


@@ -520,12 +523,12 @@ Multiple recodings can be specified on a single @cmd{RECODE} invocation.
 Introduce additional recodings with a slash (@samp{/}) to
 separate them from the previous recodings.
 
 Introduce additional recodings with a slash (@samp{/}) to
 separate them from the previous recodings.
 

-@node SORT CASES,  , RECODE, Data Manipulation
+@node SORT CASES

 @section SORT CASES
 @vindex SORT CASES
 
 @display
 @section SORT CASES
 @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
 @end display
 
 @cmd{SORT CASES} sorts the active file by the values of one or more


@@ -534,8 +537,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)
 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
 
 The sort algorithms used by @cmd{SORT CASES} are stable.  That is,
 records that have equal values of the sort variables will have the


@@ -550,4 +553,3 @@ If workspace is exhausted, it falls back to a merge sort algorithm that
 involves creates numerous temporary files.
 
 @cmd{SORT CASES} may not be specified following TEMPORARY.  
 involves creates numerous temporary files.
 
 @cmd{SORT CASES} may not be specified following TEMPORARY.  

-@setfilename ignored