X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Fpspp-convert.texi;h=aad7e74d9e0d7636302a2a2941c81735d8f98373;hb=93934145177c09e11deba0ad23bac34fe0fe9b97;hp=838f81167cf6b6be1850d4f1d6daf278ca90b16d;hpb=0df9cdd3df66caf4353128feff3008289cda8115;p=pspp diff --git a/doc/pspp-convert.texi b/doc/pspp-convert.texi index 838f81167c..aad7e74d9e 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,13 +48,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 +88,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.