1<!DOCTYPE HTML>
2<html>
3<!-- SECTION: Man Pages -->
4<head>
5	<link rel="stylesheet" type="text/css" href="../cups-printable.css">
6	<title>ppdcfile(5)</title>
7</head>
8<body>
9<h1 class="title">ppdcfile(5)</h1>
10<h2 class="title"><a name="NAME">Name</a></h2>
11ppdcfile - cups ppd compiler source file format (deprecated)
12<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
13The CUPS PPD compiler reads meta files that contain descriptions of one or more PPD files to be generated by
14<b>ppdc</b>(1).
15This man page provides a quick reference to the supported keywords and should be used in conjunction with the online help for CUPS.
16<p>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.
17<p>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.
18<p>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:
19<dl class="man">
20<dt><b>#define </b><i>name value</i>
21<dd style="margin-left: 5.0em"><dt><b>#elif </b>{<i>name </i>| <i>value</i>}
22<dd style="margin-left: 5.0em"><dt><b>#else</b>
23<dd style="margin-left: 5.0em"><dt><b>#endif</b>
24<dd style="margin-left: 5.0em"><dt><b>#font </b><i>name encoding "version" charset status</i>
25<dd style="margin-left: 5.0em"><dt><b>#if </b>{<i>name </i>| <i>value</i>}
26<dd style="margin-left: 5.0em"><dt><b>#include &lt;</b><i>filename</i><b>></b>
27<dd style="margin-left: 5.0em"><dt><b>#include "</b><i>filename</i><b>"</b>
28<dd style="margin-left: 5.0em"><dt><b>#media </b><i>name width length</i>
29<dd style="margin-left: 5.0em"><dt><b>#media "</b><i>name</i><b>/</b><i>text</i><b>" </b><i>width length</i>
30<dd style="margin-left: 5.0em"><dt><b>#po </b><i>locale </i><b>"</b><i>filename</i><b>"</b>
31<dd style="margin-left: 5.0em"><dt><b>Attribute </b><i>name </i><b>"" </b><i>value</i>
32<dd style="margin-left: 5.0em"><dt><b>Attribute </b><i>name keyword value</i>
33<dd style="margin-left: 5.0em"><dt><b>Attribute </b><i>name </i><b>"</b><i>keyword</i><b>/</b><i>text</i><b>" </b><i>value</i>
34<dd style="margin-left: 5.0em"><dt><b>Choice </b><i>name </i><b>"</b><i>code</i><b>"</b>
35<dd style="margin-left: 5.0em"><dt><b>Choice "</b><i>name</i><b>/</b><i>text</i><b>" "</b><i>code</i><b>"</b>
36<dd style="margin-left: 5.0em"><dt><b>ColorDevice </b><i>boolean-value</i>
37<dd style="margin-left: 5.0em"><dt><b>ColorModel </b><i>name colorspace colororder compression</i>
38<dd style="margin-left: 5.0em"><dt><b>ColorModel "</b><i>name</i><b>/</b><i>text</i><b>" </b><i>colorspace colororder compression</i>
39<dd style="margin-left: 5.0em"><dt><b>ColorProfile </b><i>resolution</i><b>/</b><i>mediatype gamma density matrix</i>
40<dd style="margin-left: 5.0em"><dt><b>Copyright "</b><i>text</i>"
41<dd style="margin-left: 5.0em"><dt><b>CustomMedia </b><i>name width length left bottom right top </i><b>"</b><i>size-code</i><b>" "</b><i>region-code</i><b>"</b>
42<dd style="margin-left: 5.0em"><dt><b>CustomMedia "</b><i>name</i><b>/</b><i>text</i><b>" </b><i>width length left bottom right top </i><b>"</b><i>size-code</i><b>" "</b><i>region-code</i><b>"</b>
43<dd style="margin-left: 5.0em"><dt><b>Cutter </b><i>boolean-value</i>
44<dd style="margin-left: 5.0em"><dt><b>Darkness </b><i>temperature name</i>
45<dd style="margin-left: 5.0em"><dt><b>Darkness </b><i>temperature </i><b>"</b><i>name</i><b>/</b><i>text</i><b>"</b>
46<dd style="margin-left: 5.0em"><dt><b>DriverType </b><i>type</i>
47<dd style="margin-left: 5.0em"><dt><b>Duplex </b><i>type</i>
48<dd style="margin-left: 5.0em"><dt><b>Filter </b><i>mime-type cost program</i>
49<dd style="margin-left: 5.0em"><dt><b>Finishing </b><i>name</i>
50<dd style="margin-left: 5.0em"><dt><b>Finishing "</b><i>name</i><b>/</b><i>text</i><b>"</b>
51<dd style="margin-left: 5.0em"><dt><b>Font *</b>
52<dd style="margin-left: 5.0em"><dt><b>Font </b><i>name encoding </i><b>"</b><i>version</i><b>" </b><i>charset status</i>
53<dd style="margin-left: 5.0em"><dt><b>Group </b><i>name</i>
54<dd style="margin-left: 5.0em"><dt><b>Group "</b><i>name</i><b>/</b><i>text</i><b>"</b>
55<dd style="margin-left: 5.0em"><dt><b>HWMargins </b><i>left bottom right top</i>
56<dd style="margin-left: 5.0em"><dt><b>InputSlot </b><i>position name</i>
57<dd style="margin-left: 5.0em"><dt><b>InputSlot </b><i>position </i><b>"</b><i>name</i><b>/</b><i>text</i><b>"</b>
58<dd style="margin-left: 5.0em"><dt><b>Installable </b><i>name</i>
59<dd style="margin-left: 5.0em"><dt><b>Installable "</b><i>name</i><b>/</b><i>text</i><b>"</b>
60<dd style="margin-left: 5.0em"><dt><b>LocAttribute </b><i>name </i><b>"</b><i>keyword</i><b>/</b><i>text</i><b>" </b><i>value</i>
61<dd style="margin-left: 5.0em"><dt><b>ManualCopies </b><i>boolean-value</i>
62<dd style="margin-left: 5.0em"><dt><b>Manufacturer "</b><i>name</i><b>"</b>
63<dd style="margin-left: 5.0em"><dt><b>MaxSize </b><i>width length</i>
64<dd style="margin-left: 5.0em"><dt><b>MediaSize </b><i>name</i>
65<dd style="margin-left: 5.0em"><dt><b>MediaType </b><i>type name</i>
66<dd style="margin-left: 5.0em"><dt><b>MediaType </b><i>type </i><b>"</b><i>name</i><b>/</b><i>text</i><b>"</b>
67<dd style="margin-left: 5.0em"><dt><b>MinSize </b><i>width length</i>
68<dd style="margin-left: 5.0em"><dt><b>ModelName "</b><i>name</i><b>"</b>
69<dd style="margin-left: 5.0em"><dt><b>ModelNumber </b><i>number</i>
70<dd style="margin-left: 5.0em"><dt><b>Option </b><i>name type section order</i>
71<dd style="margin-left: 5.0em"><dt><b>Option "</b><i>name</i><b>/</b><i>text</i><b>" </b><i>type section order</i>
72<dd style="margin-left: 5.0em"><dt><b>PCFileName "</b><i>filename.ppd</i><b>"</b>
73<dd style="margin-left: 5.0em"><dt><b>Resolution </b><i>colorspace bits-per-color row-count row-feed row-step name</i>
74<dd style="margin-left: 5.0em"><dt><b>Resolution </b><i>colorspace bits-per-color row-count row-feed row-step </i><b>"</b><i>name</i><b>/</b><i>text</i><b>"</b>
75<dd style="margin-left: 5.0em"><dt><b>SimpleColorProfile </b><i>resolution</i><b>/</b><i>mediatype density yellow-density red-density gamma red-adjust green-adjust blue-adjust</i>
76<dd style="margin-left: 5.0em"><dt><b>Throughput </b><i>pages-per-minute</i>
77<dd style="margin-left: 5.0em"><dt><b>UIConstraints "</b><i>*Option1 *Option2</i><b>"</b>
78<dd style="margin-left: 5.0em"><dt><b>UIConstraints "</b><i>*Option1 Choice1 *Option2</i><b>"</b>
79<dd style="margin-left: 5.0em"><dt><b>UIConstraints "</b><i>*Option1 *Option2 Choice2</i><b>"</b>
80<dd style="margin-left: 5.0em"><dt><b>UIConstraints "</b><i>*Option1 Choice1 *Option2 Choice2</i><b>"</b>
81<dd style="margin-left: 5.0em"><dt><b>VariablePaperSize </b><i>boolean-value</i>
82<dd style="margin-left: 5.0em"><dt><b>Version </b><i>number</i>
83<dd style="margin-left: 5.0em"></dl>
84<h2 class="title"><a name="NOTES">Notes</a></h2>
85PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
86Printers that do not support IPP can be supported using applications such as
87<b>ippeveprinter</b>(1).
88<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
89<b>ppdc</b>(1),
90<b>ppdhtml</b>(1),
91<b>ppdi</b>(1),
92<b>ppdmerge</b>(1),
93<b>ppdpo</b>(1),
94CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
95<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
96Copyright &copy; 2007-2019 by Apple Inc.
97
98</body>
99</html>
100