Merge changes from CUPS 1.4svn-r8628.

[thirdparty/cups.git] / man / backend.man

diff --git a/man/backend.man b/man/backend.man
index 796a46f56fc5ba8bf12d5251eb797c4ebecab239..e62f94e22ff6863188bed8acf98037c06dd4a743 100644 (file)
--- a/man/backend.man
+++ b/man/backend.man
@@ -1,27 +1,18 @@
 .\"
-.\" "$Id: backend.man 5313 2006-03-20 15:29:09Z mike $"
+.\" "$Id: backend.man 7810 2008-07-29 01:11:15Z mike $"
 .\"
 .\"   Backend man page for the Common UNIX Printing System (CUPS).
 .\"
+.\"   Copyright 2007-2009 by Apple Inc.
 .\"   Copyright 1997-2006 by Easy Software Products.
 .\"
 .\"   These coded instructions, statements, and computer programs are the
-.\"   property of Easy Software Products and are protected by Federal
-.\"   copyright law.  Distribution and use rights are outlined in the file
-.\"   "LICENSE.txt" which should have been included with this file.  If this
-.\"   file is missing or damaged please contact Easy Software Products
-.\"   at:
+.\"   property of Apple Inc. and are protected by Federal copyright
+.\"   law.  Distribution and use rights are outlined in the file "LICENSE.txt"
+.\"   which should have been included with this file.  If this file is
+.\"   file is missing or damaged, see the license at "http://www.cups.org/".
 .\"
-.\"       Attn: CUPS Licensing Information
-.\"       Easy Software Products
-.\"       44141 Airport View Drive, Suite 204
-.\"       Hollywood, Maryland 20636 USA
-.\"
-.\"       Voice: (301) 373-9600
-.\"       EMail: cups-info@cups.org
-.\"         WWW: http://www.cups.org
-.\"
-.TH backend 7 "Common UNIX Printing System" "20 March 2006" "Easy Software Products"
+.TH backend 7 "CUPS" "12 May 2009" "Apple Inc."
 
 .SH NAME
 backend \- cups backend transmission interfaces
@@ -45,13 +36,11 @@ standard input to a temporary file as required by the physical
 interface.
 
 .LP
-The command name (argv[0]) is set to the device URI of the
-destination printer. Starting with CUPS 1.1.22, any
-authentication information in argv[0] is removed, so
-backend developers are urged to use the DEVICE_URI environment
-variable whenever authentication information is required. The
-CUPS API includes a \fIcupsBackendDeviceURI\fR function for
-retrieving the correct device URI.
+The command name (argv[0]) is set to the device URI of the destination printer.
+Starting with CUPS 1.1.22, any authentication information in argv[0] is removed,
+so backend developers are urged to use the DEVICE_URI environment variable
+whenever authentication information is required. The CUPS API includes a
+\fIcupsBackendDeviceURI\fR function for retrieving the correct device URI.
 
 .LP
 Back-channel data from the device should be relayed to the job
@@ -68,6 +57,7 @@ forms:
     device-class scheme "Unknown" "device-info"
     device-class device-uri "device-make-and-model" "device-info"
     device-class device-uri "device-make-and-model" "device-info" "device-id"
+    device-class device-uri "device-make-and-model" "device-info" "device-id" "device-location"
 .fi
 
 .LP
@@ -120,6 +110,11 @@ The optional \fIdevice-id\fR field specifies the IEEE-1284 device
 ID string for the device, which is used to select a matching
 driver.
 
+.LP
+The optional \fIdevice-location\fR field specifies the physical location of
+the device, which is often used to pre-populate the printer-location attribute
+when adding a printer.
+
 .SH PERMISSIONS
 Backends without world execute permissions are run as the root
 user. Otherwise, the backend is run using the unprivileged user
@@ -177,12 +172,12 @@ this by canceling the job.
 All other exit code values are reserved.
 
 .SH SEE ALSO
-\fIcupsd(8)\fR, \fIcupsd.conf(5)\fR, \fIfilter(7)\fR
+\fIcupsd(8)\fR, \fIcupsd.conf(5)\fR, \fIfilter(7)\fR,
 .br
 http://localhost:631/help
 
 .SH COPYRIGHT
-Copyright 1997-2006 by Easy Software Products, All Rights Reserved.
+Copyright 2007-2009 by Apple Inc.
 .\"
-.\" End of "$Id: backend.man 5313 2006-03-20 15:29:09Z mike $".
+.\" End of "$Id: backend.man 7810 2008-07-29 01:11:15Z mike $".
 .\"