X-Git-Url: https://git.subgeniuskitty.com/unix-history/.git/blobdiff_plain/d0719240aed7a84599ac73c71f78718b28341448..af359dea2e5ab3e937b62107ecd6a51d78189ed7:/usr/src/usr.sbin/lpr/lprm/lprm.1

diff --git a/usr/src/usr.sbin/lpr/lprm/lprm.1 b/usr/src/usr.sbin/lpr/lprm/lprm.1
index 8a2ab606b0..9149fb58f2 100644
--- a/usr/src/usr.sbin/lpr/lprm/lprm.1
+++ b/usr/src/usr.sbin/lpr/lprm/lprm.1
@@ -1,11 +1,37 @@
 .\" Copyright (c) 1983, 1990 The Regents of the University of California.
 .\" All rights reserved.
 .\"
-.\" %sccs.include.redist.man%
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"	This product includes software developed by the University of
+.\"	California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
 .\"
-.\"     @(#)lprm.1	6.6 (Berkeley) %G%
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
 .\"
-.Dd 
+.\"     @(#)lprm.1	6.7 (Berkeley) 5/9/91
+.\"
+.Dd May 9, 1991
 .Dt LPRM 1
 .Os BSD 4.2
 .Sh NAME
@@ -13,9 +39,7 @@
 .Nd remove jobs from the line printer spooling queue
 .Sh SYNOPSIS
 .Nm lprm
-.Oo
-.Op Fl P Ar printer
-.Oo
+.Op Fl P Ns Ar printer
 .Op Fl
 .Op job # ...
 .Op Ar user ...
@@ -31,14 +55,12 @@ and host name on the machine where the
 command was invoked.
 .Pp
 Options and arguments:
-.Tw Fl
-.Tc Fl P
-.Ar printer
-.Cx
+.Bl -tag -width indent
+.It Fl P Ns Ar printer
 Specify the queue associated with a specific
 .Ar printer
 (otherwise the default printer is used).
-.Tp Fl
+.It Fl
 If a single
 .Sq Fl
 is given,
@@ -46,29 +68,27 @@ is given,
 will remove all jobs which a user
 owns.  If the super-user employs this flag, the spool queue will
 be emptied entirely.
-.Tp Ar user
+.It Ar user
 Causes
 .Nm lprm
 to attempt to remove any jobs queued belonging to that user
 (or users).  This form of invoking
 .Nm lprm
 is useful only to the super-user.
-.Tp Ar job\ \&#
+.It Ar job\ \&#
 A user may dequeue an individual job by specifying its job number.
 This number may be obtained from the
-.Ar lpq  1
+.Xr lpq  1
 program, e.g.
 .Pp
-.Ds I
-.Cw \&a 1st:standard_input)
-.Cl \&% lpq \-l
+.Bd -literal -offset indent
+\&% lpq \-l
 
-.Cl 1st:ken\t\t[job #013ucbarpa]
-.Cl \t(standard input)	100 bytes
-.Cl % lprm 13
-.Cw
-.De
-.Tp
+1st:ken				[job #013ucbarpa]
+	(standard input)	100 bytes
+% lprm 13
+.Ed
+.El
 .Pp
 If neither arguments or options are given,
 .Nm Lprm
@@ -85,10 +105,10 @@ will kill off an active daemon, if necessary, before removing
 any spooling files.  If a daemon is killed, a new one is
 automatically restarted upon completion of file removals.
 .Sh ENVIRONMENT
-The following environment variable exists, it is utilized by
+If the following environment variable exists, it is utilized by
 .Nm lprm .
-.Tw Fl
-.Tp Ev PRINTER
+.Bl -tag -width PRINTER
+.It Ev PRINTER
 If the environment variable
 .Ev PRINTER
 exists,
@@ -97,18 +117,17 @@ and a printer has not been specified with the
 option,
 the default printer is assumed from 
 .Ev PRINTER .
-.Tp
+.El
 .Sh FILES
-.Dw /var/spool/*/lock/
-.Di L
-.Dp Pa /etc/printcap
-printer characteristics file
-.Dp Pa /var/spool/*
-spooling directories
-.Dp Pa /var/spool/*/lock
-lock file used to obtain the pid of the current
-daemon and the job number of the currently active job
-.Dp
+.Bl -tag -width /var/spool/*/lock/ -compact
+.It Pa /etc/printcap
+Printer characteristics file.
+.It Pa /var/spool/*
+Spooling directories.
+.It Pa /var/spool/*/lock
+Lock file used to obtain the pid of the current
+daemon and the job number of the currently active job.
+.El
 .Sh SEE ALSO
 .Xr lpr 1 ,
 .Xr lpq 1 ,
@@ -120,5 +139,7 @@ own.
 Since there are race conditions possible in the update of the lock file,
 the currently active job may be incorrectly identified.
 .Sh HISTORY
-.Nm Lprm
-appeared in 3 BSD.
+The
+.Nm lprm
+command appeared in
+.Bx 3.0 .