work on docs
[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.  The output format is useful for
36 debugging system file readers and writers and for discovering how to
37 interpret unknown or poorly understood records.  End users may find
38 the output useful for providing the PSPP developers information about
39 system files that PSPP does not accurately read.
40 .
41 .SH "OPTIONS"
42 .
43 .IP "\fB\-d\fR[\fImaxcases\fR]"
44 .IQ "\fB\-\-data\fR[\fB=\fImaxcases\fR]"
45 By default, \fBpspp\-dump\-sav\fR does not print any of the data in a
46 system file, only the file headers.  Specify this option to print the
47 data as well.  If \fImaxcases\fR is specified, then it limits the
48 number of cases printed.
49 .
50 .IP "\fB\-h\fR"
51 .IQ "\fB\-\-help\fR"
52 Prints a usage message on stdout and exits.
53 .
54 .IP "\fB\-v\fR"
55 .IQ "\fB\-\-version\fR"
56 Prints version information on stdout and exits.
57 .
58 .SH "BUGS"
59 Some errors that prevent files from being interpreted successfully
60 cause \fBpspp\-dump\-sav\fR to exit without reading any additional
61 files given on the command line.
62 .
63 .SH "AUTHORS"
64 Ben Pfaff and John Darrington.
65 .
66 .SH "SEE ALSO"
67 .
68 .BR pspp (1),
69 .BR psppire (1).