X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;ds=sidebyside;f=doc%2Ffiles.texi;h=6b3a78c75b6d6f5c0aa25943830d8320956f62b0;hb=4b2eb0d1ce8df60aa43e2fe37628ae00b80d1115;hp=2e03fc9dd334e0a5b9668fc8b2cfbffade1a5ea2;hpb=9d160f03d77979c6e3fbc177a19b7e41438e5c00;p=pspp diff --git a/doc/files.texi b/doc/files.texi index 2e03fc9dd3..6b3a78c75b 100644 --- a/doc/files.texi +++ b/doc/files.texi @@ -145,10 +145,9 @@ GET @cmd{GET} clears the current dictionary and active dataset and replaces them with the dictionary and data from a specified file. -The @subcmd{FILE} subcommand is the only required subcommand. -Specify the system -file or portable file to be read as a string file name or -a file handle (@pxref{File Handles}). +The @subcmd{FILE} subcommand is the only required subcommand. Specify +the SPSS system file, SPSS/PC+ system file, or SPSS portable file to +be read as a string file name or a file handle (@pxref{File Handles}). By default, all the variables in a file are read. The DROP subcommand can be used to specify a list of variables that are not to be @@ -175,10 +174,11 @@ Each may be present any number of times. @cmd{GET} never modifies a file on disk. Only the active dataset read from the file is affected by these subcommands. -@pspp{} tries to automatically detect the encoding of string data in the -file. Sometimes, however, this does not work well, -especially for files written by old versions of SPSS or @pspp{}. Specify -the @subcmd{ENCODING} subcommand with an @acronym{IANA} character set name as its string +@pspp{} automatically detects the encoding of string data in the file, +when possible. The character encoding of old SPSS system files cannot +always be guessed correctly, and SPSS/PC+ system files do not include +any indication of their encoding. Specify the @subcmd{ENCODING} +subcommand with an @acronym{IANA} character set name as its string argument to override the default. Use @cmd{SYSFILE INFO} to analyze the encodings that might be valid for a system file. The @subcmd{ENCODING} subcommand is a @pspp{} extension. @@ -428,7 +428,7 @@ GET DATA /TYPE=TXT [/IMPORTCASE=@{ALL,FIRST @var{max_cases},PERCENT @var{percent}@}] /DELIMITERS="@var{delimiters}" - [/QUALIFIER="@var{quotes}" [/ESCAPE]] + [/QUALIFIER="@var{quotes}" [/DELCASE=@{LINE,VARIABLES @var{n_variables}@}] /VARIABLES=@var{del_var1} [@var{del_var2}]@dots{} where each @var{del_var} takes the form: @@ -467,15 +467,10 @@ matching quote. Intervening delimiters become part of the field, instead of terminating it. The ability to specify more than one quote character is a @pspp{} extension. -By default, a character specified on @subcmd{QUALIFIER} cannot itself be -embedded within a field that it quotes, because the quote character -always terminates the quoted field. With ESCAPE, however, a doubled -quote character within a quoted field inserts a single instance of the -quote into the field. For example, if @samp{'} is specified on -@subcmd{QUALIFIER}, then without ESCAPE @code{'a''b'} specifies a pair of -fields that contain @samp{a} and @samp{b}, but with ESCAPE it -specifies a single field that contains @samp{a'b}. ESCAPE is a @pspp{} -extension. +The character specified on @subcmd{QUALIFIER} can be embedded within a +field that it quotes by doubling the qualifier. For example, if +@samp{'} is specified on @subcmd{QUALIFIER}, then @code{'a''b'} +specifies a field that contains @samp{a'b}. The @subcmd{DELCASE} subcommand controls how data may be broken across lines in the data file. With LINE, the default setting, each line must contain @@ -914,20 +909,21 @@ qualifier character that appears within a value is doubled. SYSFILE INFO FILE='@var{file_name}' [ENCODING='@var{encoding}']. @end display -@cmd{SYSFILE INFO} reads the dictionary in a system file and -displays the information in its dictionary. - -Specify a file name or file handle. @cmd{SYSFILE INFO} reads that file as -a system file and displays information on its dictionary. - -@pspp{} tries to automatically detect the encoding of string data in -the file. Sometimes, however, this does not work well, especially for -files written by old versions of SPSS or @pspp{}. Specify the -@subcmd{ENCODING} subcommand with an @acronym{IANA} character set name -as its string argument to override the default, or specify -@code{ENCODING='DETECT'} to analyze and report possibly valid -encodings for the system file. The @subcmd{ENCODING} subcommand is a -@pspp{} extension. +@cmd{SYSFILE INFO} reads the dictionary in an SPSS system file, +SPSS/PC+ system file, or SPSS portable file, and displays the +information in its dictionary. + +Specify a file name or file handle. @cmd{SYSFILE INFO} reads that +file and displays information on its dictionary. + +@pspp{} automatically detects the encoding of string data in the file, +when possible. The character encoding of old SPSS system files cannot +always be guessed correctly, and SPSS/PC+ system files do not include +any indication of their encoding. Specify the @subcmd{ENCODING} +subcommand with an @acronym{IANA} character set name as its string +argument to override the default, or specify @code{ENCODING='DETECT'} +to analyze and report possibly valid encodings for the system file. +The @subcmd{ENCODING} subcommand is a @pspp{} extension. @cmd{SYSFILE INFO} does not affect the current active dataset.