foomatic-ppd-options.1.in 1.53 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62
.\" This -*- nroff -*- source file is part of foomatic.
.\"
.TH FOOMATIC-PPD-OPTIONS 1 "2003-09-16" "Foomatic Project"
.SH NAME
foomatic-ppd-options \- show the PPD options
.SH SYNOPSIS
.B foomatic-ppd-options [-d=debuglevel] [ ppdfiles ]

.SH DESCRIPTION

The
.B foomatic-ppd-options
program reads the specified PPD files or stdin and decodes the PPD file
to produce a list of options.
This is really just a text based version of other print configuration
tools.

.PP
The output format consists of a set of lines,
each starting with a keyword, followed by a set of options and the default value.
For example:
.RS
.nf

makemodel = Tektronix Phaser 350 Foomatic/Postscript (recommended)
name=PageSize; default=Letter; options=Letter (US Letter), \e
    A4 (A4), 11x17 (11x17), A3 (A3), A5 (A5), B5 (B5 \e(JIS\e)),...
name=PageRegion; default=Letter; options=Letter (US Letter), A4 (A4), ...
.fi
.RE

.PP
Each option starts with the
.B name
tag,
followed by a default value (if any),
followed by the set of options and a comment describing them.
Punctuation in the comment is escaped.
.SS Options
.TP 5
.BI \-d debuglevel
Set the debug level. 0 disables debug messages.

.TP 5
.BI  [\ files\ ]
The list of PPD files to read for options.
A '-' causes STDIN to be read.

.\".SH SEE ALSO
.\".IR foomatic-XXX (1),

.SH EXIT STATUS
.B foomatic-ppd-options
exits with a 0 status if successful, and nonzero if an error.
An error message is also printed on standard error (STDERR).

.SH AUTHOR
Patrick Powell <papowell at astart.com>

.SH BUGS
Probably.  But it has been tested.