.br
\fBpspp\-output \fR[\fIoptions\fR] \fBconvert\fR \fIsource destination\fR
.br
+\fBpspp\-output \fR[\fIoptions\fR] \fBget\-table\-look\fR \fIsource destination\fR
+.br
+\fBpspp\-output \fR[\fIoptions\fR] \fBconvert\-table\-look\fR \fIsource destination\fR
+.br
\fBpspp\-output \-\-help\fR | \fB\-h\fR
.br
\fBpspp\-output \-\-version\fR | \fB\-v\fR
to another format, writing the output to \fIdestination\fR.
.PP
By default, \fBpspp\-output\fR infers the intended format for
-\fIdestination\fR from its extension:
-.
-.IP \fBcsv\fR
-.IQ \fBtxt\fR
-Comma-separated value. Each value is formatted according to its
-variable's print format. The first line in the file contains variable
-names.
-.
-.IP \fBsav\fR
-.IQ \fBsys\fR
-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.)
+\fIdestination\fR from its extension. The known extensions are
+generally: \fBcsv html list odt pdf ps spv svg txt\fR. Use
+\fB\-\-help\fR to see an accurate list, since a given installation
+might be built without support for some formats.
.PP
See the \fBInput Selection Options\fR section below for information on
the options available to select a subset of objects to include in the
By default, if the source is corrupt or otherwise cannot be processed,
the destination is not written. These option make \fBpspp\-output\fR
write the output as best it can, even with errors.
+.IP \fB\-\-table\-look=\fIfile\fR
+Reads a table style from \fIfile\fR and applies it to all of the
+output tables. The file should a TableLook \fB.stt\fR or \fB.tlo\fR
+file.
+.SS The \fBget\-table\-look\fR command
+When invoked as \fBpspp\-output get\-table\-look \fIsource
+destination\fR, \fBpspp\-output\fR reads SPV file \fIsource\fR,
+applies any selection options (as described under \fBInput Selection
+Options\fR below), picks the first table from the selected object,
+extracts the TableLook from that table, and writes it to
+\fIdestination\fR (typically with an \fB.stt\fR extension) in the
+TableLook XML format.
+.PP
+The user may use the TableLook file to change the style of tables in
+other files, by passing it to the \fB\-\-table\-look\fR option on the
+\fBconvert\fR command.
+.SS The \fBconvert\-table\-look\fR command
+When invoked as \fBpspp\-output convert\-table\-look \fIsource
+destination\fR, \fBpspp\-output\fR reads \fB.stt\fR or \fR.tlo\fR file
+\fIsource\fR, and writes it back to \fIdestination\fR (typically with
+an \fB.stt\fR extension) in the TableLook XML format. This is useful
+for converting a TableLook \fB.tlo\fR file from SPSS 15 or earlier
+into the newer \fB.stt\fR format.
.SS "Input Selection Options"
The \fBdir\fR and \fBconvert\fR commands, by default, operate on all
of the objects in the source SPV file, except for objects that are not
The \fB\-\-labels\fR option matches the labels in table output (that
is, the table titles). Labels are affected by the output language,
variable names and labels, split file settings, and other factors.
+.IP "\-\-nth-commands=\fIn\fR..."
+Include only objects from the \fIn\fRth command that matches
+\fB\-\-commands\fR (or the \fIn\fRth command overall if
+\fB\-\-commands\fR is not specified), where \fIn\fR is 1 for the first
+command, 2 for the second, and so on.
.IP "\fB\-\-instances=\fIinstance\fR..."
Include the specified \fIinstance\fR of an object that matches the
other criteria within a single command. The \fIinstance\fR may be a
projects / pspp / blobdiff