Skip to content

Commit 1003ac4

Browse files
committed
Update cancel man page
Fixes #984
1 parent 92de938 commit 1003ac4

3 files changed

Lines changed: 19 additions & 6 deletions

File tree

CHANGES.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ Changes in CUPS v2.4.17 (YYYY-MM-DD)
88
- The scheduler followed symbolic links when cleaning out its temporary
99
directory (Issue #1448)
1010
- Updated `cupsFileGetConf` and `cupsFilePutConf` to escape more characters.
11+
- Updated man page `cancel` (Issue #984)
1112
- Updated `cupsRasterReadHeader` to validate more of the page header values
1213
(Issue #1501)
1314
- Fixed an issue with the class/printer CGI name checking.

doc/help/man-cancel.html

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -72,16 +72,22 @@ <h2 class="title"><a name="EXAMPLES">Examples</a></h2>
7272
cancel -a
7373
</pre>
7474
<h2 class="title"><a name="NOTES">Notes</a></h2>
75-
Administrators wishing to prevent unauthorized cancellation of jobs via the <i>-u</i> option should require authentication for Cancel-Jobs operations in
76-
<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5).</a>
75+
The
76+
<b>-a</b>
77+
and
78+
<b>-u</b><i>" username"</i>
79+
options require administrative access.
80+
These restrictions are part of the operation policies defined in the
81+
<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5)</a>
82+
file for the "Cancel-Jobs" and "Cancel-My-Jobs" operations, respectively.
7783
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
7884
<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
7985
<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
8086
<a href="man-lpmove.html?TOPIC=Man+Pages"><b>lpmove</b>(8),</a>
8187
<a href="man-lpstat.html?TOPIC=Man+Pages"><b>lpstat</b>(1),</a>
8288
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
8389
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
84-
Copyright &copy; 2020-2024 by OpenPrinting.
90+
Copyright &copy; 2020-2026 by OpenPrinting.
8591

8692
</body>
8793
</html>

man/cancel.1

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more
99
.\" information.
1010
.\"
11-
.TH cancel 1 "CUPS" "2022-05-02" "OpenPrinting"
11+
.TH cancel 1 "CUPS" "2026-03-06" "OpenPrinting"
1212
.SH NAME
1313
cancel \- cancel jobs
1414
.SH SYNOPSIS
@@ -81,8 +81,14 @@ Cancel all jobs:
8181
cancel \-a
8282
.fi
8383
.SH NOTES
84-
Administrators wishing to prevent unauthorized cancellation of jobs via the \fI\-u\fR option should require authentication for Cancel-Jobs operations in
85-
.BR cupsd.conf (5).
84+
The
85+
.B \-a
86+
and
87+
.BI \-u " username"
88+
options require administrative access.
89+
These restrictions are part of the operation policies defined in the
90+
.BR cupsd.conf (5)
91+
file for the "Cancel-Jobs" and "Cancel-My-Jobs" operations, respectively.
8692
.SH SEE ALSO
8793
.BR cupsd.conf (5),
8894
.BR lp (1),

0 commit comments

Comments
 (0)