]>
Commit | Line | Data |
---|---|---|
ac884b6a | 1 | .\" |
53480915 | 2 | .\" ppdcfile man page for CUPS. |
ac884b6a | 3 | .\" |
87030afb MS |
4 | .\" Copyright © 2007-2019 by Apple Inc. |
5 | .\" Copyright © 1997-2007 by Easy Software Products. | |
ac884b6a | 6 | .\" |
87030afb MS |
7 | .\" Licensed under Apache License v2.0. See the file "LICENSE" for more |
8 | .\" information. | |
ac884b6a | 9 | .\" |
87030afb | 10 | .TH ppdcfile 5 "CUPS" "26 April 2019" "Apple Inc." |
ac884b6a | 11 | .SH NAME |
87030afb | 12 | ppdcfile \- cups ppd compiler source file format (deprecated) |
ac884b6a | 13 | .SH DESCRIPTION |
53480915 MS |
14 | The CUPS PPD compiler reads meta files that contain descriptions of one or more PPD files to be generated by |
15 | .BR ppdc (1). | |
16 | This man page provides a quick reference to the supported keywords and should be used in conjunction with the online help for CUPS. | |
ac884b6a | 17 | .PP |
53480915 | 18 | 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. |
ac884b6a | 19 | .PP |
53480915 | 20 | 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. |
ac884b6a | 21 | .PP |
53480915 | 22 | 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: |
ac884b6a | 23 | .TP 5 |
53480915 | 24 | \fB#define \fIname value\fR |
ac884b6a | 25 | .TP 5 |
53480915 | 26 | \fB#elif \fR{\fIname \fR| \fIvalue\fR} |
bdd6c45b MS |
27 | .TP 5 |
28 | \fB#else\fR | |
29 | .TP 5 | |
30 | \fB#endif\fR | |
31 | .TP 5 | |
53480915 | 32 | \fB#font \fIname encoding "version" charset status\fR |
ac884b6a | 33 | .TP 5 |
53480915 | 34 | \fB#if \fR{\fIname \fR| \fIvalue\fR} |
bdd6c45b | 35 | .TP 5 |
53480915 | 36 | \fB#include <\fIfilename\fB>\fR |
ac884b6a | 37 | .TP 5 |
53480915 | 38 | \fB#include "\fIfilename\fB"\fR |
ac884b6a | 39 | .TP 5 |
53480915 | 40 | \fB#media \fIname width length\fR |
ac884b6a | 41 | .TP 5 |
53480915 | 42 | \fB#media "\fIname\fB/\fItext\fB" \fIwidth length\fR |
ac884b6a | 43 | .TP 5 |
53480915 | 44 | \fB#po \fIlocale \fB"\fIfilename\fB"\fR |
ac884b6a | 45 | .TP 5 |
53480915 | 46 | \fBAttribute \fIname \fB"" \fIvalue\fR |
ac884b6a | 47 | .TP 5 |
53480915 | 48 | \fBAttribute \fIname keyword value\fR |
ac884b6a | 49 | .TP 5 |
53480915 | 50 | \fBAttribute \fIname \fB"\fIkeyword\fB/\fItext\fB" \fIvalue\fR |
ac884b6a | 51 | .TP 5 |
53480915 | 52 | \fBChoice \fIname \fB"\fIcode\fB"\fR |
ac884b6a | 53 | .TP 5 |
53480915 | 54 | \fBChoice \fB"\fIname\fB/\fItext\fB" "\fIcode\fB"\fR |
ac884b6a | 55 | .TP 5 |
53480915 | 56 | \fBColorDevice \fIboolean-value\fR |
ac884b6a | 57 | .TP 5 |
53480915 | 58 | \fBColorModel \fIname colorspace colororder compression\fR |
ac884b6a | 59 | .TP 5 |
53480915 | 60 | \fBColorModel "\fIname\fB/\fItext\fB" \fIcolorspace colororder compression\fR |
ac884b6a | 61 | .TP 5 |
53480915 | 62 | \fBColorProfile \fIresolution\fB/\fImediatype gamma density matrix\fR |
ac884b6a | 63 | .TP 5 |
53480915 | 64 | \fBCopyright "\fItext\fR" |
ac884b6a | 65 | .TP 5 |
53480915 | 66 | \fBCustomMedia \fIname width length left bottom right top \fB"\fIsize-code\fB" "\fIregion-code\fB"\fR |
ac884b6a | 67 | .TP 5 |
53480915 | 68 | \fBCustomMedia "\fIname\fB/\fItext\fB" \fIwidth length left bottom right top \fB"\fIsize-code\fB" "\fIregion-code\fB"\fR |
ac884b6a | 69 | .TP 5 |
53480915 | 70 | \fBCutter \fIboolean-value\fR |
ac884b6a | 71 | .TP 5 |
53480915 | 72 | \fBDarkness \fItemperature name\fR |
ac884b6a | 73 | .TP 5 |
53480915 | 74 | \fBDarkness \fItemperature \fB"\fIname\fB/\fItext\fB"\fR |
ac884b6a | 75 | .TP 5 |
53480915 | 76 | \fBDriverType \fItype\fR |
ac884b6a | 77 | .TP 5 |
53480915 | 78 | \fBDuplex \fItype\fR |
ac884b6a | 79 | .TP 5 |
8be431f2 | 80 | \fBFilter \fImime-type cost program\fR |
ac884b6a | 81 | .TP 5 |
53480915 | 82 | \fBFinishing \fIname\fR |
ac884b6a | 83 | .TP 5 |
53480915 | 84 | \fBFinishing "\fIname\fB/\fItext\fB"\fR |
ac884b6a | 85 | .TP 5 |
53480915 | 86 | \fBFont *\fR |
ac884b6a | 87 | .TP 5 |
53480915 | 88 | \fBFont \fIname encoding \fB"\fIversion\fB" \fIcharset status\fR |
ac884b6a | 89 | .TP 5 |
53480915 | 90 | \fBGroup \fIname\fR |
ac884b6a | 91 | .TP 5 |
53480915 | 92 | \fBGroup "\fIname\fB/\fItext\fB"\fR |
ac884b6a | 93 | .TP 5 |
53480915 | 94 | \fBHWMargins \fIleft bottom right top\fR |
ac884b6a | 95 | .TP 5 |
53480915 | 96 | \fBInputSlot \fIposition name\fR |
ac884b6a | 97 | .TP 5 |
53480915 | 98 | \fBInputSlot \fIposition \fB"\fIname\fB/\fItext\fB"\fR |
ac884b6a | 99 | .TP 5 |
53480915 | 100 | \fBInstallable \fIname\fR |
ac884b6a | 101 | .TP 5 |
53480915 | 102 | \fBInstallable "\fIname\fB/\fItext\fB"\fR |
ac884b6a | 103 | .TP 5 |
53480915 | 104 | \fBLocAttribute \fIname \fB"\fIkeyword\fB/\fItext\fB" \fIvalue\fR |
bdd6c45b | 105 | .TP 5 |
53480915 | 106 | \fBManualCopies \fIboolean-value\fR |
ac884b6a | 107 | .TP 5 |
53480915 | 108 | \fBManufacturer "\fIname\fB"\fR |
ac884b6a | 109 | .TP 5 |
53480915 | 110 | \fBMaxSize \fIwidth length\fR |
ac884b6a | 111 | .TP 5 |
53480915 | 112 | \fBMediaSize \fIname\fR |
ac884b6a | 113 | .TP 5 |
53480915 | 114 | \fBMediaType \fItype name\fR |
ac884b6a | 115 | .TP 5 |
53480915 | 116 | \fBMediaType \fItype \fB"\fIname\fB/\fItext\fB"\fR |
ac884b6a | 117 | .TP 5 |
53480915 | 118 | \fBMinSize \fIwidth length\fR |
ac884b6a | 119 | .TP 5 |
53480915 | 120 | \fBModelName "\fIname\fB"\fR |
ac884b6a | 121 | .TP 5 |
53480915 | 122 | \fBModelNumber \fInumber\fR |
ac884b6a | 123 | .TP 5 |
53480915 | 124 | \fBOption \fIname type section order\fR |
ac884b6a | 125 | .TP 5 |
53480915 | 126 | \fBOption "\fIname\fB/\fItext\fB" \fItype section order\fR |
ac884b6a | 127 | .TP 5 |
53480915 | 128 | \fBPCFileName "\fIfilename.ppd\fB"\fR |
ac884b6a | 129 | .TP 5 |
53480915 | 130 | \fBResolution \fIcolorspace bits-per-color row-count row-feed row-step name\fR |
ac884b6a | 131 | .TP 5 |
53480915 | 132 | \fBResolution \fIcolorspace bits-per-color row-count row-feed row-step \fB"\fIname\fB/\fItext\fB"\fR |
ac884b6a | 133 | .TP 5 |
53480915 | 134 | \fBSimpleColorProfile \fIresolution\fB/\fImediatype density yellow-density red-density gamma red-adjust green-adjust blue-adjust\fR |
ac884b6a | 135 | .TP 5 |
53480915 | 136 | \fBThroughput \fIpages-per-minute\fR |
ac884b6a | 137 | .TP 5 |
53480915 | 138 | \fBUIConstraints "\fI*Option1 *Option2\fB"\fR |
ac884b6a | 139 | .TP 5 |
53480915 | 140 | \fBUIConstraints "\fI*Option1 Choice1 *Option2\fB"\fR |
ac884b6a | 141 | .TP 5 |
53480915 | 142 | \fBUIConstraints "\fI*Option1 *Option2 Choice2\fB"\fR |
ac884b6a | 143 | .TP 5 |
53480915 | 144 | \fBUIConstraints "\fI*Option1 Choice1 *Option2 Choice2\fB"\fR |
ac884b6a | 145 | .TP 5 |
53480915 | 146 | \fBVariablePaperSize \fIboolean-value\fR |
ac884b6a | 147 | .TP 5 |
53480915 | 148 | \fBVersion \fInumber\fR |
87030afb MS |
149 | .SH NOTES |
150 | PPD files are deprecated and will no longer be supported in a future feature release of CUPS. | |
151 | Printers that do not support IPP can be supported using applications such as | |
152 | .BR ippeveprinter (1). | |
ac884b6a | 153 | .SH SEE ALSO |
53480915 MS |
154 | .BR ppdc (1), |
155 | .BR ppdhtml (1), | |
156 | .BR ppdi (1), | |
157 | .BR ppdmerge (1), | |
158 | .BR ppdpo (1), | |
159 | CUPS Online Help (http://localhost:631/help) | |
ac884b6a | 160 | .SH COPYRIGHT |
87030afb | 161 | Copyright \[co] 2007-2019 by Apple Inc. |