X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=man%2Fcupsenable.man;h=b6eb632a59718b239e087c518c307d5130818bf3;hb=d46dbe1ba7936f5892bf23bad8c8953246fd2572;hp=a466213fefa203601e9279b91d50775896c76f5d;hpb=75bd9771f6e44fdd887ee90faac46f403aefc0fc;p=thirdparty%2Fcups.git

diff --git a/man/cupsenable.man b/man/cupsenable.man
index a466213fe..b6eb632a5 100644
--- a/man/cupsenable.man
+++ b/man/cupsenable.man
@@ -1,84 +1,96 @@
 .\"
-.\" "$Id: cupsenable.man 7600 2008-05-20 21:06:23Z mike $"
+.\" cupsenable/cupsdisable man page for CUPS.
 .\"
-.\"   cupsenable/cupsdisable man page for the Common UNIX Printing System
-.\"   (CUPS).
+.\" Copyright 2007-2014 by Apple Inc.
+.\" Copyright 1997-2006 by Easy Software Products.
 .\"
-.\"   Copyright 2007 by Apple Inc.
-.\"   Copyright 1997-2006 by Easy Software Products.
+.\" Licensed under Apache License v2.0.  See the file "LICENSE" for more information.
 .\"
-.\"   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 cupsenable 8 "Common UNIX Printing System" "12 February 2006" "Apple Inc."
+.TH cupsenable 8 "CUPS" "11 June 2014" "Apple Inc."
 .SH NAME
 cupsdisable, cupsenable \- stop/start printers and classes
 .SH SYNOPSIS
 .B cupsdisable
-[ -E ] [-U
+[
+.B \-E
+] [
+.B \-U
 .I username
-] [ -c ] [ -h
-.I server[:port]
-] [ -r
+] [
+.B \-c
+] [
+\fB\-h \fIserver\fR[\fB:\fIport\fR]
+] [
+.B \-r
 .I reason
-] destination(s)
+] [
+.B \-\-hold
+]
+.I destination(s)
 .br
 .B cupsenable
-[ -E ] [-U
+[
+.B \-E
+] [
+.B \-U
 .I username
-] [ -c ] [ -h
-.I server[:port]
-] destination(s)
+] [
+.B \-c
+] [
+\fB\-h \fIserver\fR[\fB:\fIport\fR]
+] [
+.B \-\-release
+]
+.I destination(s)
 .SH DESCRIPTION
-\fIcupsenable\fR starts the named printers or classes.
-.LP
-\fIcupsdisable\fR stops the named printers or classes.  The
-following options may be used:
+.B cupsenable
+starts the named printers or classes while
+.B cupsdisable
+stops the named printers or classes.
+.SH OPTIONS
+The following options may be used:
 .TP 5
--E
-.br
+.B \-E
 Forces encryption of the connection to the server.
 .TP 5
--U username
-.br
+\fB\-U \fIusername\fR
 Uses the specified username when connecting to the server.
 .TP 5
--c
-.br
+.B \-c
 Cancels all jobs on the named destination.
 .TP 5
--h server[:port]
-.br
+\fB\-h \fIserver\fR[\fB:\fIport\fR]
 Uses the specified server and port.
 .TP 5
--r "reason"
-.br
-Sets the message associated with the stopped state. If no reason is specified
-then the message is set to "Reason Unknown".
-.SH COMPATIBILITY
-Unlike the System V printing system, CUPS allows printer names to
-contain any printable character except SPACE, TAB, "/", or "#".
+.B \-\-hold
+Holds remaining jobs on the named printer.
+Useful for allowing the current job to complete before performing maintenance.
+.TP 5
+\fB\-r "\fIreason\fB"\fR
+Sets the message associated with the stopped state.
+If no reason is specified then the message is set to "Reason Unknown".
+.TP 5
+.B \-\-release
+Releases pending jobs for printing.
+Use after running \fBcupsdisable\fR with the \fI\-\-hold\fR option to resume printing.
+.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.
 .LP
-The System V versions of these commands are \fIdisable\fR and
-\fIenable\fR. They have been renamed to avoid conflicts with the
-\fIbash(1)\fR build-in command of the same name.
+The System V versions of these commands are \fBdisable\fR and \fBenable\fR, respectively.
+They have been renamed to avoid conflicts with the
+.BR bash (1)
+build-in commands of the same names.
 .LP
-The CUPS versions of \fIdisable\fR and \fIenable\fR may ask the
-user for an access password depending on the printing system
-configuration.  This differs from the System V versions which
-require the root user to execute these commands.
+The CUPS versions of \fBdisable\fR and \fBenable\fR may ask the user for an access password depending on the printing system configuration.
+This differs from the System V versions which require the root user to execute these commands.
 .SH SEE ALSO
-\fIaccept(8)\fR, \fIcancel(1)\fR, \fIlp(1)\fR, \fIlpadmin(8)\fR,
-\fIlpstat(1)\fR,
-.br
-http://localhost:631/help
+.BR cupsaccept (8),
+.BR cupsreject (8),
+.BR cancel (1),
+.BR lp (1),
+.BR lpadmin (8),
+.BR lpstat (1),
+CUPS Online Help (http://localhost:631/help)
 .SH COPYRIGHT
-Copyright 2007 by Apple Inc.
-
-.\"
-.\" End of "$Id: cupsenable.man 7600 2008-05-20 21:06:23Z mike $".
-.\"
+Copyright \[co] 2007-2018 by Apple Inc.