2 .\" "$Id: ppdcfile.man 7607 2008-05-21 01:06:23Z mike $"
4 .\" ppdcfile man page for the Common UNIX Printing System.
6 .\" Copyright 2007-2008 by Apple Inc.
7 .\" Copyright 1997-2007 by Easy Software Products.
9 .\" These coded instructions, statements, and computer programs are the
10 .\" property of Apple Inc. and are protected by Federal copyright
11 .\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
12 .\" which should have been included with this file. If this file is
13 .\" file is missing or damaged, see the license at "http://www.cups.org/".
15 .TH ppdcfile 5 "Common UNIX Printing System" "20 May 2008" "Apple Inc."
17 ppdcfile \- cups ppd compiler source file format
19 The CUPS PPD compiler reads meta files that contain descriptions
20 of one or more PPD files to be generated by \fIppdc\fR. This man
21 page provides a quick reference to the supported keywords and
22 should be used in conjuction with the Common UNIX Printing System
25 The source file format is plain ASCII text that can be edited
26 using your favorite text editor. Comments are supported using
27 the C (/* ... */) and C++ (// ...) comment mechanisms.
29 Printer driver information can be grouped and shared using
30 curley braces ({ ... }); PPD files are written when a close
31 brace or end-of-file is seen and a PCFileName directive has been
34 Directives may be placed anywhere on a line and are followed by
35 one or more values. The following is a list of the available
36 directives and the values they accept:
38 \fB#define\fR name value
40 \fB#elif\fR {name | value}
46 \fB#font\fR name encoding "version" charset status
48 \fB#if\fR {name | value}
50 \fB#include\fR <filename>
52 \fB#include\fR "filename"
54 \fB#media\fR name width length
56 \fB#media\fR "name/text" width length
58 \fB#po\fR locale "filename.po"
60 \fBAttribute\fR name "" value
62 \fBAttribute\fR name keyword value
64 \fBAttribute\fR name "keyword/text" value
66 \fBChoice\fR name "code"
68 \fBChoice\fR "name/text" "code"
70 \fBColorDevice\fR boolean-value
72 \fBColorModel\fR name colorspace colororder compression
74 \fBColorModel\fR "name/text" colorspace colororder compression
76 \fBColorProfile\fR resolution/mediatype gamma density matrix
78 \fBCopyright\fR "text"
80 \fBCustomMedia\fR name width length left bottom right top "size-code" "region-code"
82 \fBCustomMedia\fR "name/text" width length left bottom right top "size-code" "region-code"
84 \fBCutter\fR boolean-value
86 \fBDarkness\fR temperature name
88 \fBDarkness\fR temperature "name/text"
94 \fBFilter\fR mime-type cost program
98 \fBFinishing\fR "name/text"
102 \fBFont\fR name encoding "version" charset status
106 \fBGroup\fR "name/text"
108 \fBHWMargins\fR left bottom right top
110 \fBInputSlot\fR position name
112 \fBInputSlot\fR position "name/text"
114 \fBInstallable\fR name
116 \fBInstallable\fR "name/text"
118 \fBLocAttribute\fR name "keyword/text" value
120 \fBManualCopies\fR boolean-value
122 \fBManufacturer\fR "name"
124 \fBMaxSize\fR width length
128 \fBMediaType\fR type name
130 \fBMediaType\fR type "name/text"
132 \fBMinSize\fR width length
134 \fBModelName\fR "name"
136 \fBModelNumber\fR number
138 \fBOption\fR name type section order
140 \fBOption\fR "name/text" type section order
142 \fBPCFileName\fR "filename.ppd"
144 \fBResolution\fR colorspace bits-per-color row-count row-feed row-step name
146 \fBResolution\fR colorspace bits-per-color row-count row-feed row-step "name/text"
148 \fBSimpleColorProfile\fR resolution/mediatype density yellow-density red-density gamma red-adjust green-adjust blue-adjust
150 \fBThroughput\fR pages-per-minute
152 \fBUIConstraints\fR "*Option1 *Option2"
154 \fBUIConstraints\fR "*Option1 Choice1 *Option2"
156 \fBUIConstraints\fR "*Option1 *Option2 Choice2"
158 \fBUIConstraints\fR "*Option1 Choice1 *Option2 Choice2"
160 \fBVariablePaperSize\fR boolean-value
164 ppdc(1), ppdhtml(1), ppdi(1), ppdmerge(1), ppdpo(1)
166 http://localhost:631/help
168 Copyright 2007-2008 by Apple Inc.
170 .\" End of "$Id: ppdcfile.man 7607 2008-05-21 01:06:23Z mike $".