]> git.ipfire.org Git - thirdparty/cups.git/blobdiff - doc/help/man-ppdcfile.html
Update ipp documentation to reflect the behavior of configuring WiFi on IPP USB printers.
[thirdparty/cups.git] / doc / help / man-ppdcfile.html
index b0382278b578bf1b97d66234ddf0995f6c2ca11f..a81f06a8d14ff338acf53a8f32a94352b06bdab4 100644 (file)
 <body>
 <h1 class="title">ppdcfile(5)</h1>
 <h2 class="title"><a name="NAME">Name</a></h2>
-ppdcfile - cups ppd compiler source file format
+ppdcfile - cups ppd compiler source file format (deprecated)
 <h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The CUPS PPD compiler reads meta files that contain descriptions
-of one or more PPD files to be generated by <i>ppdc</i>. This man
-page provides a quick reference to the supported keywords and
-should be used in conjunction with the online help for CUPS.
-<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.
-<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.
-<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:
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#define</b> name value
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#elif</b> {name | value}
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#else</b>
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#endif</b>
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#font</b> name encoding "version" charset status
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#if</b> {name | value}
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#include</b> &lt;filename>
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#include</b> "filename"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#media</b> name width length
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#media</b> "name/text" width length
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>#po</b> locale "filename.po"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Attribute</b> name "" value
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Attribute</b> name keyword value
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Attribute</b> name "keyword/text" value
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Choice</b> name "code"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Choice</b> "name/text" "code"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>ColorDevice</b> boolean-value
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>ColorModel</b> name colorspace colororder compression
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>ColorModel</b> "name/text" colorspace colororder compression
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>ColorProfile</b> resolution/mediatype gamma density matrix
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Copyright</b> "text"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>CustomMedia</b> name width length left bottom right top "size-code" "region-code"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>CustomMedia</b> "name/text" width length left bottom right top "size-code" "region-code"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Cutter</b> boolean-value
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Darkness</b> temperature name
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Darkness</b> temperature "name/text"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>DriverType</b> type
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Duplex</b> type
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Filter</b> mime-type cost program
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Finishing</b> name
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Finishing</b> "name/text"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Font</b> *
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Font</b> name encoding "version" charset status
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Group</b> name
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Group</b> "name/text"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>HWMargins</b> left bottom right top
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>InputSlot</b> position name
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>InputSlot</b> position "name/text"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Installable</b> name
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Installable</b> "name/text"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>LocAttribute</b> name "keyword/text" value
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>ManualCopies</b> boolean-value
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Manufacturer</b> "name"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>MaxSize</b> width length
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>MediaSize</b> name
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>MediaType</b> type name
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>MediaType</b> type "name/text"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>MinSize</b> width length
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>ModelName</b> "name"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>ModelNumber</b> number
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Option</b> name type section order
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Option</b> "name/text" type section order
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>PCFileName</b> "filename.ppd"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Resolution</b> colorspace bits-per-color row-count row-feed row-step name
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Resolution</b> colorspace bits-per-color row-count row-feed row-step "name/text"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>SimpleColorProfile</b> resolution/mediatype density yellow-density red-density gamma red-adjust green-adjust blue-adjust
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Throughput</b> pages-per-minute
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>UIConstraints</b> "*Option1 *Option2"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>UIConstraints</b> "*Option1 Choice1 *Option2"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>UIConstraints</b> "*Option1 *Option2 Choice2"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>UIConstraints</b> "*Option1 Choice1 *Option2 Choice2"
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>VariablePaperSize</b> boolean-value
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em"><b>Version</b> number
-<br>
+The CUPS PPD compiler reads meta files that contain descriptions of one or more PPD files to be generated by
+<b>ppdc</b>(1).
+This man page provides a quick reference to the supported keywords and should be used in conjunction with the online help for CUPS.
+<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.
+<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.
+<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:
+<dl class="man">
+<dt><b>#define </b><i>name value</i>
+<dd style="margin-left: 5.0em"><dt><b>#elif </b>{<i>name </i>| <i>value</i>}
+<dd style="margin-left: 5.0em"><dt><b>#else</b>
+<dd style="margin-left: 5.0em"><dt><b>#endif</b>
+<dd style="margin-left: 5.0em"><dt><b>#font </b><i>name encoding "version" charset status</i>
+<dd style="margin-left: 5.0em"><dt><b>#if </b>{<i>name </i>| <i>value</i>}
+<dd style="margin-left: 5.0em"><dt><b>#include &lt;</b><i>filename</i><b>></b>
+<dd style="margin-left: 5.0em"><dt><b>#include "</b><i>filename</i><b>"</b>
+<dd style="margin-left: 5.0em"><dt><b>#media </b><i>name width length</i>
+<dd style="margin-left: 5.0em"><dt><b>#media "</b><i>name</i><b>/</b><i>text</i><b>" </b><i>width length</i>
+<dd style="margin-left: 5.0em"><dt><b>#po </b><i>locale </i><b>"</b><i>filename</i><b>"</b>
+<dd style="margin-left: 5.0em"><dt><b>Attribute </b><i>name </i><b>"" </b><i>value</i>
+<dd style="margin-left: 5.0em"><dt><b>Attribute </b><i>name keyword value</i>
+<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>
+<dd style="margin-left: 5.0em"><dt><b>Choice </b><i>name </i><b>"</b><i>code</i><b>"</b>
+<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>
+<dd style="margin-left: 5.0em"><dt><b>ColorDevice </b><i>boolean-value</i>
+<dd style="margin-left: 5.0em"><dt><b>ColorModel </b><i>name colorspace colororder compression</i>
+<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>
+<dd style="margin-left: 5.0em"><dt><b>ColorProfile </b><i>resolution</i><b>/</b><i>mediatype gamma density matrix</i>
+<dd style="margin-left: 5.0em"><dt><b>Copyright "</b><i>text</i>"
+<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>
+<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>
+<dd style="margin-left: 5.0em"><dt><b>Cutter </b><i>boolean-value</i>
+<dd style="margin-left: 5.0em"><dt><b>Darkness </b><i>temperature name</i>
+<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>
+<dd style="margin-left: 5.0em"><dt><b>DriverType </b><i>type</i>
+<dd style="margin-left: 5.0em"><dt><b>Duplex </b><i>type</i>
+<dd style="margin-left: 5.0em"><dt><b>Filter </b><i>mime-type cost program</i>
+<dd style="margin-left: 5.0em"><dt><b>Finishing </b><i>name</i>
+<dd style="margin-left: 5.0em"><dt><b>Finishing "</b><i>name</i><b>/</b><i>text</i><b>"</b>
+<dd style="margin-left: 5.0em"><dt><b>Font *</b>
+<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>
+<dd style="margin-left: 5.0em"><dt><b>Group </b><i>name</i>
+<dd style="margin-left: 5.0em"><dt><b>Group "</b><i>name</i><b>/</b><i>text</i><b>"</b>
+<dd style="margin-left: 5.0em"><dt><b>HWMargins </b><i>left bottom right top</i>
+<dd style="margin-left: 5.0em"><dt><b>InputSlot </b><i>position name</i>
+<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>
+<dd style="margin-left: 5.0em"><dt><b>Installable </b><i>name</i>
+<dd style="margin-left: 5.0em"><dt><b>Installable "</b><i>name</i><b>/</b><i>text</i><b>"</b>
+<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>
+<dd style="margin-left: 5.0em"><dt><b>ManualCopies </b><i>boolean-value</i>
+<dd style="margin-left: 5.0em"><dt><b>Manufacturer "</b><i>name</i><b>"</b>
+<dd style="margin-left: 5.0em"><dt><b>MaxSize </b><i>width length</i>
+<dd style="margin-left: 5.0em"><dt><b>MediaSize </b><i>name</i>
+<dd style="margin-left: 5.0em"><dt><b>MediaType </b><i>type name</i>
+<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>
+<dd style="margin-left: 5.0em"><dt><b>MinSize </b><i>width length</i>
+<dd style="margin-left: 5.0em"><dt><b>ModelName "</b><i>name</i><b>"</b>
+<dd style="margin-left: 5.0em"><dt><b>ModelNumber </b><i>number</i>
+<dd style="margin-left: 5.0em"><dt><b>Option </b><i>name type section order</i>
+<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>
+<dd style="margin-left: 5.0em"><dt><b>PCFileName "</b><i>filename.ppd</i><b>"</b>
+<dd style="margin-left: 5.0em"><dt><b>Resolution </b><i>colorspace bits-per-color row-count row-feed row-step name</i>
+<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>
+<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>
+<dd style="margin-left: 5.0em"><dt><b>Throughput </b><i>pages-per-minute</i>
+<dd style="margin-left: 5.0em"><dt><b>UIConstraints "</b><i>*Option1 *Option2</i><b>"</b>
+<dd style="margin-left: 5.0em"><dt><b>UIConstraints "</b><i>*Option1 Choice1 *Option2</i><b>"</b>
+<dd style="margin-left: 5.0em"><dt><b>UIConstraints "</b><i>*Option1 *Option2 Choice2</i><b>"</b>
+<dd style="margin-left: 5.0em"><dt><b>UIConstraints "</b><i>*Option1 Choice1 *Option2 Choice2</i><b>"</b>
+<dd style="margin-left: 5.0em"><dt><b>VariablePaperSize </b><i>boolean-value</i>
+<dd style="margin-left: 5.0em"><dt><b>Version </b><i>number</i>
+<dd style="margin-left: 5.0em"></dl>
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+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
+<b>ippeveprinter</b>(1).
 <h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-ppdc(1), ppdhtml(1), ppdi(1), ppdmerge(1), ppdpo(1)
-<br>
-<a href="http://localhost:631/help">http://localhost:631/help</a>
+<b>ppdc</b>(1),
+<b>ppdhtml</b>(1),
+<b>ppdi</b>(1),
+<b>ppdmerge</b>(1),
+<b>ppdpo</b>(1),
+CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
 <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright 2007-2013 by Apple Inc.
+Copyright &copy; 2007-2019 by Apple Inc.
 
 </body>
 </html>