X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=man%2Fcancel.man;fp=man%2Fcancel.man;h=f1d068e155af91ce5a02a6b49b1fbd00ab1f0ace;hb=7131e2853ab6765e63e13d8faacc84b0ff903305;hp=15adcb22d7135b654c3f711d250060f4ed60a616;hpb=6b13fa61b6b018f7692507f25308cdc61e187eaa;p=thirdparty%2Fcups.git

diff --git a/man/cancel.man b/man/cancel.man
index 15adcb22d..f1d068e15 100644
--- a/man/cancel.man
+++ b/man/cancel.man
@@ -1,79 +1,98 @@
 .\"
 .\" "$Id$"
 .\"
-.\"   cancel man page for CUPS.
+.\" cancel man page for CUPS.
 .\"
-.\"   Copyright 2007-2013 by Apple Inc.
-.\"   Copyright 1997-2006 by Easy Software Products.
+.\" Copyright 2007-2014 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
-.\"   law.  Distribution and use rights are outlined in the file "LICENSE.txt"
-.\"   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/".
+.\" These coded instructions, statements, and computer programs are the
+.\" property of Apple Inc. and are protected by Federal copyright
+.\" law.  Distribution and use rights are outlined in the file "LICENSE.txt"
+.\" 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" "21 January 2013" "Apple Inc."
+.TH cancel 1 "CUPS" "15 April 2014" "Apple Inc."
 .SH NAME
-cancel - cancel jobs
+cancel \- cancel jobs
 .SH SYNOPSIS
 .B cancel
-[ -E ] [ -U
+[
+.I \-E
+] [
+.I \-U
 .I username
-] [ -a ] [ -h
+] [
+.I \-a
+] [
+.I \-h
 .I hostname[:port]
-] [ -u
+] [
+.I \-u
 .I username
-] [ -x ] [
+] [
+.I \-x
+] [
 .I id
 ] [
 .I destination
 ] [
-.I destination-id
+.I destination\-id
 ]
 .SH DESCRIPTION
-\fIcancel\fR cancels existing print jobs. The \fI-a\fR option will remove
-all jobs from the specified destination.
+The \fBcancel\fR command cancels print jobs. If no \fIdestination\fR or \fIid\fR is specified, the currently printing job on the default destination is canceled.
 .SH OPTIONS
-The following options are recognized by \fIcancel\fR:
-.TP 5
--E
-.br
-Forces encryption when connecting to the server.
-.TP 5
--U username
-.br
-Specifies the username to use when connecting to the server.
+The following options are recognized by \fBcancel\fR:
 .TP 5
--a
-.br
+.B \-a
 Cancel all jobs on the named destination, or all jobs on all
 destinations if none is provided.
 .TP 5
--h hostname[:port]
-.br
-Chooses an alternate server.
+.B \-E
+Forces encryption when connecting to the server.
+.TP 5
+\fB\-h \fIhostname\fR[\fI:port\fR]
+Specifies an alternate server.
+.TP 5
+\fB\-U \fIusername\fR
+Specifies the username to use when connecting to the server.
 .TP 5
--u username
-.br
+\fB\-u \fIusername\fR
 Cancels jobs owned by \fIusername\fR.
 .TP 5
--x
-.br
+.B \-x
 Deletes job data files in addition to canceling.
-.SH COMPATIBILITY
-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.
+.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.
+.SH EXAMPLES
+Cancel the current print job:
+.nf
+
+    cancel
+
+.fi
+Cancel job "myprinter-42":
+.nf
+
+    cancel myprinter\-42
+
+.fi
+Cancel all jobs:
+.nf
+
+    cancel \-a
+.fi
 .SH NOTES
-Administrators wishing to prevent unauthorized cancellation of
-jobs via the \fI-u\fR option should require authentication for
-Cancel-Jobs operations in \fIcupsd.conf(5)\fR.
+Administrators wishing to prevent unauthorized cancellation of jobs via the \fI\-u\fR option should require authentication for Cancel-Jobs operations in
+.BR cupsd.conf (5).
 .SH SEE ALSO
-\fIlp(1)\fR, \fIlpmove(8)\fR, \fIlpstat(1)\fR,
-.br
-http://localhost:631/help
+.BR cupsd.conf (5),
+.BR lp (1),
+.BR lpmove (8),
+.BR lpstat (1),
+CUPS Online Help (http://localhost:631/help)
 .SH COPYRIGHT
-Copyright 2007-2013 by Apple Inc.
+Copyright \[co] 2007-2014 by Apple Inc.
 .\"
 .\" End of "$Id$".
 .\"