X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Fcombining.texi;h=a237c1a5bded14506120ad10b18df53e6a686bf8;hb=a58399ea2ce9421f72cc5771cd215b121bd8f9dd;hp=a7bca10f5ba6a1d1bd9a382e92706274af4357d3;hpb=09691dc4d67102153f02f9606b8710ac43d7964d;p=pspp diff --git a/doc/combining.texi b/doc/combining.texi index a7bca10f5b..a237c1a5bd 100644 --- a/doc/combining.texi +++ b/doc/combining.texi @@ -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 @@ -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. -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. -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 @@ -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{=}), -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 @@ -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. +These commands may combine any number of files, limited only by the +machine's memory. + @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 -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},