Add documentation for SPV file format.

[pspp] / doc / pspp-convert.texi

diff --git a/doc/pspp-convert.texi b/doc/pspp-convert.texi
index 838f81167cf6b6be1850d4f1d6daf278ca90b16d..3719de224c44dcb5fb1af537a417969e33c491a5 100644 (file)
--- a/doc/pspp-convert.texi
+++ b/doc/pspp-convert.texi
@@ -4,7 +4,8 @@
 @cindex @command{pspp-convert}
 
 @command{pspp-convert} is a command-line utility accompanying
-@pspp{}. It reads an SPSS system or portable file @var{input} and
+@pspp{}. It reads an SPSS or SPSS/PC+ system file or SPSS portable
+file or encrypted SPSS syntax file @var{input} and
 writes a copy of it to another @var{output} in a different format.
 Synopsis:
 
@@ -38,13 +39,19 @@ SPSS system file.
 
 @item por
 SPSS portable file.
+
+@item sps
+SPSS syntax file.  (Only encrypted syntax files may be converted to
+this format.)
 @end table
 
-As a special case of format conversion, @command{pspp-convert} can
-decrypt an encrypted SPSS system file.  Specify the encrypted file as
-@var{input}.  The output will be the equivalent plaintext SPSS system
-file.  You will be prompted for the password (or use @option{-p},
-documented below).
+@command{pspp-convert} can convert most input formats to most output
+formats.  Encrypted system file and syntax files are exceptions: if
+the input file is in an encrypted format, then the output file must be
+the same format (decrypted).  To decrypt such a file, specify the
+encrypted file as @var{input}.  The output will be the equivalent
+plaintext file.  You will be prompted for the password (or use
+@option{-p}, documented below).
 
 Use @code{-O @var{extension}} to override the inferred format or to
 specify the format for unrecognized extensions.
@@ -72,9 +79,10 @@ and SPSS/PC+ system files, do not self-identify their encoding.
 
 @item -p @var{password}
 @item --password=@var{password}
-Specifies the password to use to decrypt an encrypted SPSS system
-file.  If this option is not specified, @command{pspp-convert} will
-prompt interactively for the password as necessary.
+Specifies the password to use to decrypt an encrypted SPSS system file
+or syntax file.  If this option is not specified,
+@command{pspp-convert} will prompt interactively for the password as
+necessary.
 
 Be aware that command-line options, including passwords, may be
 visible to other users on multiuser systems.