Invoking pspp-convert
*********************

pspp-convert is a command-line utility accompanying pspp. It reads an SPSS system or portable file INPUT and writes a copy of it to another OUTPUT in a different format. Synopsis:

     pspp-convert [OPTIONS] INPUT OUTPUT

     pspp-convert --help

     pspp-convert --version

The format of IINPUT is automatically detected, except that the character encoding of old system files cannot always be guessed correctly.  Use -e ENCODING to specify the encoding in this case.

By default, the intended format for OUTPUT is inferred based on its extension:

csv
txt
     Comma-separated value.  Each value is formatted according to its variable's print format.  The first line in the file contains variable names.

sav

sys
     SPSS system file.

por
     SPSS portable file.

Use -O EXTENSION to override the inferred format or to specify the format for unrecognized extensions.

The following options are accepted:

-O FORMAT
--output-format=FORMAT
     Specifies the desired output format.  FORMAT must be one of the extensions listed above, e.g. -O csv requests comma-separated value output.

-c MAXCASES
--cases=MAXCASES
     By default, all cases are copied from INPUT to OUTPUT. Specifying this option to limit the number of cases written to OUTPUT to MAXCASES.

-e CHARSET
--encoding=CHARSET
     Overrides the encoding in which character strings in INPUT are interpreted.  This option is necessary because old SPSS system files do not self-identify their encoding.

-h
--help
     Prints a usage message on stdout and exits.

-v
--version
     Prints version information on stdout and exits.