]> git.ipfire.org Git - thirdparty/cups.git/blobdiff - doc/help/man-printers.conf.html
Greatly simplify the man page handling.
[thirdparty/cups.git] / doc / help / man-printers.conf.html
index 7127c6a32b8663740228b5573c9b621f90834ffb..4a3123ea56b834917ed88383315a4ff09bd710b2 100644 (file)
 <h2 class="title"><a name="NAME">Name</a></h2>
 printers.conf - printer configuration file for cups
 <h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The <i>printers.conf</i> file defines the local printers that are
-available. It is normally located in the <i>/etc/cups</i> directory and
-is generated automatically by the <i>cupsd(8)</i> program when printers
-are added or deleted.
-<p>Each line in the file can be a configuration directive, a blank line,
-or a comment. Comment lines start with the # character.
-<h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
-<p style="margin-left: 5.0em; text-indent: -5.0em">&lt;Printer name> ... &lt;/Printer>
-<br>
-<br>
-Defines a specific printer.
-<p style="margin-left: 5.0em; text-indent: -5.0em">&lt;DefaultPrinter name> ... &lt;/Printer>
-<br>
-<br>
-Defines a default printer.
-<p style="margin-left: 5.0em; text-indent: -5.0em">Accepting Yes
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em">Accepting No
-<br>
-<br>
-Specifies whether the printer is accepting new jobs.
-<p style="margin-left: 5.0em; text-indent: -5.0em">AllowUser [ user @group ... ]
-<br>
-<br>
-Allows specific users and groups to print to the printer.
-<p style="margin-left: 5.0em; text-indent: -5.0em">DenyUser [ user @group ... ]
-<br>
-<br>
-Prevents specific users and groups from printing to the printer.
-<p style="margin-left: 5.0em; text-indent: -5.0em">DeviceURI uri
-<br>
-<br>
-Specifies the device URI for a printer.
-<p style="margin-left: 5.0em; text-indent: -5.0em">ErrorPolicy abort-job
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em">ErrorPolicy retry-current-job
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em">ErrorPolicy retry-job
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em">ErrorPolicy stop-printer
-<br>
-<br>
-Specifies the error policy for the printer.
-<p style="margin-left: 5.0em; text-indent: -5.0em">Info text
-<br>
-<br>
-Specifies human-readable text describing the printer.
-<p style="margin-left: 5.0em; text-indent: -5.0em">JobSheets banner banner
-<br>
-<br>
-Specifies the banner pages to use for the printer.
-<p style="margin-left: 5.0em; text-indent: -5.0em">KLimit number
-<br>
-<br>
-Specifies the job-k-limit value for the printer.
-<p style="margin-left: 5.0em; text-indent: -5.0em">Location text
-<br>
-<br>
-Specifies human-readable text describing the location of the printer.
-<p style="margin-left: 5.0em; text-indent: -5.0em">OpPolicy name
-<br>
-<br>
-Specifies the operation policy for the printer.
-<p style="margin-left: 5.0em; text-indent: -5.0em">PageLimit number
-<br>
-<br>
-Specifies the job-page-limit value for the printer.
-<p style="margin-left: 5.0em; text-indent: -5.0em">PortMonitor monitor
-<br>
-<br>
-Specifies the port monitor for a printer.
-<p style="margin-left: 5.0em; text-indent: -5.0em">QuotaPeriod seconds
-<br>
-<br>
-Specifies the job-quota-period value for the printer.
-<p style="margin-left: 5.0em; text-indent: -5.0em">Shared Yes
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em">Shared No
-<br>
-<br>
-Specifies whether the printer is shared.
-<p style="margin-left: 5.0em; text-indent: -5.0em">State idle
-<br>
-<p style="margin-left: 5.0em; text-indent: -5.0em">State stopped
-<br>
-<br>
-Specifies the initial state of the printer (Idle or Stopped)
-<p style="margin-left: 5.0em; text-indent: -5.0em">StateMessage text
-<br>
-<br>
-Specifies the message associated with the state.
-<p style="margin-left: 5.0em; text-indent: -5.0em">StateTime seconds
-<br>
-<br>
-Specifies the date/time associated with the state.
+The <b>printers.conf</b> file defines the local printers that are available. It is normally located in the <i>/etc/cups</i> directory and is maintained by the
+<b>cupsd</b>(8)
+program. This file is not intended to be edited or managed manually.
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.
 <h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<i>classes.conf(5)</i>, <i>cupsd(8)</i>, <i>cupsd.conf(5)</i>,
-<i>mime.convs(5)</i>, <i>mime.types(5)</i>,
-<br>
-<a href="http://localhost:631/help">http://localhost:631/help</a>
+<b>classes.conf</b>(5),
+<b>cups-files.conf</b>(5),
+<b>cupsd</b>(8),
+<b>cupsd.conf</b>(5),
+<b>mime.convs</b>(5),
+<b>mime.types</b>(5),
+<b>subscriptions.conf</b>(5),
+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>