More man page modernization.

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

diff --git a/doc/help/man-cancel.html b/doc/help/man-cancel.html
index b21860e03c183eb9b8c194773b8cd19c8fcba3a1..3c8bf29d04ce1f405f8d70952f6e8c024667afda 100644 (file)
--- a/doc/help/man-cancel.html
+++ b/doc/help/man-cancel.html
@@ -11,13 +11,22 @@
 cancel - cancel jobs
 <h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
 <b>cancel</b>
-[ -E ] [ -U
+[
+<i>-E</i>
+] [
+<i>-U</i>
 <i>username</i>
-] [ -a ] [ -h
+] [
+<i>-a</i>
+] [
+<i>-h</i>
 <i>hostname[:port]</i>
-] [ -u
+] [
+<i>-u</i>
 <i>username</i>
-] [ -x ] [
+] [
+<i>-x</i>
+] [
 <i>id</i>
 ] [
 <i>destination</i>
@@ -25,45 +34,55 @@ cancel - cancel jobs
 <i>destination-id</i>
 ]
 <h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<i>cancel</i> cancels existing print jobs. The <i>-a</i> option will remove
-all jobs from the specified destination.
+The <b>cancel</b> command cancels print jobs. If no <i>destination</i> or <i>id</i> is specified, the currently printing job on the default destination is canceled.
 <h2 class="title"><a name="OPTIONS">Options</a></h2>
-The following options are recognized by <i>cancel</i>:
+The following options are recognized by <b>cancel</b>:
 <dl class="man">
-<dt>-E
-<dd style="margin-left: 5.0em"><br>
-Forces encryption when connecting to the server.
-<dt>-U username
-<dd style="margin-left: 5.0em"><br>
-Specifies the username to use when connecting to the server.
-<dt>-a
-<dd style="margin-left: 5.0em"><br>
-Cancel all jobs on the named destination, or all jobs on all
+<dt><b>-a</b>
+<dd style="margin-left: 5.0em">Cancel all jobs on the named destination, or all jobs on all
 destinations if none is provided.
-<dt>-h hostname[:port]
-<dd style="margin-left: 5.0em"><br>
-Chooses an alternate server.
-<dt>-u username
-<dd style="margin-left: 5.0em"><br>
-Cancels jobs owned by <i>username</i>.
-<dt>-x
-<dd style="margin-left: 5.0em"><br>
-Deletes job data files in addition to canceling.
+<dt><b>-E</b>
+<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.
+<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>
+<dd style="margin-left: 5.0em">Cancels jobs owned by <i>username</i>.
+<dt><b>-x</b>
+<dd style="margin-left: 5.0em">Deletes job data files in addition to canceling.
 </dl>
-<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
-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 <i>not</i> case-sensitive.
+<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
+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 <i>not</i> case-sensitive.
+<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
+Cancel the current print job:
+<pre class="man">
+
+    cancel
+
+</pre>
+Cancel job "myprinter-42":
+<pre class="man">
+
+    cancel myprinter-42
+
+</pre>
+Cancel all jobs:
+<pre class="man">
+
+    cancel -a
+</pre>
 <h2 class="title"><a name="NOTES">Notes</a></h2>
-Administrators wishing to prevent unauthorized cancellation of
-jobs via the <i>-u</i> option should require authentication for
-Cancel-Jobs operations in <i>cupsd.conf(5)</i>.
+Administrators wishing to prevent unauthorized cancellation of jobs via the <i>-u</i> option should require authentication for Cancel-Jobs operations in
+<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5).</a>
 <h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<i>lp(1)</i>, <i>lpmove(8)</i>, <i>lpstat(1)</i>,
-<br>
-<a href="http://localhost:631/help">http://localhost:631/help</a>
+<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
+<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
+<a href="man-lpmove.html?TOPIC=Man+Pages"><b>lpmove</b>(8),</a>
+<a href="man-lpstat.html?TOPIC=Man+Pages"><b>lpstat</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-2013 by Apple Inc.
+Copyright &copy; 2007-2014 by Apple Inc.
 
 </body>
 </html>