Updated pspp-mode.el.
[pspp-builds.git] / doc / data-selection.texi
index 32914f04f966d876fa720334e765866b99ac843b..4b6a748deaac594b4763d6b7751942dd1c42e753 100644 (file)
@@ -212,9 +212,8 @@ When @cmd{SELECT IF} is specified following @cmd{TEMPORARY}
 @vindex SPLIT FILE
 
 @display
-Two possible syntaxes:
-        SPLIT FILE BY var_list.
-        SPLIT FILE OFF.
+SPLIT FILE [@{LAYERED, SEPARATE@}] BY var_list.
+SPLIT FILE OFF.
 @end display
 
 @cmd{SPLIT FILE} allows multiple sets of data present in one data
@@ -222,11 +221,19 @@ file to be analyzed separately using single statistical procedure
 commands.
 
 Specify a list of variable names to analyze multiple sets of
-data separately.  Groups of cases having the same values for these
+data separately.  Groups of adjacent cases having the same values for these
 variables are analyzed by statistical procedure commands as one group.
 An independent analysis is carried out for each group of cases, and the
 variable values for the group are printed along with the analysis.
 
+When a list of variable names is specified, one of the keywords
+LAYERED or SEPARATE may also be specified.  If provided, either
+keyword are ignored.
+
+Groups are formed only by @emph{adjacent} cases.  To create a split 
+using a variable where like values are not adjacent in the working file,
+you should first sort the data by that variable (@pxref{SORT CASES}).
+
 Specify OFF to disable @cmd{SPLIT FILE} and resume analysis of the
 entire active file as a single group of data.