B.5 Output devices

Configuring output devices is the most complicated aspect of configuring PSPP. The output device configuration file is named devices. It is searched for using the usual algorithm for finding configuration files (see File locations). Each line in the file is read in the usual manner for configuration files (see Configuration files).

Lines in devices are divided into three categories, described briefly in the table below:

driver category definitions

Define a driver in terms of other drivers.

macro definitions

Define environment variables local to the the output driver configuration file.

device definitions

Describe the configuration of an output device.

The following sections further elaborate the contents of the devices file.

• Driver categories: How to organize the driver namespace.
• Macro definitions: Environment variables local to devices.
• Device definitions: Output device descriptions.
• Dimensions: Lengths, widths, sizes, ....
• papersize: Letter, legal, A4, envelope, ....
• Distinguishing line types: Details on devices parsing.
• Tokenizing lines: Dividing devices lines into tokens.