table: Require headers to be set at table creation.

[pspp] / utilities / pspp-convert.1

diff --git a/utilities/pspp-convert.1 b/utilities/pspp-convert.1
index bbbdd62a4c09f1b1906b2aa68d0b164ac8a1cd42..9c96dead1eaa3a6c854be2a09e93970392107f81 100644 (file)
--- a/utilities/pspp-convert.1
+++ b/utilities/pspp-convert.1
@@ -55,11 +55,13 @@ specify the format for unrecognized extensions.
 .
 .PP
 \fBpspp\-convert\fR 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).
+formats.  Encrypted SPSS file formats are exceptions: if the input
+file is in an encrypted format, then the output file will be the same
+format (decrypted).  Options for the output format are ignored in this
+case.
 .
 .SH "OPTIONS"
+.SS "General Options"
 .
 .IP "\fB\-O format\fR"
 .IQ "\fB\-\-output\-format=\fIformat\fR"
@@ -79,17 +81,43 @@ Overrides the encoding in which character strings in \fIinput\fR are
 interpreted.  This option is necessary because old SPSS system files
 do not self-identify their encoding.
 .
+.SS "Password Options"
+When the input file is encrypted, \fBpspp\-convert\fR needs to obtain
+a password to decrypt it.  To do so, the user may specify the password
+with \f\-p\fR (or \fB\-\-password), or the name of a file containing a
+list of possible passwords with \fB\-\-password\-list\fR, or an
+alphabet of possible passwords to try along with a maximum length with
+\fB\-a\fR (or \fB\-\-password\-alphabet\fR) and \fB\-l\fR (or
+\-\-password\-length\fR).  If none of these options is used,
+\fBpspp\-convert\fR prompts for the password.  The password options
+are:
+.
 .IP "\fB\-p \fIpassword\fR"
 .IQ "\fB\-\-password=\fIpassword\fR"
-Specifies the password to use to decrypt encrypted SPSS system file
-or syntax file
-\fIinput\fR.  If this option is not specified, \fBpspp\-convert\fR
-prompts for the password.
+Specifies the password to use to decrypt the input file.
 .
 .IP
 On multiuser systems, this option may not be safe because other users
 may be able to see the password in process listings.
 .
+.IP "\fB\-a \fIalphabet \fB\-l \fImax-length\fR"
+.IQ "\fB\-\-password-alphabet=\fIalphabet\ \fB\-\-password-length=\fImax-length\fR"
+These options are an alternative to \fB\-p\fR or \fB\-\-password\fR.
+They direct \fBpspp\-convert\fR to search for the correct password
+from the set of all passwords of symbols from \fIalphabet\fR (which
+may contain character ranges specified with \fB-\fR) and no more than
+\fImax-length\fR symbols long.  For example, \fB\-a a-z \-l 5\fR
+checks all possible lowercase alphabetic passwords no more than 5
+characters long.
+.IP
+When these options are used, \fB\-p\fR may additionally specify a
+starting point for the search.
+.
+.IP "\fB\-\-password\-list=\fIfile\fR"
+Specifies a file to read containing a list of passwords to try, one
+per line.  If \fIfile\fR is \fB\-\fR, reads from stdin.
+.
+.SS "Other Options"
 .IP "\fB\-h\fR"
 .IQ "\fB\-\-help\fR"
 Prints a usage message on stdout and exits.