Work on support for variable sets.
[pspp] / utilities / pspp-dump-sav.1
1 .\" -*- nroff -*-
2 .\" Copyright (C) 2020  Free Software Foundation
3
4 .\" This program is free software: you can redistribute it and/or modify
5 .\" it under the terms of the GNU General Public License as published by
6 .\" the Free Software Foundation, either version 3 of the License, or
7 .\" (at your option) any later version.
8
9 .\" This program is distributed in the hope that it will be useful,
10 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
11 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12 .\" GNU General Public License for more details.
13
14 .\" You should have received a copy of the GNU General Public License
15 .\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
16 .de IQ
17 .  br
18 .  ns
19 .  IP "\\$1"
20 ..
21 .TH pspp\-dump\-sav 1 "January 2012" "PSPP" "PSPP Manual"
22 .
23 .SH NAME
24 pspp\-dump\-sav \- dissect SPSS system file
25 .
26 .SH SYNOPSIS
27 \fBpspp\-dump\-sav\fR [\fB\-d \fR| \fB\-\-data\fR[\fB=\fImaxcases\fR]] \fIfile\fR...
28 .br
29 \fBpspp\-dump\-sav \-\-help\fR | \fB\-h\fR
30 .br
31 \fBpspp\-dump\-sav \-\-version\fR | \fB\-v\fR
32 .
33 .SH DESCRIPTION
34 The \fBpspp\-dump\-sav\fR program reads each SPSS system file
35 \fIfile\fR and prints its contents.  It is not installed by
36 default, so it may be missing from your PSPP installation.
37 The output format is useful for
38 debugging system file readers and writers and for discovering how to
39 interpret unknown or poorly understood records.  End users may find
40 the output useful for providing the PSPP developers information about
41 system files that PSPP does not accurately read.
42 .
43 .SH "OPTIONS"
44 .
45 .IP "\fB\-d\fR[\fImaxcases\fR]"
46 .IQ "\fB\-\-data\fR[\fB=\fImaxcases\fR]"
47 By default, \fBpspp\-dump\-sav\fR does not print any of the data in a
48 system file, only the file headers.  Specify this option to print the
49 data as well.  If \fImaxcases\fR is specified, then it limits the
50 number of cases printed.
51 .
52 .IP "\fB\-h\fR"
53 .IQ "\fB\-\-help\fR"
54 Prints a usage message on stdout and exits.
55 .
56 .IP "\fB\-v\fR"
57 .IQ "\fB\-\-version\fR"
58 Prints version information on stdout and exits.
59 .
60 .SH "BUGS"
61 Some errors that prevent files from being interpreted successfully
62 cause \fBpspp\-dump\-sav\fR to exit without reading any additional
63 files given on the command line.
64 .
65 .SH "AUTHORS"
66 Ben Pfaff and John Darrington.
67 .
68 .SH "SEE ALSO"
69 .
70 .BR pspp (1),
71 .BR psppire (1).