X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=utilities%2Fpspp-convert.1;h=6c8874a530ac5fcc2a3f5929dd5516757b0bfe39;hb=6c8b13da57b074620495a0543bd7944bca574a42;hp=6e2e9f5224fa2abb3b505d2c0da4d7c28406c8fa;hpb=788d080e2302048dbcb5ae74c9d5ac38a01bc889;p=pspp diff --git a/utilities/pspp-convert.1 b/utilities/pspp-convert.1 index 6e2e9f5224..6c8874a530 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 files to other formats +pspp\-convert \- convert SPSS data files to other formats . .SH SYNOPSIS \fBpspp\-convert\fR [\fIoptions\fR] \fIinput\fR \fIoutput\fR @@ -55,9 +55,10 @@ 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" @@ -80,10 +81,52 @@ 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 \f\-p\fR (or \fB\-\-password), or the name of a file containing a +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 @@ -130,5 +173,6 @@ Ben Pfaff. . .SH "SEE ALSO" . +.BR pspp\-output (1), .BR pspp (1), .BR psppire (1).