Add support for .tlo TableLook files from SPSS 15 and earlier.

[pspp] / utilities / pspp-output.1

diff --git a/utilities/pspp-output.1 b/utilities/pspp-output.1
index 598b6f9ddc2b621c7e5e6ecfc861faa19b237764..941c6684f7bfe14a296a5da9624fdb38bc4c687d 100644 (file)
--- a/utilities/pspp-output.1
+++ b/utilities/pspp-output.1
@@ -16,6 +16,10 @@ pspp\-output \- convert and operate on SPSS viewer (SPV) files
 .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
@@ -82,7 +86,27 @@ 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 file.
+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