X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Fpspp-convert.texi;h=c84d556d8e96b1f0501e81037cbe14bac08f595b;hb=e6d162908b97b9265d9041638c34d37a7e4bf524;hp=838f81167cf6b6be1850d4f1d6daf278ca90b16d;hpb=0df9cdd3df66caf4353128feff3008289cda8115;p=pspp

diff --git a/doc/pspp-convert.texi b/doc/pspp-convert.texi
index 838f81167c..c84d556d8e 100644
--- a/doc/pspp-convert.texi
+++ b/doc/pspp-convert.texi
@@ -1,10 +1,20 @@
+@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:
 
@@ -38,25 +48,40 @@ SPSS system file.
 
 @item por
 SPSS portable file.
-@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).
+@item sps
+SPSS syntax file.  (Only encrypted syntax files may be converted to
+this format.)
+@end table
 
-Use @code{-O @var{extension}} to override the inferred format or to
+@command{pspp-convert} can convert most input formats to most output
+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).  To decrypt such a file, specify the encrypted
+file as @var{input}.  The output will be the equivalent plaintext
+file.  Options for the output format are ignored in this case.
+
+The password for encrypted files can be specified a few different
+ways.  If the password is known, use the @option{-p} option
+(documented below) or allow @command{pspp-convert} to prompt for it.
+If the password is unknown, use the @option{-a} and @option{-l}
+options to specify how to search for it, or @option{--password-list}
+to specify a file of passwords to try.
+
+Use @code{-O format=@var{format}} to override the inferred format or to
 specify the format for unrecognized extensions.
 
-The following options are accepted:
+@command{pspp-convert} accepts the following options:
 
 @table @option
-@item -O @var{format}
-@itemx --output-format=@var{format}
-Specifies the desired output format.  @var{format} must be one of the
-extensions listed above, e.g. @code{-O csv} requests comma-separated
-value output.
+@item @option{-O format=@var{format}}
+Overrides the format inferred from the output file's extension.  Use
+@option{--help} to list the available formats.  @xref{Invoking PSPP},
+for details of the available output formats.
+
+@item @option{-O @var{option}=@var{value}}
+Sets an option for the output file format.  @xref{Invoking PSPP}, for
+details of the available output options.
 
 @item -c @var{maxcases}
 @itemx --cases=@var{maxcases}
@@ -72,13 +97,36 @@ 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.
 
+When used with @option{-a} (or @option{--password-alphabet}) and
+@option{-l} (or @option{--password-length}), this option specifies the
+starting point for the search.  This can be used to restart a search
+that was interrupted.
+
+@item -a @var{alphabet}
+@item --password-alphabet=@var{alphabet}
+Specifies the alphabet of symbols over which to search for an
+encrypted file's password.  @var{alphabet} may include individual
+characters and ranges delimited by @samp{-}.  For example, @option{-a
+a-z} searches lowercase letters, @option{-a A-Z0-9} searches uppercase
+letters and digits, and @option{-a ' -~'} searches all printable ASCII
+characters.
+
+@item -l @var{max-length}
+@item --password-length=@var{max-length}
+Specifies the maximum length of the passwords to try.
+
+@item --password-list=@var{file}
+Specifies a file to read containing a list of passwords to try, one
+per line.  If @var{file} is @file{-}, reads from stdin.
+
 @item -h
 @itemx --help
 Prints a usage message on stdout and exits.