From: Michael R Sweet Date: Wed, 6 Dec 2017 01:00:35 +0000 (-0500) Subject: Save work on new command-line administration help file. X-Git-Tag: v2.3b1~36 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=fce9ddcbeed910e86c0381d696a6dc387b65ac71;p=thirdparty%2Fcups.git Save work on new command-line administration help file. --- diff --git a/doc/cups-printable.css b/doc/cups-printable.css index 262e625f4d..ec08fbc326 100644 --- a/doc/cups-printable.css +++ b/doc/cups-printable.css @@ -15,9 +15,14 @@ PRE { font-family: monaco, courier, monospace; } -PRE.command { - border: dotted thin #7f7f7f; - margin-left: 36pt; +BLOCKQUOTE { + border-left: solid 2px #777; + padding: 10px; +} + +PRE.command, PRE.example { + background: #eee; + margin: 0 36pt; padding: 10px; } @@ -42,13 +47,6 @@ PRE.man { margin: 0; } -PRE.example { - background: #eeeeee; - border: dotted thin #999999; - margin-left: 36pt; - padding: 10pt; -} - PRE.command EM, PRE.example EM { font-family: lucida grande, geneva, helvetica, arial, sans-serif; } @@ -124,7 +122,7 @@ DIV.table CAPTION { DIV.table TABLE TD { border: solid thin #cccccc; - padding-top: 5pt; + padding: 5pt 10pt 0; } DIV.table TABLE TH { diff --git a/doc/cups.css b/doc/cups.css index da6ac1594e..46fac54cc7 100644 --- a/doc/cups.css +++ b/doc/cups.css @@ -120,11 +120,14 @@ PRE { font-family: monaco, courier, monospace; } -PRE.command { - background: #f0f0f0; - border: dotted thin #7f7f7f; - color: #7f0000; - margin-left: 36pt; +BLOCKQUOTE { + border-left: solid 2px #777; + padding: 10px; +} + +PRE.command, PRE.example { + background: #eee; + margin: 0 36pt; padding: 10px; } @@ -145,13 +148,6 @@ PRE.man { margin: 0; } -PRE.example { - background: white; - border: dotted thin #999999; - margin-left: 36pt; - padding: 10px; -} - PRE.command EM, PRE.example EM { color: #3f0000; font-family: lucida grande, geneva, helvetica, arial, sans-serif; @@ -300,7 +296,7 @@ DIV.table CAPTION { DIV.table TABLE TD { background: white; border: solid thin #bbbbbb; - padding-top: 5pt; + padding: 5pt 10pt 0; } DIV.table TABLE TH { diff --git a/doc/help/admin.html b/doc/help/admin.html new file mode 100644 index 0000000000..b234eb4191 --- /dev/null +++ b/doc/help/admin.html @@ -0,0 +1,67 @@ + + + + + Command-Line Printer Administration + + + +

Command-Line Printer Administration

+ +

This help document describes how to configure and manage printers with CUPS.

+ +

Introduction

+ +

CUPS currently uses PPD (PostScript Printer Description) files that describe printer capabilities and driver programs needed for each printer. The everywhere PPD is used for nearly all modern networks printers sold since about 2009. For example, the following command creates a print queue for a printer at address 11.22.33.44: + + 

lpadmin -p printername -E -v ipp://11.22.33.44/ipp/print -m everywhere
+ +

CUPS also includes several sample PPD files you can use for "legacy" printers:

+ +
+ + + + + + + + + + + + + + + + + + + +
DriverPPD Name
Dymo Label Printersdrv:///sample.drv/dymo.ppd
Intellitech Intellibardrv:///sample.drv/intelbar.ppd
EPSON 9-pin Seriesdrv:///sample.drv/epson9.ppd
EPSON 24-pin Seriesdrv:///sample.drv/epson24.ppd
Generic PCL Laser Printerdrv:///sample.drv/generpcl.ppd
Generic PostScript Printerdrv:///sample.drv/generic.ppd
HP DeskJet Seriesdrv:///sample.drv/deskjet.ppd
HP LaserJet Seriesdrv:///sample.drv/laserjet.ppd
OKIDATA 9-Pin Seriesdrv:///sample.drv/okidata9.ppd
OKIDATA 24-Pin Seriesdrv:///sample.drv/okidat24.ppd
Zebra CPCL Label Printerdrv:///sample.drv/zebracpl.ppd
Zebra EPL1 Label Printerdrv:///sample.drv/zebraep1.ppd
Zebra EPL2 Label Printerdrv:///sample.drv/zebraep2.ppd
Zebra ZPL Label Printerdrv:///sample.drv/zebra.ppd
+ +

You can run the lpinfo -m command to list all of the available drivers:

+ + 
lpinfo -m
+ +

Run the lpinfo -v command to list the available printers:

+ + 
lpinfo -v
+ +

Then use the correct URI to add the printer using the lpadmin command:

+ + 
lpadmin -p printername -E -v device-uri -m ppd-name
+ +

Current network printers typically use ipp or ipps URIS:

+ + 
lpadmin -p printername -E -v ipp://11.22.33.44/ipp/print -m everywhere
+lpadmin -p printername -E -v ipps://11.22.33.44/ipp/print -m everywhere
+ +

Older network printers typically use socket or lpd URIs:

+ + 
lpadmin -p printername -E -v socket://11.22.33.44 -m ppd-name
+lpadmin -p printername -E -v lpd://11.22.33.44/ -m ppd-name
+ +

The sample drivers provide basic printing capabilities, but generally do not exercise the full potential of the printers or CUPS. Other drivers provide greater printing capabilities.

+ +