data-writer: New function dfm_put_record_utf8().
[pspp] / doc / pspp-dump-sav.texi
1 @c PSPP - a program for statistical analysis.
2 @c Copyright (C) 2017, 2020 Free Software Foundation, Inc.
3 @c Permission is granted to copy, distribute and/or modify this document
4 @c under the terms of the GNU Free Documentation License, Version 1.3
5 @c or any later version published by the Free Software Foundation;
6 @c with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
7 @c A copy of the license is included in the section entitled "GNU
8 @c Free Documentation License".
9 @c
10 @node Invoking pspp-dump-sav
11 @chapter Invoking @command{pspp-dump-sav}
12 @cindex Invocation
13 @cindex @command{pspp-dump-sav}
14
15 @command{pspp-dump-sav} is a command-line utility accompanying
16 @pspp{}.  It reads one or more SPSS system files and prints their
17 contents.  The output format is useful for debugging system file
18 readers and writers and for discovering how to interpret unknown or
19 poorly understood records.  End users may find the output useful for
20 providing the PSPP developers information about system files that PSPP
21 does not accurately read.
22
23 Synopsis:
24
25 @display
26 @t{pspp-dump-sav} [@t{-d}[@var{maxcases}] | @t{-@w{-}data}[@t{=}@var{maxcases}]] @var{file}@dots{}
27
28 @t{pspp-dump-sav -@w{-}help} | @t{-h}
29
30 @t{pspp-dump-sav -@w{-}version} | @t{-v}
31 @end display
32
33 The following options are accepted:
34
35 @table @asis
36 @item @t{-d}[@var{maxcases}]
37 @item @t{-@w{-}data}[@t{=}@var{maxcases}]
38 By default, @command{pspp-dump-sav} does not print any of the data in a
39 system file, only the file headers.  Specify this option to print the
40 data as well.  If @var{maxcases} is specified, then it limits the
41 number of cases printed.
42
43 @item @t{-h}
44 @itemx @t{-@w{-}help}
45 Prints a usage message on stdout and exits.
46
47 @item @t{-v}
48 @itemx @t{-@w{-}version}
49 Prints version information on stdout and exits.
50 @end table
51
52 Some errors that prevent files from being interpreted successfully
53 cause @command{pspp-dump-sav} to exit without reading any additional
54 files given on the command line.