Update ipp documentation to reflect the behavior of configuring WiFi on IPP USB printers.

[thirdparty/cups.git] / doc / help / man-lpr.html

diff --git a/doc/help/man-lpr.html b/doc/help/man-lpr.html
index b4aaaf57e85b1e8d833c1db966ddc7b4a0e6ab66..c945ea9c82ab79cb577cba257a7dabc7bd795c59 100644 (file)
--- a/doc/help/man-lpr.html
+++ b/doc/help/man-lpr.html
@@ -56,9 +56,9 @@ If no files are listed on the command-line, <b>lpr</b> reads the print file from
 <h3><a name="THE_DEFAULT_DESTINATION">The Default Destination</a></h3>
 CUPS provides many ways to set the default destination. The <b>LPDEST</b> and <b>PRINTER</b> environment variables are consulted first.
 If neither are set, the current default set using the
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1)</a>
+<b>lpoptions</b>(1)
 command is used, followed by the default set using the
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8)</a>
+<b>lpadmin</b>(8)
 command.
 <h2 class="title"><a name="OPTIONS">Options</a></h2>
 The following options are recognized by <i>lpr</i>:
@@ -86,6 +86,7 @@ This option is equivalent to <i>-o raw</i>.
 <dd style="margin-left: 5.0em">Send an email on job completion.
 <dt><b>-o </b><i>option</i>[<b>=</b><i>value</i>]
 <dd style="margin-left: 5.0em">Sets a job option.
+See "COMMON JOB OPTIONS" below.
 <dt><b>-p</b>
 <dd style="margin-left: 5.0em">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 <i>-o prettyprint</i> and is only useful when printing text files.
@@ -94,6 +95,35 @@ This option is equivalent to <i>-o prettyprint</i> and is only useful when print
 <dt><b>-r</b>
 <dd style="margin-left: 5.0em">Specifies that the named print files should be deleted after submitting them.
 </dl>
+<h3><a name="COMMON_JOB_OPTIONS">Common Job Options</a></h3>
+Aside from the printer-specific options reported by the
+<b>lpoptions</b>(1)
+command, the following generic options are available:
+<dl class="man">
+<dt><b>-o job-sheets=</b><i>name</i>
+<dd style="margin-left: 5.0em">Prints a cover page (banner) with the document.
+The "name" can be "classified", "confidential", "secret", "standard", "topsecret", or "unclassified".
+<dt><b>-o media=</b><i>size</i>
+<dd style="margin-left: 5.0em">Sets the page size to <i>size</i>. Most printers support at least the size names "a4", "letter", and "legal".
+<dt><b>-o number-up=</b>{<i>2|4|6|9|16</i>}
+<dd style="margin-left: 5.0em">Prints 2, 4, 6, 9, or 16 document (input) pages on each output page.
+<dt><b>-o orientation-requested=4</b>
+<dd style="margin-left: 5.0em">Prints the job in landscape (rotated 90 degrees counter-clockwise).
+<dt><b>-o orientation-requested=5</b>
+<dd style="margin-left: 5.0em">Prints the job in landscape (rotated 90 degrees clockwise).
+<dt><b>-o orientation-requested=6</b>
+<dd style="margin-left: 5.0em">Prints the job in reverse portrait (rotated 180 degrees).
+<dt><b>-o print-quality=3</b>
+<dd style="margin-left: 5.0em"><dt><b>-o print-quality=4</b>
+<dd style="margin-left: 5.0em"><dt><b>-o print-quality=5</b>
+<dd style="margin-left: 5.0em">Specifies the output quality - draft (3), normal (4), or best (5).
+<dt><b>-o sides=one-sided</b>
+<dd style="margin-left: 5.0em">Prints on one side of the paper.
+<dt><b>-o sides=two-sided-long-edge</b>
+<dd style="margin-left: 5.0em">Prints on both sides of the paper for portrait output.
+<dt><b>-o sides=two-sided-short-edge</b>
+<dd style="margin-left: 5.0em">Prints on both sides of the paper for landscape output.
+</dl>
 <h2 class="title"><a name="NOTES">Notes</a></h2>
 The <i>-c</i>, <i>-d</i>, <i>-f</i>, <i>-g</i>, <i>-i</i>, <i>-n</i>, <i>-t</i>, <i>-v</i>, and <i>-w</i> options are not supported by CUPS and produce a warning message if used.
 <h2 class="title"><a name="EXAMPLES">Examples</a></h2>
@@ -115,16 +145,16 @@ Print a presentation document 2-up to a printer called "foo":
     lpr -P foo -o number-up=2 filename
 </pre>
 <h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a>
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1),</a>
-<a href="man-lpq.html?TOPIC=Man+Pages"><b>lpq</b>(1),</a>
-<a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</b>(1),</a>
-<a href="man-lpstat.html?TOPIC=Man+Pages"><b>lpstat</b>(1),</a>
+<b>cancel</b>(1),
+<b>lp</b>(1),
+<b>lpadmin</b>(8),
+<b>lpoptions</b>(1),
+<b>lpq</b>(1),
+<b>lprm</b>(1),
+<b>lpstat</b>(1),
 CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
 <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright &copy; 2007-2014 by Apple Inc.
+Copyright &copy; 2007-2019 by Apple Inc.
 
 </body>
 </html>