]> git.ipfire.org Git - thirdparty/cups.git/commitdiff
Save work on new command-line administration help file.
authorMichael R Sweet <michaelrsweet@gmail.com>
Wed, 6 Dec 2017 01:00:35 +0000 (20:00 -0500)
committerMichael R Sweet <michaelrsweet@gmail.com>
Wed, 6 Dec 2017 01:00:35 +0000 (20:00 -0500)
doc/cups-printable.css
doc/cups.css
doc/help/admin.html [new file with mode: 0644]

index 262e625f4d8e2f43e4501bef798e5e070caa618e..ec08fbc3263a7db68795fa41f996a4efc104a9bf 100644 (file)
@@ -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 {
index da6ac1594e8d5b3886cfd0b2b5ea8d0ae452993c..46fac54cc790a8a9081c29a86b64da0e7df48c42 100644 (file)
@@ -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 (file)
index 0000000..b234eb4
--- /dev/null
@@ -0,0 +1,67 @@
+<!DOCTYPE html>
+<html>
+  <!-- SECTION: Getting Started -->
+  <head>
+    <title>Command-Line Printer Administration</title>
+    <link rel="stylesheet" type="text/css" href="../cups-printable.css">
+  </head>
+  <body>
+    <h1 class="title">Command-Line Printer Administration</h1>
+
+    <p>This help document describes how to configure and manage printers with CUPS.</p>
+
+    <h2 class="title"><a name="INTRO">Introduction</a></h2>
+
+    <p>CUPS currently uses PPD (PostScript Printer Description) files that describe printer capabilities and driver programs needed for each printer.  The <code>everywhere</code> 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:
+
+    <pre class="command">lpadmin -p printername -E -v ipp://11.22.33.44/ipp/print -m everywhere</pre>
+
+    <p>CUPS also includes several sample PPD files you can use for "legacy" printers:</p>
+
+    <div class="table"><table>
+      <thead>
+        <tr><th>Driver</th><th>PPD Name</th></tr>
+      </thead>
+      <tbody>
+        <tr><td>Dymo Label Printers</td><td>drv:///sample.drv/dymo.ppd</td></tr>
+        <tr><td>Intellitech Intellibar</td><td>drv:///sample.drv/intelbar.ppd</td></tr>
+        <tr><td>EPSON 9-pin Series</td><td>drv:///sample.drv/epson9.ppd</td></tr>
+        <tr><td>EPSON 24-pin Series</td><td>drv:///sample.drv/epson24.ppd</td></tr>
+        <tr><td>Generic PCL Laser Printer</td><td>drv:///sample.drv/generpcl.ppd</td></tr>
+        <tr><td>Generic PostScript Printer</td><td>drv:///sample.drv/generic.ppd</td></tr>
+        <tr><td>HP DeskJet Series</td><td>drv:///sample.drv/deskjet.ppd</td></tr>
+        <tr><td>HP LaserJet Series</td><td>drv:///sample.drv/laserjet.ppd</td></tr>
+        <tr><td>OKIDATA 9-Pin Series</td><td>drv:///sample.drv/okidata9.ppd</td></tr>
+        <tr><td>OKIDATA 24-Pin Series</td><td>drv:///sample.drv/okidat24.ppd</td></tr>
+        <tr><td>Zebra CPCL Label Printer</td><td>drv:///sample.drv/zebracpl.ppd</td></tr>
+        <tr><td>Zebra EPL1 Label Printer</td><td>drv:///sample.drv/zebraep1.ppd</td></tr>
+        <tr><td>Zebra EPL2 Label Printer</td><td>drv:///sample.drv/zebraep2.ppd</td></tr>
+        <tr><td>Zebra ZPL Label Printer</td><td>drv:///sample.drv/zebra.ppd</td></tr>
+      </tbody>
+    </table></div>
+
+    <p>You can run the <code>lpinfo -m</code> command to list all of the available drivers:</p>
+
+    <pre class="command">lpinfo -m</pre>
+
+    <p>Run the <code>lpinfo -v</code> command to list the available printers:</p>
+
+    <pre class="command">lpinfo -v</pre>
+
+    <p>Then use the correct URI to add the printer using the <code>lpadmin</code> command:</p>
+
+    <pre class="command">lpadmin -p printername -E -v device-uri -m ppd-name</pre>
+
+    <p>Current network printers typically use <code>ipp</code> or <code>ipps</code> URIS:</p>
+
+    <pre class="command">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</pre>
+
+    <p>Older network printers typically use <code>socket</code> or <code>lpd</code> URIs:</p>
+
+    <pre class="command">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</pre>
+
+    <p>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.</p>
+  </body>
+</html>