900 lines
22 KiB
Diff
900 lines
22 KiB
Diff
From 4d6787bd98c2fac8dcc58f34125d299d82e622aa Mon Sep 17 00:00:00 2001
|
||
From: Michael R Sweet <michael.r.sweet@gmail.com>
|
||
Date: Mon, 2 May 2022 15:35:20 -0400
|
||
Subject: [PATCH] Update man pages for -h option (Issue #357)
|
||
|
||
---
|
||
CHANGES.md | 1 +
|
||
doc/help/man-cancel.html | 7 ++++---
|
||
doc/help/man-cupsctl.html | 7 ++++---
|
||
doc/help/man-ipptool.html | 6 ++++++
|
||
doc/help/man-lp.html | 9 +++++----
|
||
doc/help/man-lpinfo.html | 9 +++++----
|
||
doc/help/man-lpmove.html | 9 +++++----
|
||
doc/help/man-lpoptions.html | 17 +++++++++--------
|
||
doc/help/man-lpq.html | 5 +++--
|
||
doc/help/man-lpr.html | 5 +++--
|
||
doc/help/man-lprm.html | 6 +++---
|
||
doc/help/man-lpstat.html | 5 +++--
|
||
man/cancel.1 | 9 +++++----
|
||
man/cupsctl.8 | 9 +++++----
|
||
man/lp.1 | 11 ++++++-----
|
||
man/lpinfo.8 | 11 ++++++-----
|
||
man/lpmove.8 | 11 ++++++-----
|
||
man/lpoptions.1 | 19 ++++++++++---------
|
||
man/lpq.1 | 7 ++++---
|
||
man/lpr.1 | 7 ++++---
|
||
man/lprm.1 | 8 ++++----
|
||
man/lpstat.1 | 11 ++++++-----
|
||
22 files changed, 107 insertions(+), 82 deletions(-)
|
||
|
||
diff --git a/doc/help/man-cancel.html b/doc/help/man-cancel.html
|
||
index d51bb2b91..a0b52369c 100644
|
||
--- a/doc/help/man-cancel.html
|
||
+++ b/doc/help/man-cancel.html
|
||
@@ -12,6 +12,9 @@ cancel - cancel jobs
|
||
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
|
||
<b>cancel</b>
|
||
[
|
||
+<b>-h</b>
|
||
+<i>hostname[:port]</i>
|
||
+] [
|
||
<b>-E</b>
|
||
] [
|
||
<b>-U</b>
|
||
@@ -19,9 +22,6 @@ cancel - cancel jobs
|
||
] [
|
||
<b>-a</b>
|
||
] [
|
||
-<b>-h</b>
|
||
-<i>hostname[:port]</i>
|
||
-] [
|
||
<b>-u</b>
|
||
<i>username</i>
|
||
] [
|
||
@@ -46,6 +46,7 @@ destinations if none is provided.
|
||
<dd style="margin-left: 5.0em">Forces encryption when connecting to the server.
|
||
<dt><b>-h </b><i>hostname</i>[<i>:port</i>]
|
||
<dd style="margin-left: 5.0em">Specifies an alternate server.
|
||
+Note: This option must occur before all others.
|
||
<dt><b>-U </b><i>username</i>
|
||
<dd style="margin-left: 5.0em">Specifies the username to use when connecting to the server.
|
||
<dt><b>-u </b><i>username</i>
|
||
diff --git a/doc/help/man-cupsctl.html b/doc/help/man-cupsctl.html
|
||
index b3f892ef9..e5c98dccb 100644
|
||
--- a/doc/help/man-cupsctl.html
|
||
+++ b/doc/help/man-cupsctl.html
|
||
@@ -12,14 +12,14 @@ cupsctl - configure cupsd.conf options
|
||
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
|
||
<b>cupsctl</b>
|
||
[
|
||
+<b>-h</b>
|
||
+<i>server</i>[<b>:</b><i>port</i>]
|
||
+] [
|
||
<b>-E</b>
|
||
] [
|
||
<b>-U</b>
|
||
<i>username</i>
|
||
] [
|
||
-<b>-h</b>
|
||
-<i>server</i>[<b>:</b><i>port</i>]
|
||
-] [
|
||
<b>--</b>[<b>no-</b>]<b>debug-logging</b>
|
||
] [
|
||
<b>--</b>[<b>no-</b>]<b>remote-admin</b>
|
||
@@ -45,6 +45,7 @@ The following options are recognized:
|
||
<dd style="margin-left: 5.0em">Specifies an alternate username to use when authenticating with the scheduler.
|
||
<dt><b>-h </b><i>server</i>[<b>:</b><i>port</i>]
|
||
<dd style="margin-left: 5.0em">Specifies the server address.
|
||
+Note: This option must occur before all others.
|
||
<dt><b>--</b>[<b>no-</b>]<b>debug-logging</b>
|
||
<dd style="margin-left: 5.0em">Enables (disables) debug logging to the <i>error_log</i> file.
|
||
<dt><b>--</b>[<b>no-</b>]<b>remote-admin</b>
|
||
diff --git a/doc/help/man-ipptool.html b/doc/help/man-ipptool.html
|
||
index 81f67d77f..688454c69 100644
|
||
--- a/doc/help/man-ipptool.html
|
||
+++ b/doc/help/man-ipptool.html
|
||
@@ -59,6 +59,8 @@ ipptool - perform internet printing protocol requests
|
||
<b>-i</b>
|
||
<i>seconds</i>
|
||
] [
|
||
+<b>-j</b>
|
||
+] [
|
||
<b>-n</b>
|
||
<i>repeat-count</i>
|
||
] [
|
||
@@ -150,6 +152,10 @@ This option is incompatible with the <b>-i</b> (interval) and <b>-n</b> (repeat-
|
||
<i>testfile</i>
|
||
should be repeated at the specified interval.
|
||
This option is incompatible with the <b>-X</b> (XML plist output) option.
|
||
+<dt><b>-j</b>
|
||
+<dd style="margin-left: 5.0em">Specifies that
|
||
+<b>ipptool</b>
|
||
+will produce JSON output.
|
||
<dt><b>-l</b>
|
||
<dd style="margin-left: 5.0em">Specifies that plain text output is desired.
|
||
<dt><b>-n</b><i> repeat-count</i>
|
||
diff --git a/doc/help/man-lp.html b/doc/help/man-lp.html
|
||
index f70c088d3..6442e900d 100644
|
||
--- a/doc/help/man-lp.html
|
||
+++ b/doc/help/man-lp.html
|
||
@@ -12,6 +12,8 @@ lp - print files
|
||
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
|
||
<b>lp</b>
|
||
[
|
||
+<b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
|
||
+] [
|
||
<b>-E</b>
|
||
] [
|
||
<b>-U</b>
|
||
@@ -21,8 +23,6 @@ lp - print files
|
||
] [
|
||
<b>-d </b><i>destination</i>[<b>/</b><i>instance</i>]
|
||
] [
|
||
-<b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
|
||
-] [
|
||
<b>-m</b>
|
||
] [
|
||
<b>-n</b>
|
||
@@ -51,6 +51,8 @@ lp - print files
|
||
<br>
|
||
<b>lp</b>
|
||
[
|
||
+<b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
|
||
+] [
|
||
<b>-E</b>
|
||
] [
|
||
<b>-U</b>
|
||
@@ -58,8 +60,6 @@ lp - print files
|
||
] [
|
||
<b>-c</b>
|
||
] [
|
||
-<b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
|
||
-] [
|
||
<b>-i</b>
|
||
<i>job-id</i>
|
||
] [
|
||
@@ -106,6 +106,7 @@ In CUPS, print files are always sent to the scheduler via IPP which has the same
|
||
<dd style="margin-left: 5.0em">Prints files to the named printer.
|
||
<dt><b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
|
||
<dd style="margin-left: 5.0em">Chooses an alternate server.
|
||
+Note: This option must occur before all others.
|
||
<dt><b>-i </b><i>job-id</i>
|
||
<dd style="margin-left: 5.0em">Specifies an existing job to modify.
|
||
<dt><b>-m</b>
|
||
diff --git a/doc/help/man-lpinfo.html b/doc/help/man-lpinfo.html
|
||
index a1aed9421..30df7691c 100644
|
||
--- a/doc/help/man-lpinfo.html
|
||
+++ b/doc/help/man-lpinfo.html
|
||
@@ -12,10 +12,10 @@ lpinfo - show available devices or drivers (deprecated)
|
||
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
|
||
<b>lpinfo</b>
|
||
[
|
||
-<b>-E</b>
|
||
-] [
|
||
<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
|
||
] [
|
||
+<b>-E</b>
|
||
+] [
|
||
<b>-l</b>
|
||
] [
|
||
<b>--device-id</b>
|
||
@@ -40,10 +40,10 @@ lpinfo - show available devices or drivers (deprecated)
|
||
<br>
|
||
<b>lpinfo</b>
|
||
[
|
||
-<b>-E</b>
|
||
-] [
|
||
<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
|
||
] [
|
||
+<b>-E</b>
|
||
+] [
|
||
<b>-l</b>
|
||
] [
|
||
<b>--exclude-schemes</b>
|
||
@@ -66,6 +66,7 @@ The first form (<i>-m</i>) lists the available drivers, while the second form (<
|
||
<dd style="margin-left: 5.0em">Forces encryption when connecting to the server.
|
||
<dt><b>-h </b><i>server</i>[<b>:</b><i>port</i>]
|
||
<dd style="margin-left: 5.0em">Selects an alternate server.
|
||
+Note: This option must occur before all others.
|
||
<dt><b>-l</b>
|
||
<dd style="margin-left: 5.0em">Shows a "long" listing of devices or drivers.
|
||
<dt><b>--device-id </b><i>device-id-string</i>
|
||
diff --git a/doc/help/man-lpmove.html b/doc/help/man-lpmove.html
|
||
index d8019ee25..b0db753f9 100644
|
||
--- a/doc/help/man-lpmove.html
|
||
+++ b/doc/help/man-lpmove.html
|
||
@@ -12,10 +12,10 @@ lpmove - move a job or all jobs to a new destination
|
||
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
|
||
<b>lpmove</b>
|
||
[
|
||
-<b>-E</b>
|
||
-] [
|
||
<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
|
||
] [
|
||
+<b>-E</b>
|
||
+] [
|
||
<b>-U</b>
|
||
<i>username</i>
|
||
]
|
||
@@ -24,10 +24,10 @@ lpmove - move a job or all jobs to a new destination
|
||
<br>
|
||
<b>lpmove</b>
|
||
[
|
||
-<b>-E</b>
|
||
-] [
|
||
<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
|
||
] [
|
||
+<b>-E</b>
|
||
+] [
|
||
<b>-U</b>
|
||
<i>username</i>
|
||
]
|
||
@@ -44,6 +44,7 @@ The <b>lpmove</b> command supports the following options:
|
||
<dd style="margin-left: 5.0em">Specifies an alternate username.
|
||
<dt><b>-h </b><i>server</i>[<b>:</b><i>port</i>]
|
||
<dd style="margin-left: 5.0em">Specifies an alternate server.
|
||
+Note: This option must occur before all others.
|
||
</dl>
|
||
<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
|
||
Move job 123 from "oldprinter" to "newprinter":
|
||
diff --git a/doc/help/man-lpoptions.html b/doc/help/man-lpoptions.html
|
||
index 6dda87f64..6af78290b 100644
|
||
--- a/doc/help/man-lpoptions.html
|
||
+++ b/doc/help/man-lpoptions.html
|
||
@@ -12,12 +12,12 @@
|
||
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
|
||
<b>lpoptions</b>
|
||
[
|
||
-<b>-E</b>
|
||
-] [
|
||
-<b>-U</b>
|
||
-<i>username</i>
|
||
-] [
|
||
<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
|
||
+] [
|
||
+<b>-E</b>
|
||
+] [
|
||
+<b>-U</b>
|
||
+<i>username</i>
|
||
]
|
||
<b>-d </b><i>destination</i>[<b>/</b><i>instance</i>]
|
||
[
|
||
@@ -26,26 +26,26 @@
|
||
<br>
|
||
<b>lpoptions</b>
|
||
[
|
||
-<b>-E</b>
|
||
-] [
|
||
-<b>-U</b>
|
||
-<i>username</i>
|
||
-] [
|
||
<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
|
||
] [
|
||
+<b>-E</b>
|
||
+] [
|
||
+<b>-U</b>
|
||
+<i>username</i>
|
||
+] [
|
||
<b>-p </b><i>destination</i>[<b>/</b><i>instance</i>]
|
||
]
|
||
<b>-o </b><i>option</i>[<b>=</b><i>value</i>] ...
|
||
<br>
|
||
<b>lpoptions</b>
|
||
[
|
||
-<b>-E</b>
|
||
-] [
|
||
-<b>-U</b>
|
||
-<i>username</i>
|
||
-] [
|
||
<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
|
||
] [
|
||
+<b>-E</b>
|
||
+] [
|
||
+<b>-U</b>
|
||
+<i>username</i>
|
||
+] [
|
||
<b>-p </b><i>destination</i>[<b>/</b><i>instance</i>]
|
||
]
|
||
<b>-r</b>
|
||
@@ -53,12 +53,12 @@
|
||
<br>
|
||
<b>lpoptions</b>
|
||
[
|
||
-<b>-E</b>
|
||
-] [
|
||
-<b>-U</b>
|
||
-<i>username</i>
|
||
-] [
|
||
<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
|
||
+] [
|
||
+<b>-E</b>
|
||
+] [
|
||
+<b>-U</b>
|
||
+<i>username</i>
|
||
]
|
||
<b>-x </b><i>destination</i>[<b>/</b><i>instance</i>]
|
||
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
|
||
@@ -84,6 +84,7 @@
|
||
This option overrides the system default printer for the current user.
|
||
<dt><b>-h </b><i>server</i>[<b>:</b><i>port</i>]
|
||
<dd style="margin-left: 5.0em">Uses an alternate server.
|
||
+Note: This option must occur before all others.
|
||
<dt><b>-l</b>
|
||
<dd style="margin-left: 5.0em">Lists the printer specific options and their current settings.
|
||
<dt><b>-o </b><i>option</i>[<b>=</b><i>value</i>]
|
||
@@ -119,7 +120,7 @@
|
||
<a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</b>(1),</a>
|
||
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
|
||
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
|
||
-Copyright © 2007-2017 by Apple Inc.
|
||
+Copyright © 2021-2022 by OpenPrinting.
|
||
|
||
</body>
|
||
</html>
|
||
diff --git a/doc/help/man-lpq.html b/doc/help/man-lpq.html
|
||
index 1c9e704ff..19e536d3c 100644
|
||
--- a/doc/help/man-lpq.html
|
||
+++ b/doc/help/man-lpq.html
|
||
@@ -12,13 +12,13 @@ lpq - show printer queue status
|
||
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
|
||
<b>lpq</b>
|
||
[
|
||
+<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
|
||
+] [
|
||
<b>-E</b>
|
||
] [
|
||
<b>-U</b>
|
||
<i>username</i>
|
||
] [
|
||
-<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
|
||
-] [
|
||
<b>-P </b><i>destination</i>[<b>/</b><i>instance</i>]
|
||
] [
|
||
<b>-a</b>
|
||
@@ -44,6 +44,7 @@ Jobs queued on the default destination will be shown if no printer or class is s
|
||
<dd style="margin-left: 5.0em">Reports jobs on all printers.
|
||
<dt><b>-h </b><i>server</i>[<b>:</b><i>port</i>]
|
||
<dd style="margin-left: 5.0em">Specifies an alternate server.
|
||
+Note: This option must occur before all others.
|
||
<dt><b>-l</b>
|
||
<dd style="margin-left: 5.0em">Requests a more verbose (long) reporting format.
|
||
</dl>
|
||
diff --git a/doc/help/man-lpr.html b/doc/help/man-lpr.html
|
||
index d044ab1a8..f9b19e1fe 100644
|
||
--- a/doc/help/man-lpr.html
|
||
+++ b/doc/help/man-lpr.html
|
||
@@ -12,10 +12,10 @@ lpr - print files
|
||
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
|
||
<b>lpr</b>
|
||
[
|
||
-<b>-E</b>
|
||
-] [
|
||
<b>-H </b><i>server</i>[<b>:</b><i>port</i>]
|
||
] [
|
||
+<b>-E</b>
|
||
+] [
|
||
<b>-U</b>
|
||
<i>username</i>
|
||
] [
|
||
@@ -67,6 +67,7 @@ The following options are recognized by <i>lpr</i>:
|
||
<dd style="margin-left: 5.0em">Forces encryption when connecting to the server.
|
||
<dt><b>-H </b><i>server</i>[<b>:</b><i>port</i>]
|
||
<dd style="margin-left: 5.0em">Specifies an alternate server.
|
||
+Note: This option must occur before all others.
|
||
<dt><b>-C "</b><i>name</i><b>"</b>
|
||
<dd style="margin-left: 5.0em"><dt><b>-J "</b><i>name</i><b>"</b>
|
||
<dd style="margin-left: 5.0em"><dt><b>-T "</b><i>name</i><b>"</b>
|
||
diff --git a/doc/help/man-lprm.html b/doc/help/man-lprm.html
|
||
index 7410320a3..dbe7f20de 100644
|
||
--- a/doc/help/man-lprm.html
|
||
+++ b/doc/help/man-lprm.html
|
||
@@ -12,14 +12,13 @@ lprm - cancel print jobs
|
||
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
|
||
<b>lprm</b>
|
||
[
|
||
+<b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
|
||
+] [
|
||
<b>-E</b>
|
||
] [
|
||
<b>-U</b>
|
||
<i>username</i>
|
||
] [
|
||
-<b>-h</b>
|
||
-<i>server</i>[<i>:port</i>]
|
||
-] [
|
||
<b>-P</b>
|
||
<i>destination</i>[<i>/instance</i>]
|
||
] [
|
||
@@ -45,6 +44,7 @@ command supports the following options:
|
||
<dd style="margin-left: 5.0em">Specifies an alternate username.
|
||
<dt><b>-h </b><i>server</i>[<i>:port</i>]
|
||
<dd style="margin-left: 5.0em">Specifies an alternate server.
|
||
+Note: This option must occur before all others.
|
||
</dl>
|
||
<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
|
||
The CUPS version of
|
||
diff --git a/doc/help/man-lpstat.html b/doc/help/man-lpstat.html
|
||
index f23089bbe..2c5dedc7c 100644
|
||
--- a/doc/help/man-lpstat.html
|
||
+++ b/doc/help/man-lpstat.html
|
||
@@ -12,6 +12,8 @@ lpstat - print cups status information
|
||
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
|
||
<b>lpstat</b>
|
||
[
|
||
+<b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
|
||
+] [
|
||
<b>-E</b>
|
||
] [
|
||
<b>-H</b>
|
||
@@ -19,8 +21,6 @@ lpstat - print cups status information
|
||
<b>-U</b>
|
||
<i>username</i>
|
||
] [
|
||
-<b>-h </b><i>hostname</i>[<b>:</b><i>port</i>]
|
||
-] [
|
||
<b>-l</b>
|
||
] [
|
||
<b>-W</b>
|
||
@@ -91,6 +91,7 @@ If no classes are specified then all classes are listed.
|
||
<dd style="margin-left: 5.0em">Shows all available destinations on the local network.
|
||
<dt><b>-h </b><i>server</i>[<b>:</b><i>port</i>]
|
||
<dd style="margin-left: 5.0em">Specifies an alternate server.
|
||
+Note: This option must occur before all others.
|
||
<dt><b>-l</b>
|
||
<dd style="margin-left: 5.0em">Shows a long listing of printers, classes, or jobs.
|
||
<dt><b>-o </b>[<i>destination(s)</i>]
|
||
diff --git a/man/cancel.man b/man/cancel.man
|
||
index 34a5d9fc0..caea0ed69 100644
|
||
--- a/man/cancel.man
|
||
+++ b/man/cancel.man
|
||
@@ -10,12 +10,15 @@
|
||
.\" 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 cancel 1 "CUPS" "15 April 2014" "Apple Inc."
|
||
+.TH cancel 1 "CUPS" "2022-05-02" "OpenPrinting"
|
||
.SH NAME
|
||
cancel \- cancel jobs
|
||
.SH SYNOPSIS
|
||
.B cancel
|
||
[
|
||
+.B \-h
|
||
+.I hostname[:port]
|
||
+] [
|
||
.B \-E
|
||
] [
|
||
.B \-U
|
||
@@ -23,9 +26,6 @@
|
||
] [
|
||
.B \-a
|
||
] [
|
||
-.B \-h
|
||
-.I hostname[:port]
|
||
-] [
|
||
.B \-u
|
||
.I username
|
||
] [
|
||
@@ -52,6 +52,7 @@
|
||
.TP 5
|
||
\fB\-h \fIhostname\fR[\fI:port\fR]
|
||
Specifies an alternate server.
|
||
+Note: This option must occur before all others.
|
||
.TP 5
|
||
\fB\-U \fIusername\fR
|
||
Specifies the username to use when connecting to the server.
|
||
diff --git a/man/cupsctl.man b/man/cupsctl.man
|
||
index 1b1ff4183..7e50d07ac 100644
|
||
--- a/man/cupsctl.man
|
||
+++ b/man/cupsctl.man
|
||
@@ -10,20 +10,20 @@
|
||
.\" 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 cupsctl 8 "CUPS" "30 May 2016" "Apple Inc."
|
||
+.TH cupsctl 8 "CUPS" "2022-05-02" "OpenPrinting"
|
||
.SH NAME
|
||
cupsctl \- configure cupsd.conf options
|
||
.SH SYNOPSIS
|
||
.B cupsctl
|
||
[
|
||
+.B \-h
|
||
+\fIserver\fR[\fB:\fIport\fR]
|
||
+] [
|
||
.B \-E
|
||
] [
|
||
.B \-U
|
||
.I username
|
||
] [
|
||
-.B \-h
|
||
-\fIserver\fR[\fB:\fIport\fR]
|
||
-] [
|
||
\fB\-\-\fR[\fBno\-\fR]\fBdebug\-logging\fR
|
||
] [
|
||
\fB\-\-\fR[\fBno\-\fR]\fBremote\-admin\fR
|
||
@@ -51,6 +51,7 @@
|
||
.TP 5
|
||
\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
Specifies the server address.
|
||
+Note: This option must occur before all others.
|
||
.TP 5
|
||
\fB\-\-\fR[\fBno\-\fR]\fBdebug\-logging\fR
|
||
Enables (disables) debug logging to the \fIerror_log\fR file.
|
||
diff --git a/man/lp.man b/man/lp.man
|
||
index a54f904a5..4bdd2de7b 100644
|
||
--- a/man/lp.man
|
||
+++ b/man/lp.man
|
||
@@ -10,12 +10,14 @@
|
||
.\" 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" "2 May 2016" "Apple Inc."
|
||
+.TH lp 1 "CUPS" "2022-05-02" "OpenPrinting"
|
||
.SH NAME
|
||
lp \- print files
|
||
.SH SYNOPSIS
|
||
.B lp
|
||
[
|
||
+\fB\-h \fIhostname\fR[\fB:\fIport\fR]
|
||
+] [
|
||
.B \-E
|
||
] [
|
||
.B \-U
|
||
@@ -25,8 +27,6 @@
|
||
] [
|
||
\fB\-d \fIdestination\fR[\fB/\fIinstance\fR]
|
||
] [
|
||
-\fB\-h \fIhostname\fR[\fB:\fIport\fR]
|
||
-] [
|
||
.B \-m
|
||
] [
|
||
.B \-n
|
||
@@ -55,6 +55,8 @@
|
||
.br
|
||
.B lp
|
||
[
|
||
+\fB\-h \fIhostname\fR[\fB:\fIport\fR]
|
||
+] [
|
||
.B \-E
|
||
] [
|
||
.B \-U
|
||
@@ -62,8 +64,6 @@
|
||
] [
|
||
.B \-c
|
||
] [
|
||
-\fB\-h \fIhostname\fR[\fB:\fIport\fR]
|
||
-] [
|
||
.B \-i
|
||
.I job-id
|
||
] [
|
||
@@ -115,6 +115,7 @@
|
||
.TP 5
|
||
\fB\-h \fIhostname\fR[\fB:\fIport\fR]
|
||
Chooses an alternate server.
|
||
+Note: This option must occur before all others.
|
||
.TP 5
|
||
\fB\-i \fIjob-id\fR
|
||
Specifies an existing job to modify.
|
||
diff --git a/man/lpinfo.man b/man/lpinfo.man
|
||
index d238f9a60..d44b568d2 100644
|
||
--- a/man/lpinfo.man
|
||
+++ b/man/lpinfo.man
|
||
@@ -10,16 +10,16 @@
|
||
.\" 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 lpinfo 8 "CUPS" "12 June 2014" "Apple Inc."
|
||
+.TH lpinfo 8 "CUPS" "2022-05-02" "OpenPrinting"
|
||
.SH NAME
|
||
lpinfo \- show available devices or drivers
|
||
.SH SYNOPSIS
|
||
.B lpinfo
|
||
[
|
||
-.B \-E
|
||
-] [
|
||
\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
] [
|
||
+.B \-E
|
||
+] [
|
||
.B \-l
|
||
] [
|
||
.B \-\-device\-id
|
||
@@ -44,10 +44,10 @@
|
||
.br
|
||
.B lpinfo
|
||
[
|
||
-.B \-E
|
||
-] [
|
||
\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
] [
|
||
+.B \-E
|
||
+] [
|
||
.B \-l
|
||
] [
|
||
.B \-\-exclude\-schemes
|
||
@@ -71,6 +71,7 @@
|
||
.TP 5
|
||
\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
Selects an alternate server.
|
||
+Note: This option must occur before all others.
|
||
.TP 5
|
||
.B \-l
|
||
Shows a "long" listing of devices or drivers.
|
||
diff --git a/man/lpmove.man b/man/lpmove.man
|
||
index af3c6b63c..62adba654 100644
|
||
--- a/man/lpmove.man
|
||
+++ b/man/lpmove.man
|
||
@@ -10,16 +10,16 @@
|
||
.\" 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 lpmove 8 "CUPS" "26 May 2016" "Apple Inc."
|
||
+.TH lpmove 8 "CUPS" "2022-05-02" "OpenPrinting"
|
||
.SH NAME
|
||
lpmove \- move a job or all jobs to a new destination
|
||
.SH SYNOPSIS
|
||
.B lpmove
|
||
[
|
||
-.B \-E
|
||
-] [
|
||
\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
] [
|
||
+.B \-E
|
||
+] [
|
||
.B \-U
|
||
.I username
|
||
]
|
||
@@ -28,10 +28,10 @@
|
||
.br
|
||
.B lpmove
|
||
[
|
||
-.B \-E
|
||
-] [
|
||
\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
] [
|
||
+.B \-E
|
||
+] [
|
||
.B \-U
|
||
.I username
|
||
]
|
||
@@ -50,6 +50,7 @@
|
||
.TP 5
|
||
\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
Specifies an alternate server.
|
||
+Note: This option must occur before all others.
|
||
.SH EXAMPLES
|
||
Move job 123 from "oldprinter" to "newprinter":
|
||
.nf
|
||
diff --git a/man/lpoptions.man.in b/man/lpoptions.man.in
|
||
index 372f46a37..2eb5b6010 100644
|
||
--- a/man/lpoptions.man.in
|
||
+++ b/man/lpoptions.man.in
|
||
@@ -10,18 +10,18 @@
|
||
.\" 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 lpoptions 1 "CUPS" "12 June 2014" "Apple Inc."
|
||
+.TH lpoptions 1 "CUPS" "2022-05-02" "OpenPrinting"
|
||
.SH NAME
|
||
lpoptions \- display or set printer options and defaults
|
||
.SH SYNOPSIS
|
||
.B lpoptions
|
||
[
|
||
+\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
+] [
|
||
.B \-E
|
||
] [
|
||
.B \-U
|
||
.I username
|
||
-] [
|
||
-\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
]
|
||
\fB\-d \fIdestination\fR[\fB/\fIinstance\fR]
|
||
[
|
||
@@ -30,13 +30,13 @@
|
||
.br
|
||
.B lpoptions
|
||
[
|
||
+\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
+] [
|
||
.B \-E
|
||
] [
|
||
.B \-U
|
||
.I username
|
||
] [
|
||
-\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
-] [
|
||
\fB\-p \fIdestination\fR[\fB/\fIinstance\fR]
|
||
]
|
||
\fB\-o \fIoption\fR[\fB=\fIvalue\fR] ...
|
||
@@ -43,13 +43,13 @@
|
||
.br
|
||
.B lpoptions
|
||
[
|
||
+\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
+] [
|
||
.B \-E
|
||
] [
|
||
.B \-U
|
||
.I username
|
||
] [
|
||
-\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
-] [
|
||
\fB\-p \fIdestination\fR[\fB/\fIinstance\fR]
|
||
]
|
||
.B \-r
|
||
@@ -57,12 +57,12 @@
|
||
.br
|
||
.B lpoptions
|
||
[
|
||
+\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
+] [
|
||
.B \-E
|
||
] [
|
||
.B \-U
|
||
.I username
|
||
-] [
|
||
-\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
]
|
||
\fB\-x \fIdestination\fR[\fB/\fIinstance\fR]
|
||
.SH DESCRIPTION
|
||
@@ -96,6 +96,7 @@
|
||
.TP 5
|
||
\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
Uses an alternate server.
|
||
+Note: This option must occur before all others.
|
||
.TP 5
|
||
.B \-l
|
||
Lists the printer specific options and their current settings.
|
||
diff --git a/man/lpq.man b/man/lpq.man
|
||
index ce23a6c81..a81633ecb 100644
|
||
--- a/man/lpq.man
|
||
+++ b/man/lpq.man
|
||
@@ -10,19 +10,19 @@
|
||
.\" 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 lpq 1 "CUPS" "12 June 2014" "Apple Inc."
|
||
+.TH lpq 1 "CUPS" "2022-05-02" "OpenPrinting"
|
||
.SH NAME
|
||
lpq \- show printer queue status
|
||
.SH SYNOPSIS
|
||
.B lpq
|
||
[
|
||
+\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
+] [
|
||
.B \-E
|
||
] [
|
||
.B \-U
|
||
.I username
|
||
] [
|
||
-\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
-] [
|
||
\fB\-P \fIdestination\fR[\fB/\fIinstance\fR]
|
||
] [
|
||
.B \-a
|
||
@@ -53,6 +53,7 @@
|
||
.TP 5
|
||
\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
Specifies an alternate server.
|
||
+Note: This option must occur before all others.
|
||
.TP 5
|
||
.B \-l
|
||
Requests a more verbose (long) reporting format.
|
||
diff --git a/man/lpr.man b/man/lpr.man
|
||
index e5f9f9018..77a62b305 100644
|
||
--- a/man/lpr.man
|
||
+++ b/man/lpr.man
|
||
@@ -10,16 +10,16 @@
|
||
.\" 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" "2 May 2016" "Apple Inc."
|
||
+.TH lpr 1 "CUPS" "2022-05-02" "OpenPrinting"
|
||
.SH NAME
|
||
lpr \- print files
|
||
.SH SYNOPSIS
|
||
.B lpr
|
||
[
|
||
-.B \-E
|
||
-] [
|
||
\fB\-H \fIserver\fR[\fB:\fIport\fR]
|
||
] [
|
||
+.B \-E
|
||
+] [
|
||
.B \-U
|
||
.I username
|
||
] [
|
||
@@ -72,6 +72,7 @@
|
||
.TP 5
|
||
\fB\-H \fIserver\fR[\fB:\fIport\fR]
|
||
Specifies an alternate server.
|
||
+Note: This option must occur before all others.
|
||
.TP 5
|
||
\fB\-C "\fIname\fB"\fR
|
||
.TP 5
|
||
diff --git a/man/lprm.man b/man/lprm.man
|
||
index 094166539..0cf88ac51 100644
|
||
--- a/man/lprm.man
|
||
+++ b/man/lprm.man
|
||
@@ -10,20 +10,19 @@
|
||
.\" 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 lprm 1 "CUPS" "22 May 2014" "Apple Inc."
|
||
+.TH lprm 1 "CUPS" "2022-05-02" "OpenPrinting"
|
||
.SH NAME
|
||
lprm \- cancel print jobs
|
||
.SH SYNOPSIS
|
||
.B lprm
|
||
[
|
||
+\fB\-h \fIhostname\fR[\fB:\fIport\fR]
|
||
+] [
|
||
.B \-E
|
||
] [
|
||
.B \-U
|
||
.I username
|
||
] [
|
||
-.B \-h
|
||
-.IR server [ :port ]
|
||
-] [
|
||
.B \-P
|
||
.IR destination [ /instance ]
|
||
] [
|
||
@@ -52,6 +51,7 @@
|
||
.TP 5
|
||
\fB\-h \fIserver\fR[\fI:port\fR]
|
||
Specifies an alternate server.
|
||
+Note: This option must occur before all others.
|
||
.SH CONFORMING TO
|
||
The CUPS version of
|
||
.B lprm
|
||
diff --git a/man/lpstat.man b/man/lpstat.man
|
||
index 0a10cd9bc..88acff7b3 100644
|
||
--- a/man/lpstat.man
|
||
+++ b/man/lpstat.man
|
||
@@ -1,8 +1,8 @@
|
||
.\"
|
||
.\" lpstat man page for CUPS.
|
||
.\"
|
||
-.\" Copyright 2007-2017 by Apple Inc.
|
||
-.\" Copyright 1997-2006 by Easy Software Products.
|
||
+.\" Copyright © 2007-2019 by Apple Inc.
|
||
+.\" Copyright © 1997-2006 by Easy Software Products.
|
||
.\"
|
||
.\" These coded instructions, statements, and computer programs are the
|
||
.\" property of Apple Inc. and are protected by Federal copyright
|
||
@@ -10,12 +10,14 @@
|
||
.\" 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 lpstat 1 "CUPS" "26 May 2017" "Apple Inc."
|
||
+.TH lpstat 1 "CUPS" "2022-05-02" "OpenPrinting"
|
||
.SH NAME
|
||
lpstat \- print cups status information
|
||
.SH SYNOPSIS
|
||
.B lpstat
|
||
[
|
||
+\fB\-h \fIhostname\fR[\fB:\fIport\fR]
|
||
+] [
|
||
.B \-E
|
||
] [
|
||
.B \-H
|
||
@@ -23,8 +25,6 @@
|
||
.B \-U
|
||
.I username
|
||
] [
|
||
-\fB\-h \fIhostname\fR[\fB:\fIport\fR]
|
||
-] [
|
||
.B \-l
|
||
] [
|
||
.B \-W
|
||
@@ -104,6 +104,7 @@
|
||
.TP 5
|
||
\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
||
Specifies an alternate server.
|
||
+Note: This option must occur before all others.
|
||
.TP 5
|
||
.B \-l
|
||
Shows a long listing of printers, classes, or jobs.
|