diff options
author | Michael Sweet <michael.r.sweet@gmail.com> | 2016-05-02 18:58:42 -0400 |
---|---|---|
committer | Michael Sweet <michael.r.sweet@gmail.com> | 2016-05-02 18:58:42 -0400 |
commit | 40df01c1b50d15427b26d0ff2a4fb3eff97e999c (patch) | |
tree | 908fd76356bced10b4f5543fb8dc9ee7f712af74 /man | |
parent | 91f7a0f3d93c3246de816b99e464a0c7db22b365 (diff) | |
download | cups-40df01c1b50d15427b26d0ff2a4fb3eff97e999c.tar.gz |
Add common options to lp/lpr man pages (Issue #4794)
Diffstat (limited to 'man')
-rw-r--r-- | man/lp.man | 68 | ||||
-rw-r--r-- | man/lpr.man | 79 |
2 files changed, 134 insertions, 13 deletions
diff --git a/man/lp.man b/man/lp.man index 4892b37cb..03b10e5e2 100644 --- a/man/lp.man +++ b/man/lp.man @@ -1,7 +1,7 @@ .\" .\" lp man page for CUPS. .\" -.\" Copyright 2007-2014 by Apple Inc. +.\" Copyright 2007-2016 by Apple Inc. .\" Copyright 1997-2006 by Easy Software Products. .\" .\" These coded instructions, statements, and computer programs are the @@ -10,7 +10,7 @@ .\" 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/". .\" -.TH lp 1 "CUPS" "11 June 2014" "Apple Inc." +.TH lp 1 "CUPS" "2 May 2016" "Apple Inc." .SH NAME lp \- print files .SH SYNOPSIS @@ -127,6 +127,7 @@ Sets the number of copies to print. .TP 5 \fB\-o "\fIname\fB=\fIvalue \fR[ ... \fIname\fB=\fIvalue \fR]\fB"\fR Sets one or more job options. +See "COMMON JOB OPTIONS" below. .TP 5 \fB\-q \fIpriority\fR Sets the job priority from 1 (lowest) to 100 (highest). @@ -161,11 +162,64 @@ Aside from the printer-specific options reported by the .BR lpoptions (1) command, the following generic options are available: .TP 5 +\fB\-o collate=true\fR +Prints collated copies. +.TP 5 +\fB\-o fit\-to\-page\fR +Scales the print file to fit on the page. +.TP 5 +\fB\-o job-hold-until=\fIwhen\fR +Holds the job until the specified local time. +"when" can be "indefinite" to hold the until released, "day-time" to print the job between 6am and 6pm local time, "night" to print the job between 6pm and 6am local time, "second-shift" to print the job between 4pm and 12am local time, "third-shift" to print the job between 12am and 8am local time, or "weekend" to print the job on Saturday or Sunday. +.TP 5 +\fB\-o job-hold-until=\fIhh:mm\fR +Holds the job until the specified time in hours and minutes UTC. +.TP 5 +\fB\-o job-priority=\fIpriority\fR +Set the priority to a value from 1 (lowest) to 100 (highest), which influences when a job is scheduled for printing. +The default priority is typically 50. +.TP 5 +\fB\-o job-sheets=\fIname\fR\fR +Prints a cover page (banner) with the document. +The "name" can be "classified", "confidential", "secret", "standard", "topsecret", or "unclassified". +.TP 5 +\fB\-o job-sheets=\fIstart-name,end-name\fR\fR +Prints cover pages (banners) with the document. +.TP 5 \fB\-o media=\fIsize\fR Sets the page size to \fIsize\fR. Most printers support at least the size names "a4", "letter", and "legal". .TP 5 +\fB\-o mirror\fR +Mirrors each page. +.TP 5 +\fB\-o number\-up=\fR{\fI2|4|6|9|16\fR} +Prints 2, 4, 6, 9, or 16 document (input) pages on each output page. +.TP 5 +\fB\-o number\-up\-layout=\fIlayout\fR +Specifies the layout of pages with the "number-up" option. +The "layout" string can be "btlr", "btrl", "lrbt", "lrtb", "rlbt", "rltb", "tblr", or "tbrl" - the first two letters determine the column order while the second two letters determine the row order. +"bt" is bottom-to-top, "lr" is left-to-right, "rl" is right-to-left, and "tb" is top-to-bottom. +.TP 5 \fB\-o orientation\-requested=4\fR -Prints the job in landscape (rotated 90 degrees). +Prints the job in landscape (rotated 90 degrees counter-clockwise). +.TP 5 +\fB\-o orientation\-requested=5\fR +Prints the job in landscape (rotated 90 degrees clockwise). +.TP 5 +\fB\-o orientation\-requested=6\fR +Prints the job in reverse portrait (rotated 180 degrees). +.TP 5 +\fB\-o outputorder=reverse\fR +Prints pages in reverse order. +.TP 5 +\fB\-o page\-border=\fIborder\fR +Prints a border around each document page. +"border" is "double", "double\-thick", "single", or "single\-thick". +.TP 5 +\fB\-o page\-ranges=\fIpage-list\fR +Specifies which pages to print in the document. +The list can contain a list of numbers and ranges (#-#) separated by commas, e.g., "1,3-5,16". +The page numbers refer to the output pages and not the document's original pages - options like "number-up" can affect the numbering of the pages. .TP 5 \fB\-o sides=one\-sided\fR Prints on one side of the paper. @@ -175,12 +229,6 @@ Prints on both sides of the paper for portrait output. .TP 5 \fB\-o sides=two\-sided\-short\-edge\fR Prints on both sides of the paper for landscape output. -.TP 5 -\fB\-o fit\-to\-page\fR -Scales the print file to fit on the page. -.TP 5 -\fB\-o number\-up=\fR{\fI2|4|6|9|16\fR} -Prints 2, 4, 6, 9, or 16 document (input) pages on each output page. .SH CONFORMING TO Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", or "#". Also, printer and class names are \fInot\fR case-sensitive. @@ -214,4 +262,4 @@ Print a presentation document 2-up to a printer called "foo": .BR lpstat (1), CUPS Online Help (http://localhost:631/help) .SH COPYRIGHT -Copyright \[co] 2007-2015 by Apple Inc. +Copyright \[co] 2007-2016 by Apple Inc. diff --git a/man/lpr.man b/man/lpr.man index 8faad49ef..553d0592d 100644 --- a/man/lpr.man +++ b/man/lpr.man @@ -1,7 +1,7 @@ .\" .\" lpr man page for CUPS. .\" -.\" Copyright 2007-2013 by Apple Inc. +.\" Copyright 2007-2016 by Apple Inc. .\" Copyright 1997-2006 by Easy Software Products. .\" .\" These coded instructions, statements, and computer programs are the @@ -10,7 +10,7 @@ .\" 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/". .\" -.TH lpr 1 "CUPS" "11 June 2014" "Apple Inc." +.TH lpr 1 "CUPS" "2 May 2016" "Apple Inc." .SH NAME lpr \- print files .SH SYNOPSIS @@ -101,6 +101,7 @@ Send an email on job completion. .TP 5 \fB\-o \fIoption\fR[\fB=\fIvalue\fR] Sets a job option. +See "COMMON JOB OPTIONS" below. .TP 5 .B \-p Specifies that the print file should be formatted with a shaded header with the date, time, job name, and page number. @@ -111,6 +112,78 @@ Hold job for printing. .TP 5 .B \-r Specifies that the named print files should be deleted after submitting them. +.SS COMMON JOB OPTIONS +Aside from the printer-specific options reported by the +.BR lpoptions (1) +command, the following generic options are available: +.TP 5 +\fB\-o collate=true\fR +Prints collated copies. +.TP 5 +\fB\-o fit\-to\-page\fR +Scales the print file to fit on the page. +.TP 5 +\fB\-o job-hold-until=\fIwhen\fR +Holds the job until the specified local time. +"when" can be "indefinite" to hold the until released, "day-time" to print the job between 6am and 6pm local time, "night" to print the job between 6pm and 6am local time, "second-shift" to print the job between 4pm and 12am local time, "third-shift" to print the job between 12am and 8am local time, or "weekend" to print the job on Saturday or Sunday. +.TP 5 +\fB\-o job-hold-until=\fIhh:mm\fR +Holds the job until the specified time in hours and minutes UTC. +.TP 5 +\fB\-o job-priority=\fIpriority\fR +Set the priority to a value from 1 (lowest) to 100 (highest), which influences when a job is scheduled for printing. +The default priority is typically 50. +.TP 5 +\fB\-o job-sheets=\fIname\fR\fR +Prints a cover page (banner) with the document. +The "name" can be "classified", "confidential", "secret", "standard", "topsecret", or "unclassified". +.TP 5 +\fB\-o job-sheets=\fIstart-name,end-name\fR\fR +Prints cover pages (banners) with the document. +.TP 5 +\fB\-o media=\fIsize\fR +Sets the page size to \fIsize\fR. Most printers support at least the size names "a4", "letter", and "legal". +.TP 5 +\fB\-o mirror\fR +Mirrors each page. +.TP 5 +\fB\-o number\-up=\fR{\fI2|4|6|9|16\fR} +Prints 2, 4, 6, 9, or 16 document (input) pages on each output page. +.TP 5 +\fB\-o number\-up\-layout=\fIlayout\fR +Specifies the layout of pages with the "number-up" option. +The "layout" string can be "btlr", "btrl", "lrbt", "lrtb", "rlbt", "rltb", "tblr", or "tbrl" - the first two letters determine the column order while the second two letters determine the row order. +"bt" is bottom-to-top, "lr" is left-to-right, "rl" is right-to-left, and "tb" is top-to-bottom. +.TP 5 +\fB\-o orientation\-requested=4\fR +Prints the job in landscape (rotated 90 degrees counter-clockwise). +.TP 5 +\fB\-o orientation\-requested=5\fR +Prints the job in landscape (rotated 90 degrees clockwise). +.TP 5 +\fB\-o orientation\-requested=6\fR +Prints the job in reverse portrait (rotated 180 degrees). +.TP 5 +\fB\-o outputorder=reverse\fR +Prints pages in reverse order. +.TP 5 +\fB\-o page\-border=\fIborder\fR +Prints a border around each document page. +"border" is "double", "double\-thick", "single", or "single\-thick". +.TP 5 +\fB\-o page\-ranges=\fIpage-list\fR +Specifies which pages to print in the document. +The list can contain a list of numbers and ranges (#-#) separated by commas, e.g., "1,3-5,16". +The page numbers refer to the output pages and not the document's original pages - options like "number-up" can affect the numbering of the pages. +.TP 5 +\fB\-o sides=one\-sided\fR +Prints on one side of the paper. +.TP 5 +\fB\-o sides=two\-sided\-long\-edge\fR +Prints on both sides of the paper for portrait output. +.TP 5 +\fB\-o sides=two\-sided\-short\-edge\fR +Prints on both sides of the paper for landscape output. .SH NOTES The \fI\-c\fR, \fI\-d\fR, \fI\-f\fR, \fI\-g\fR, \fI\-i\fR, \fI\-n\fR, \fI\-t\fR, \fI\-v\fR, and \fI\-w\fR options are not supported by CUPS and produce a warning message if used. .SH EXAMPLES @@ -141,4 +214,4 @@ Print a presentation document 2-up to a printer called "foo": .BR lpstat (1), CUPS Online Help (http://localhost:631/help) .SH COPYRIGHT -Copyright \[co] 2007-2015 by Apple Inc. +Copyright \[co] 2007-2016 by Apple Inc. |