X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=utilities%2Fpspp-convert.1;h=db4982b3b8ff2f3437a1198eb24347b7a15d1e4b;hb=refs%2Fheads%2Fctables7;hp=f1580cd6b5815d75401eca751896f23f774a1f0b;hpb=e2da62d735c597afeef2e0e9b36e5a4a83d7da94;p=pspp diff --git a/utilities/pspp-convert.1 b/utilities/pspp-convert.1 index f1580cd6b5..db4982b3b8 100644 --- a/utilities/pspp-convert.1 +++ b/utilities/pspp-convert.1 @@ -1,4 +1,18 @@ .\" -*- nroff -*- +.\" Copyright (C) 2020 Free Software Foundation + +.\" This program is free software: you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation, either version 3 of the License, or +.\" (at your option) any later version. + +.\" This program is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. + +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see . .de IQ . br . ns @@ -7,7 +21,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 data files to other formats . .SH SYNOPSIS \fBpspp\-convert\fR [\fIoptions\fR] \fIinput\fR \fIoutput\fR @@ -17,14 +31,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,11 +59,23 @@ 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 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" @@ -66,6 +95,85 @@ 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\-k \fIvar\fR..." +.IQ "\fB\-\-keep=\fIvar\fR..." +Drops all variables except those listed as \fIvar\fR, and reorders the +remaining variables into the specified order. +. +.IP "\fB\-d \fIvar\fR..." +.IQ "\fB\-\-drop=\fIvar\fR..." +Drops each \fIvar\fR listed from the output. +. +.SS "CSV Output Options" +.PP +These options affect only output to \fB.csv\fR and \fB.txt\fR files. +.IP "\fB\-\-labels\fR" +By default, \fBpspp\-convert\fR writes variables' values to the output. +With this option, \fBpspp\-convert\fR writes value labels. +.IP "\fB\-\-no\-var\-names\fR" +By default, \fRpspp\-convert\fR\fR writes the variable names as the +first line of output. With this option, \fBpspp\-convert\fR omits +this line. +.IP "\fB\-\-recode\fR" +By default, \fBpspp\-convert\fR writes user-missing values as their +regular values. With this option, \fBpspp\-convert\fR recodes them to +system-missing values (which are written as a single space). + +.IP "\fB\-\-print\-formats\fR" +By default, \fBpspp\-convert\fR writes numeric variables as plain +numbers. This option makes \fBpspp\-convert\fR honor variables' +print formats. + +.IP "\fB\-\-decimal=\fIdecimal\fR" +This option sets the character used as a decimal point in output. The +default is a period (\fB.\fR). + +.IP "\fB\-\-delimiter=\fIdelimiter\fR" +This option sets the character used to separate fields in output. The +default is a comma (\fB,\fR), unless the decimal point is a comma, in +which case a semicolon (\fB;\fR) is used. + +.IP "\fB\-\-qualifier=\fIqualifier\fR" +The option sets the character used to quote fields that contain the +delimiter. The default is a double quote (\fB\(dq\fR). +. +.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 \fB\-p\fR (or \fB\-\-password\fR), 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 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. @@ -79,5 +187,6 @@ Ben Pfaff. . .SH "SEE ALSO" . +.BR pspp\-output (1), .BR pspp (1), .BR psppire (1).