GET: Add an ENCODING subcommand.
[pspp] / doc / files.texi
index cdce0a3c4689875560ef57dad998253c5f51b5e2..86aecab52c97b31025458e7af0a4d47e20ec9c07 100644 (file)
@@ -139,6 +139,7 @@ GET
         /DROP=var_list
         /KEEP=var_list
         /RENAME=(src_names=target_names)@dots{}
+        /ENCODING='encoding'
 @end display
 
 @cmd{GET} clears the current dictionary and active dataset and
@@ -171,6 +172,13 @@ 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 encoding,
+especially for files written by old versions of SPSS or PSPP.  Specify
+the ENCODING subcommand with an IANA character set name as its string
+argument to override the default.  The ENCODING subcommand is a PSPP
+extension.
+
 @cmd{GET} does not cause the data to be read, only the dictionary.  The data
 is read later, when a procedure is executed.