From: Michael Sweet Date: Wed, 11 May 2016 14:33:53 +0000 (-0400) Subject: Update man pages. X-Git-Tag: v2.2b1~34 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=423e6ddbf3b2e5312893a0655e5535c363182c0a;p=thirdparty%2Fcups.git Update man pages. --- diff --git a/doc/help/man-lp.html b/doc/help/man-lp.html index 73d7c2d937..788e25a723 100644 --- a/doc/help/man-lp.html +++ b/doc/help/man-lp.html @@ -114,6 +114,7 @@ In CUPS, print files are always sent to the scheduler via IPP which has the same
Sets the number of copies to print.
-o "name=value [ ... name=value ]"
Sets one or more job options. +See "COMMON JOB OPTIONS" below.
-q priority
Sets the job priority from 1 (lowest) to 100 (highest). The default priority is 50. @@ -140,20 +141,54 @@ Aside from the printer-specific options reported by the lpoptions(1) command, the following generic options are available:
+
-o collate=true +
Prints collated copies. +
-o fit-to-page +
Scales the print file to fit on the page. +
-o job-hold-until=when +
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. +
-o job-hold-until=hh:mm +
Holds the job until the specified time in hours and minutes UTC. +
-o job-priority=priority +
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. +
-o job-sheets=name +
Prints a cover page (banner) with the document. +The "name" can be "classified", "confidential", "secret", "standard", "topsecret", or "unclassified". +
-o job-sheets=start-name,end-name +
Prints cover pages (banners) with the document.
-o media=size
Sets the page size to size. Most printers support at least the size names "a4", "letter", and "legal". +
-o mirror +
Mirrors each page. +
-o number-up={2|4|6|9|16} +
Prints 2, 4, 6, 9, or 16 document (input) pages on each output page. +
-o number-up-layout=layout +
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.
-o orientation-requested=4 -
Prints the job in landscape (rotated 90 degrees). +
Prints the job in landscape (rotated 90 degrees counter-clockwise). +
-o orientation-requested=5 +
Prints the job in landscape (rotated 90 degrees clockwise). +
-o orientation-requested=6 +
Prints the job in reverse portrait (rotated 180 degrees). +
-o outputorder=reverse +
Prints pages in reverse order. +
-o page-border=border +
Prints a border around each document page. +"border" is "double", "double-thick", "single", or "single-thick". +
-o page-ranges=page-list +
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.
-o sides=one-sided
Prints on one side of the paper.
-o sides=two-sided-long-edge
Prints on both sides of the paper for portrait output.
-o sides=two-sided-short-edge
Prints on both sides of the paper for landscape output. -
-o fit-to-page -
Scales the print file to fit on the page. -
-o number-up={2|4|6|9|16} -
Prints 2, 4, 6, 9, or 16 document (input) pages on each output page.

Conforming To

Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", or "#". @@ -187,7 +222,7 @@ Print a presentation document 2-up to a printer called "foo": lpstat(1), CUPS Online Help (http://localhost:631/help)

Copyright

-Copyright © 2007-2015 by Apple Inc. +Copyright © 2007-2016 by Apple Inc. diff --git a/doc/help/man-lpr.html b/doc/help/man-lpr.html index 98fc7c6383..0e4801e2d9 100644 --- a/doc/help/man-lpr.html +++ b/doc/help/man-lpr.html @@ -86,6 +86,7 @@ This option is equivalent to -o raw.
Send an email on job completion.
-o option[=value]
Sets a job option. +See "COMMON JOB OPTIONS" below.
-p
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. @@ -94,6 +95,60 @@ This option is equivalent to -o prettyprint and is only useful when print
-r
Specifies that the named print files should be deleted after submitting them. +

Common Job Options

+Aside from the printer-specific options reported by the +lpoptions(1) +command, the following generic options are available: +
+
-o collate=true +
Prints collated copies. +
-o fit-to-page +
Scales the print file to fit on the page. +
-o job-hold-until=when +
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. +
-o job-hold-until=hh:mm +
Holds the job until the specified time in hours and minutes UTC. +
-o job-priority=priority +
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. +
-o job-sheets=name +
Prints a cover page (banner) with the document. +The "name" can be "classified", "confidential", "secret", "standard", "topsecret", or "unclassified". +
-o job-sheets=start-name,end-name +
Prints cover pages (banners) with the document. +
-o media=size +
Sets the page size to size. Most printers support at least the size names "a4", "letter", and "legal". +
-o mirror +
Mirrors each page. +
-o number-up={2|4|6|9|16} +
Prints 2, 4, 6, 9, or 16 document (input) pages on each output page. +
-o number-up-layout=layout +
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. +
-o orientation-requested=4 +
Prints the job in landscape (rotated 90 degrees counter-clockwise). +
-o orientation-requested=5 +
Prints the job in landscape (rotated 90 degrees clockwise). +
-o orientation-requested=6 +
Prints the job in reverse portrait (rotated 180 degrees). +
-o outputorder=reverse +
Prints pages in reverse order. +
-o page-border=border +
Prints a border around each document page. +"border" is "double", "double-thick", "single", or "single-thick". +
-o page-ranges=page-list +
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. +
-o sides=one-sided +
Prints on one side of the paper. +
-o sides=two-sided-long-edge +
Prints on both sides of the paper for portrait output. +
-o sides=two-sided-short-edge +
Prints on both sides of the paper for landscape output. +

Notes

The -c, -d, -f, -g, -i, -n, -t, -v, and -w options are not supported by CUPS and produce a warning message if used.

Examples

@@ -124,7 +179,7 @@ Print a presentation document 2-up to a printer called "foo": lpstat(1), CUPS Online Help (http://localhost:631/help)

Copyright

-Copyright © 2007-2015 by Apple Inc. +Copyright © 2007-2016 by Apple Inc.