work on CTABLES
[pspp] / doc / combining.texi
index a7bca10f5ba6a1d1bd9a382e92706274af4357d3..a237c1a5bded14506120ad10b18df53e6a686bf8 100644 (file)
@@ -1,3 +1,12 @@
+@c PSPP - a program for statistical analysis.
+@c Copyright (C) 2017, 2020 Free Software Foundation, Inc.
+@c Permission is granted to copy, distribute and/or modify this document
+@c under the terms of the GNU Free Documentation License, Version 1.3
+@c or any later version published by the Free Software Foundation;
+@c with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+@c A copy of the license is included in the section entitled "GNU
+@c Free Documentation License".
+@c
 @node Combining Data Files
 @chapter Combining Data Files
 
 @node Combining Data Files
 @chapter Combining Data Files
 
@@ -58,10 +67,10 @@ This section describes the syntactical features in common among the
 @cmd{ADD FILES}, @cmd{MATCH FILES}, and @cmd{UPDATE} commands.  The
 following sections describe details specific to each command.
 
 @cmd{ADD FILES}, @cmd{MATCH FILES}, and @cmd{UPDATE} commands.  The
 following sections describe details specific to each command.
 
-Each of these commands reads two or more input files and combines them.  
+Each of these commands reads two or more input files and combines them.
 The command's output becomes the new active dataset.
 None of the commands actually change the input files.
 The command's output becomes the new active dataset.
 None of the commands actually change the input files.
-Therefore, if you want the changes to become permanant, you must explictly
+Therefore, if you want the changes to become permanent, you must explicitly
 save them using an appropriate procedure or transformation (@pxref{System and Portable File IO}).
 
 The syntax of each command begins with a specification of the files to
 save them using an appropriate procedure or transformation (@pxref{System and Portable File IO}).
 
 The syntax of each command begins with a specification of the files to
@@ -79,7 +88,7 @@ Each @subcmd{FILE} subcommand may be followed by any number of @subcmd{RENAME}
 subcommands that specify a parenthesized group or groups of variable
 names as they appear in the input file, followed by those variables'
 new names, separated by an equals sign (@subcmd{=}),
 subcommands that specify a parenthesized group or groups of variable
 names as they appear in the input file, followed by those variables'
 new names, separated by an equals sign (@subcmd{=}),
-e.g. @subcmd{/RENAME=(OLD1=NEW1)(OLD2=NEW2)}.  To rename a single
+@i{e.g.} @subcmd{/RENAME=(OLD1=NEW1)(OLD2=NEW2)}.  To rename a single
 variable, the parentheses may be omitted: @subcmd{/RENAME=@var{old}=@var{new}}.
 Within a parenthesized group, variables are renamed simultaneously, so
 that @subcmd{/RENAME=(@var{A} @var{B}=@var{B} @var{A})} exchanges the
 variable, the parentheses may be omitted: @subcmd{/RENAME=@var{old}=@var{new}}.
 Within a parenthesized group, variables are renamed simultaneously, so
 that @subcmd{/RENAME=(@var{A} @var{B}=@var{B} @var{A})} exchanges the
@@ -170,6 +179,9 @@ only in files that are not present for the current case are set to the
 system-missing value for numeric variables or spaces for string
 variables.
 
 system-missing value for numeric variables or spaces for string
 variables.
 
+These commands may combine any number of files, limited only by the
+machine's memory.
+
 @node ADD FILES
 @section ADD FILES
 @vindex ADD FILES
 @node ADD FILES
 @section ADD FILES
 @vindex ADD FILES
@@ -298,7 +310,7 @@ Once per command:
 @end display
 
 @cmd{UPDATE} updates a @dfn{master file} by applying modifications
 @end display
 
 @cmd{UPDATE} updates a @dfn{master file} by applying modifications
-from one or more @dfn{transaction files}.  
+from one or more @dfn{transaction files}.
 
 @cmd{UPDATE} shares the bulk of its syntax with other @pspp{} commands for
 combining multiple data files.  @xref{Combining Files Common Syntax},
 
 @cmd{UPDATE} shares the bulk of its syntax with other @pspp{} commands for
 combining multiple data files.  @xref{Combining Files Common Syntax},