| .\" |
| .\" ppdcfile man page for CUPS. |
| .\" |
| .\" Copyright © 2007-2019 by Apple Inc. |
| .\" Copyright © 1997-2007 by Easy Software Products. |
| .\" |
| .\" Licensed under Apache License v2.0. See the file "LICENSE" for more |
| .\" information. |
| .\" |
| .TH ppdcfile 5 "CUPS" "26 April 2019" "Apple Inc." |
| .SH NAME |
| ppdcfile \- cups ppd compiler source file format (deprecated) |
| .SH DESCRIPTION |
| The CUPS PPD compiler reads meta files that contain descriptions of one or more PPD files to be generated by |
| .BR ppdc (1). |
| This man page provides a quick reference to the supported keywords and should be used in conjunction with the online help for CUPS. |
| .PP |
| The source file format is plain ASCII text that can be edited using your favorite text editor. Comments are supported using the C (/* ... */) and C++ (// ...) comment mechanisms. |
| .PP |
| Printer driver information can be grouped and shared using curly braces ({ ... }); PPD files are written when a close brace or end-of-file is seen and a PCFileName directive has been defined. |
| .PP |
| Directives may be placed anywhere on a line and are followed by one or more values. The following is a list of the available directives and the values they accept: |
| .TP 5 |
| \fB#define \fIname value\fR |
| .TP 5 |
| \fB#elif \fR{\fIname \fR| \fIvalue\fR} |
| .TP 5 |
| \fB#else\fR |
| .TP 5 |
| \fB#endif\fR |
| .TP 5 |
| \fB#font \fIname encoding "version" charset status\fR |
| .TP 5 |
| \fB#if \fR{\fIname \fR| \fIvalue\fR} |
| .TP 5 |
| \fB#include <\fIfilename\fB>\fR |
| .TP 5 |
| \fB#include "\fIfilename\fB"\fR |
| .TP 5 |
| \fB#media \fIname width length\fR |
| .TP 5 |
| \fB#media "\fIname\fB/\fItext\fB" \fIwidth length\fR |
| .TP 5 |
| \fB#po \fIlocale \fB"\fIfilename\fB"\fR |
| .TP 5 |
| \fBAttribute \fIname \fB"" \fIvalue\fR |
| .TP 5 |
| \fBAttribute \fIname keyword value\fR |
| .TP 5 |
| \fBAttribute \fIname \fB"\fIkeyword\fB/\fItext\fB" \fIvalue\fR |
| .TP 5 |
| \fBChoice \fIname \fB"\fIcode\fB"\fR |
| .TP 5 |
| \fBChoice \fB"\fIname\fB/\fItext\fB" "\fIcode\fB"\fR |
| .TP 5 |
| \fBColorDevice \fIboolean-value\fR |
| .TP 5 |
| \fBColorModel \fIname colorspace colororder compression\fR |
| .TP 5 |
| \fBColorModel "\fIname\fB/\fItext\fB" \fIcolorspace colororder compression\fR |
| .TP 5 |
| \fBColorProfile \fIresolution\fB/\fImediatype gamma density matrix\fR |
| .TP 5 |
| \fBCopyright "\fItext\fR" |
| .TP 5 |
| \fBCustomMedia \fIname width length left bottom right top \fB"\fIsize-code\fB" "\fIregion-code\fB"\fR |
| .TP 5 |
| \fBCustomMedia "\fIname\fB/\fItext\fB" \fIwidth length left bottom right top \fB"\fIsize-code\fB" "\fIregion-code\fB"\fR |
| .TP 5 |
| \fBCutter \fIboolean-value\fR |
| .TP 5 |
| \fBDarkness \fItemperature name\fR |
| .TP 5 |
| \fBDarkness \fItemperature \fB"\fIname\fB/\fItext\fB"\fR |
| .TP 5 |
| \fBDriverType \fItype\fR |
| .TP 5 |
| \fBDuplex \fItype\fR |
| .TP 5 |
| \fBFilter \fImime-type cost program\fR |
| .TP 5 |
| \fBFinishing \fIname\fR |
| .TP 5 |
| \fBFinishing "\fIname\fB/\fItext\fB"\fR |
| .TP 5 |
| \fBFont *\fR |
| .TP 5 |
| \fBFont \fIname encoding \fB"\fIversion\fB" \fIcharset status\fR |
| .TP 5 |
| \fBGroup \fIname\fR |
| .TP 5 |
| \fBGroup "\fIname\fB/\fItext\fB"\fR |
| .TP 5 |
| \fBHWMargins \fIleft bottom right top\fR |
| .TP 5 |
| \fBInputSlot \fIposition name\fR |
| .TP 5 |
| \fBInputSlot \fIposition \fB"\fIname\fB/\fItext\fB"\fR |
| .TP 5 |
| \fBInstallable \fIname\fR |
| .TP 5 |
| \fBInstallable "\fIname\fB/\fItext\fB"\fR |
| .TP 5 |
| \fBLocAttribute \fIname \fB"\fIkeyword\fB/\fItext\fB" \fIvalue\fR |
| .TP 5 |
| \fBManualCopies \fIboolean-value\fR |
| .TP 5 |
| \fBManufacturer "\fIname\fB"\fR |
| .TP 5 |
| \fBMaxSize \fIwidth length\fR |
| .TP 5 |
| \fBMediaSize \fIname\fR |
| .TP 5 |
| \fBMediaType \fItype name\fR |
| .TP 5 |
| \fBMediaType \fItype \fB"\fIname\fB/\fItext\fB"\fR |
| .TP 5 |
| \fBMinSize \fIwidth length\fR |
| .TP 5 |
| \fBModelName "\fIname\fB"\fR |
| .TP 5 |
| \fBModelNumber \fInumber\fR |
| .TP 5 |
| \fBOption \fIname type section order\fR |
| .TP 5 |
| \fBOption "\fIname\fB/\fItext\fB" \fItype section order\fR |
| .TP 5 |
| \fBPCFileName "\fIfilename.ppd\fB"\fR |
| .TP 5 |
| \fBResolution \fIcolorspace bits-per-color row-count row-feed row-step name\fR |
| .TP 5 |
| \fBResolution \fIcolorspace bits-per-color row-count row-feed row-step \fB"\fIname\fB/\fItext\fB"\fR |
| .TP 5 |
| \fBSimpleColorProfile \fIresolution\fB/\fImediatype density yellow-density red-density gamma red-adjust green-adjust blue-adjust\fR |
| .TP 5 |
| \fBThroughput \fIpages-per-minute\fR |
| .TP 5 |
| \fBUIConstraints "\fI*Option1 *Option2\fB"\fR |
| .TP 5 |
| \fBUIConstraints "\fI*Option1 Choice1 *Option2\fB"\fR |
| .TP 5 |
| \fBUIConstraints "\fI*Option1 *Option2 Choice2\fB"\fR |
| .TP 5 |
| \fBUIConstraints "\fI*Option1 Choice1 *Option2 Choice2\fB"\fR |
| .TP 5 |
| \fBVariablePaperSize \fIboolean-value\fR |
| .TP 5 |
| \fBVersion \fInumber\fR |
| .SH NOTES |
| PPD files are deprecated and will no longer be supported in a future feature release of CUPS. |
| Printers that do not support IPP can be supported using applications such as |
| .BR ippeveprinter (1). |
| .SH SEE ALSO |
| .BR ppdc (1), |
| .BR ppdhtml (1), |
| .BR ppdi (1), |
| .BR ppdmerge (1), |
| .BR ppdpo (1), |
| CUPS Online Help (http://localhost:631/help) |
| .SH COPYRIGHT |
| Copyright \[co] 2007-2019 by Apple Inc. |