summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorMichael Sweet <michael.r.sweet@gmail.com>2017-10-12 20:37:36 -0400
committerMichael Sweet <michael.r.sweet@gmail.com>2017-10-12 20:37:36 -0400
commita7cdcd19b8aa6ec2ca8261111a31222ed8046383 (patch)
tree834e1d1c8ceadd48a16f624da7d61e1ce353ee48 /README.md
parent79424d8b9af3276675d2a6045f0fff68c82e9b91 (diff)
downloadcups-a7cdcd19b8aa6ec2ca8261111a31222ed8046383.tar.gz
More updates to the README file.
Diffstat (limited to 'README.md')
-rw-r--r--README.md50
1 files changed, 25 insertions, 25 deletions
diff --git a/README.md b/README.md
index 7db5add9d..772c90279 100644
--- a/README.md
+++ b/README.md
@@ -30,12 +30,10 @@ READING THE DOCUMENTATION
-------------------------
Once you have installed the software you can access the documentation (and a
-bunch of other stuff) online at:
-
- http://localhost:631/
+bunch of other stuff) online at <http://localhost:631/>.
If you're having trouble getting that far, the documentation is located under
-the `doc/help` directory.
+the `doc/help` and `man` directories.
Please read the documentation before asking questions.
@@ -43,10 +41,8 @@ Please read the documentation before asking questions.
GETTING SUPPORT AND OTHER RESOURCES
-----------------------------------
-If you have problems, **read the documentation first!** We also provide two mailing
-lists which are available at:
-
- https://lists.cups.org/mailman/listinfo
+If you have problems, *read the documentation first!* We also provide two
+mailing lists which are available at <https://lists.cups.org/mailman/listinfo>.
See the CUPS web site at <https://www.cups.org/> for other resources.
@@ -55,27 +51,30 @@ SETTING UP PRINTER QUEUES USING YOUR WEB BROWSER
------------------------------------------------
CUPS includes a web-based administration tool that allows you to manage
-printers, classes, and jobs on your server. Open the following URL in your
-browser to access the printer administration tools:
-
- http://localhost:631/admin/
+printers, classes, and jobs on your server. Open <http://localhost:631/admin/>
+in your browser to access the printer administration tools:
*Do not* use the hostname for your machine - it will not work with the default
CUPS configuration. To enable administration access on other addresses, check
the `Allow Remote Administration` box and click on the `Change Settings button.
You will be asked for the administration password (root or any other user in the
-`sys/system/root/admin/lpadmin` group on your system) when performing any
+sys/system/root/admin/lpadmin group on your system) when performing any
administrative function.
SETTING UP PRINTER QUEUES FROM THE COMMAND-LINE
-----------------------------------------------
-CUPS works best with PPD (PostScript Printer Description) files. In a pinch you
-can also use System V style printer interface scripts.
+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:
-CUPS includes several sample PPD files you can use:
+ 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:
Driver PPD Name
----------------------------- ------------------------------
@@ -94,7 +93,7 @@ CUPS includes several sample PPD files you can use:
Zebra EPL2 Label Printer drv:///sample.drv/zebraep2.ppd
Zebra ZPL Label Printer drv:///sample.drv/zebra.ppd
-Run the `lpinfo -m` command to list the available drivers:
+You can run the `lpinfo -m` command to list all of the available drivers:
lpinfo -m
@@ -106,18 +105,19 @@ Then use the correct URI to add the printer using the `lpadmin` command:
lpadmin -p printername -E -v device-uri -m ppd-name
-Network printers typically use `socket` or `lpd` URIs:
+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.
-
-CUPS also supports IPP Everywhere printers using the "everywhere" model, for
-example:
-
- lpadmin -p printername -E -v ipp://11.22.33.44/ipp/print -m everywhere
+exercise the full potential of the printers or CUPS. Other drivers provide
+greater printing capabilities.
PRINTING FILES
@@ -157,4 +157,4 @@ CUPS is provided under the terms of version 2 of the GNU General Public License
and GNU Library General Public License. This program is distributed in the hope
that it will be useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-"doc/help/license.html" or "LICENSE.txt" files for more information.
+`doc/help/license.html` or `LICENSE.txt` files for more information.