X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=utilities%2Fpspp-convert.1;h=bbbdd62a4c09f1b1906b2aa68d0b164ac8a1cd42;hb=71131a5290c10c9edc03056ccbf9e6eb0e70e9b4;hp=f1580cd6b5815d75401eca751896f23f774a1f0b;hpb=02a682272552710b1c4c869db3fea1d83b0eb3a7;p=pspp diff --git a/utilities/pspp-convert.1 b/utilities/pspp-convert.1 index f1580cd6b5..bbbdd62a4c 100644 --- a/utilities/pspp-convert.1 +++ b/utilities/pspp-convert.1 @@ -7,7 +7,7 @@ .TH pspp\-convert 1 "October 2013" "PSPP" "PSPP Manual" . .SH NAME -pspp\-convert \- convert SPSS system and portable files to other formats +pspp\-convert \- convert SPSS files to other formats . .SH SYNOPSIS \fBpspp\-convert\fR [\fIoptions\fR] \fIinput\fR \fIoutput\fR @@ -17,14 +17,17 @@ pspp\-convert \- convert SPSS system and portable files to other formats \fBpspp\-convert \-\-version\fR | \fB\-v\fR . .SH DESCRIPTION -The \fBpspp\-convert\fR program reads SPSS system or portable file -\fIinput\fR and writes it to \fIoutput\fR, performing format -conversion as necessary. +The \fBpspp\-convert\fR program reads \fIinput\fR, which may be an +SPSS system file, an SPSS/PC+ system file, an SPSS portable file, +or an encrypted SPSS syntax file, +and writes it to \fIoutput\fR, performing format conversion as +necessary. .PP -The format of \fIinput\fR is automatically detected, except that the -character encoding of old system files cannot always be guessed -correctly. Use \fB\-e \fIencoding\fR to specify the encoding in this -case. +The format of \fIinput\fR is automatically detected, when possible. +The character encoding of old SPSS system files cannot always be +guessed correctly, and SPSS/PC+ system files do not include any +indication of their encoding. Use \fB\-e \fIencoding\fR to specify +the encoding in this case. .PP By default, the intended format for \fIoutput\fR is inferred from its extension: @@ -42,10 +45,20 @@ SPSS system file. .IP \fBpor\fR SPSS portable file. . +.IP \fBsps\fR +SPSS syntax file. (Only encrypted syntax files may be converted to +this format.) +. .PP Use \fB\-O \fIextension\fR to override the inferred format or to 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). +. .SH "OPTIONS" . .IP "\fB\-O format\fR" @@ -66,6 +79,17 @@ 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. . +.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. +. +.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\-h\fR" .IQ "\fB\-\-help\fR" Prints a usage message on stdout and exits.