/[pspp]/pspp/doc/files.texi
ViewVC logotype

Diff of /pspp/doc/files.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.3 by jmd, Thu Apr 21 03:46:56 2005 UTC revision 1.4 by blp, Tue Apr 26 06:32:02 2005 UTC
# Line 164  data is read later, when a procedure is Line 164  data is read later, when a procedure is
164    
165  @display  @display
166  MATCH FILES  MATCH FILES
         /BY var_list  
167          /@{FILE,TABLE@}=@{*,'filename'@}          /@{FILE,TABLE@}=@{*,'filename'@}
168          /DROP=var_list          /DROP=var_list
169          /KEEP=var_list          /KEEP=var_list
170          /RENAME=(src_names=target_names)@dots{}          /RENAME=(src_names=target_names)@dots{}
171          /IN=var_name          /IN=var_name
172    
173            /BY var_list
174          /FIRST=var_name          /FIRST=var_name
175          /LAST=var_name          /LAST=var_name
176          /MAP          /MAP
# Line 185  variables.  The results of the merge bec Line 186  variables.  The results of the merge bec
186  The BY subcommand specifies a list of variables that are used to match  The BY subcommand specifies a list of variables that are used to match
187  records from each of the system files.  Variables specified must exist  records from each of the system files.  Variables specified must exist
188  in all the files specified on FILE and TABLE.  BY should usually be  in all the files specified on FILE and TABLE.  BY should usually be
189  specified.  If TABLE is used then BY is required.  specified.  If TABLE or IN is used then BY is required.
190    
191  Specify FILE with a system file as a file name string or file handle  Specify FILE with a system file as a file name string or file handle
192  (@pxref{FILE HANDLE}), or with an asterisk (@samp{*}) to  (@pxref{FILE HANDLE}), or with an asterisk (@samp{*}) to
# Line 203  It is incorrect to have records with dup Line 204  It is incorrect to have records with dup
204  files.  files.
205    
206  Any number of FILE and TABLE subcommands may be specified.  Each  Any number of FILE and TABLE subcommands may be specified.  Each
207  instance of FILE or TABLE can be followed by DROP, KEEP, and/or RENAME  instance of FILE or TABLE can be followed by any sequence of DROP,
208  subcommands.  These take the same form as the corresponding subcommands  KEEP, or RENAME subcommands.  These have the same form and meaning as
209  of @cmd{GET} (@pxref{GET}), and perform the same functions.  the corresponding subcommands of @cmd{GET} (@pxref{GET}), but apply
210    only to variables in the given file.
211    
212    Each FILE or TABLE may optionally be followed by an IN subcommand,
213    which creates a numeric variable with the specified name and format
214    F1.0.  The IN variable takes value 1 in a case if the given file
215    contributed a row to the merged file, 0 otherwise.  The DROP, KEEP,
216    and RENAME subcommands do not affect IN variables.
217    
218  Variables belonging to files that are not present for the current case  Variables belonging to files that are not present for the current case
219  are set to the system-missing value for numeric variables or spaces for  are set to the system-missing value for numeric variables or spaces for
220  string variables.  string variables.
221    
222  IN, FIRST, LAST, and MAP are currently not used.  FIRST, LAST, and MAP are currently ignored.
223    
224  @cmd{MATCH FILES} may not be specified following @cmd{TEMPORARY}  @cmd{MATCH FILES} may not be specified following @cmd{TEMPORARY}
225  (@pxref{TEMPORARY}) if the active file is used as an input source.  (@pxref{TEMPORARY}) if the active file is used as an input source.

Legend:
Removed from v.1.3  
changed lines
  Added in v.1.4

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26