1 @node Invoking pspp-convert
2 @chapter Invoking @command{pspp-convert}
4 @cindex @command{pspp-convert}
6 @command{pspp-convert} is a command-line utility accompanying
7 @pspp{}. It reads an SPSS system or portable file @var{input} and
8 writes a copy of it to another @var{output} in a different format.
12 @t{pspp-convert} [@var{options}] @var{input} @var{output}
14 @t{pspp-convert -@w{-}help}
16 @t{pspp-convert -@w{-}version}
19 The format of @var{Iinput} is automatically detected, except that the
20 character encoding of old system files cannot always be guessed
21 correctly. Use @code{-e @var{encoding}} to specify the encoding in this
24 By default, the intended format for @var{output} is inferred based on its
30 Comma-separated value. Each value is formatted according to its
31 variable's print format. The first line in the file contains variable
42 Use @code{-O @var{extension}} to override the inferred format or to
43 specify the format for unrecognized extensions.
45 The following options are accepted:
49 @itemx --output-format=@var{format}
50 Specifies the desired output format. @var{format} must be one of the
51 extensions listed above, e.g. @code{-O csv} requests comma-separated
54 @item -c @var{maxcases}
55 @itemx --cases=@var{maxcases}
56 By default, all cases are copied from @var{input} to @var{output}.
57 Specifying this option to limit the number of cases written to
58 @var{output} to @var{maxcases}.
60 @item -e @var{charset}
61 @itemx --encoding=@var{charset}
62 Overrides the encoding in which character strings in @var{input} are
63 interpreted. This option is necessary because old SPSS system files
64 do not self-identify their encoding.
68 Prints a usage message on stdout and exits.
72 Prints version information on stdout and exits.