X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Fcombining.texi;h=a237c1a5bded14506120ad10b18df53e6a686bf8;hb=699686d75db5b46436d7ef5608b12af9dfdec30a;hp=ee2934a2b29cc4a1dd5b2512104c2342dce8ffba;hpb=95c80bd42c05c410bd6cae5ae6e437b18bc79e02;p=pspp diff --git a/doc/combining.texi b/doc/combining.texi index ee2934a2b2..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,9 +67,11 @@ 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. The command's output becomes the new active dataset. The input -files are not changed on disk. +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 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 be read as input. For each input file, specify FILE with a system @@ -77,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 @@ -168,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 @@ -296,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},