.\"
-.\" "$Id: lpr.man 4493 2005-02-18 02:09:53Z mike $"
+.\" "$Id: lpr.man 6649 2007-07-11 21:46:42Z mike $"
.\"
.\" lpr man page for the Common UNIX Printing System (CUPS).
.\"
-.\" Copyright 1997-2005 by Easy Software Products.
+.\" Copyright 2007 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 lpr 1 "Common UNIX Printing System" "16 December 2004" "Easy Software Products"
+.TH lpr 1 "Common UNIX Printing System" "12 February 2006" "Apple Inc."
.SH NAME
lpr \- print files
.SH SYNOPSIS
.B lpr
-[ -E ] [ \-P
-.I destination
-] [ \-U
+[ -E ] [ -H
+.I server[:port]
+] [ -U
.I username
-] [ \-#
+] [ -P
+.I destination[/instance]
+] [ -#
.I num-copies
-[ \-l ] [ \-o
-.I option
-] [ \-p] [ \-r ] [ \-C/J/T
+[ -h ] [ -l ] [ -m ] [ -o
+.I option[=value]
+] [ -p] [ -q ] [ -r ] [ -C/J/T
.I title
] [
.I file(s)
]
.SH DESCRIPTION
-\fBlpr\fR submits files for printing. Files named on the command line are sent
-to the named printer (or the system default destination if no destination is
-specified). If no files are listed on the command-line \fBlpr\fR reads the
-print file from the standard input.
+\fIlpr\fR submits files for printing. Files named on the command
+line are sent to the named printer (or the system default
+destination if no destination is specified). If no files are
+listed on the command-line, \fIlpr\fR reads the print file from
+the standard input.
.SH OPTIONS
-The following options are recognized by \fBlpr\fR:
+The following options are recognized by \fIlpr\fR:
.TP 5
-\-E
+-E
.br
Forces encryption when connecting to the server.
.TP 5
-\-P \fIdestination\fR
+-H server[:port]
.br
-Prints files to the named printer.
+Specifies an alternate server.
.TP 5
-\-# \fIcopies\fR
-.br
-Sets the number of copies to print from 1 to 100.
+-C "name"
.TP 5
-\-C \fIname\fR
+-J "name"
+.TP 5
+-T "name"
.br
Sets the job name.
.TP 5
-\-J \fIname\fR
+-P destination[/instance]
.br
-Sets the job name.
+Prints files to the named printer.
.TP 5
-\-T \fIname\fR
+-U username
.br
-Sets the job name.
+Specifies an alternate username.
.TP 5
-\-U \fIusername\fR
+-# \fIcopies\fR
.br
-Sets the user name.
+Sets the number of copies to print from 1 to 100.
+.TP 5
+-h
+.br
+Disables banner printing. This option is equivalent to "-o
+job-sheets=none".
+.TP 5
+-l
+.br
+Specifies that the print file is already formatted for the
+destination and should be sent without filtering. This option is
+equivalent to "-o raw".
.TP 5
-\-l
+-m
.br
-Specifies that the print file is already formatted for the destination and
-should be sent without filtering. This option is equivalent to "-oraw".
+Send an email on job completion.
.TP 5
-\-o \fIoption\fR
+-o option[=value]
.br
Sets a job option.
.TP 5
-\-p
+-p
+.br
+Specifies that the print file should be formatted with a shaded
+header with the date, time, job name, and page number. This
+option is equivalent to "-o prettyprint" and is only useful when
+printing text files.
+.TP 5
+-q
.br
-Specifies that the print file should be formatted with a shaded header with
-the date, time, job name, and page number. This option is equivalent to
-"-oprettyprint" and is only useful when printing text files.
+Hold job for printing.
.TP 5
-\-r
+-r
.br
-Specifies that the named print files should be deleted after printing them.
+Specifies that the named print files should be deleted after
+printing them.
.SH COMPATIBILITY
-The "c", "d", "f", "g", "i", "m", "n", "t", "v", and "w" options are not
-supported by CUPS and will produce a warning message if used.
+The "c", "d", "f", "g", "i", "n", "t", "v", and "w" options
+are not supported by CUPS and produce a warning message if used.
.SH SEE ALSO
-cancel(1), lp(1), lpstat(1),
-CUPS Software Users Manual,
-http://localhost:631/documentation.html
+\fIcancel(1)\fR, \fIlp(1)\fR, \fIlpq(1)\fR, \fIlprm(1)\fR,
+\fIlpstat(1)\fR,
+.br
+http://localhost:631/help
.SH COPYRIGHT
-Copyright 1993-2005 by Easy Software Products, All Rights Reserved.
+Copyright 2007 by Apple Inc.
.\"
-.\" End of "$Id: lpr.man 4493 2005-02-18 02:09:53Z mike $".
+.\" End of "$Id: lpr.man 6649 2007-07-11 21:46:42Z mike $".
.\"