+@c PSPP - a program for statistical analysis.
+@c Copyright (C) 2017 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 Invoking pspp-convert
@chapter Invoking @command{pspp-convert}
@cindex Invocation
@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:
@item por
SPSS portable file.
+
+@item sps
+SPSS syntax file. (Only encrypted syntax files may be converted to
+this format.)
@end table
+@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.
The following options are accepted:
-@table @code
+@table @option
@item -O @var{format}
@itemx --output-format=@var{format}
Specifies the desired output format. @var{format} must be one of the
interpreted. This option is necessary because old SPSS system files,
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
+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.
+
@item -h
@itemx --help
Prints a usage message on stdout and exits.