summaryrefslogtreecommitdiffstats
path: root/usr.sbin/lpr
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2001-07-05 08:22:01 +0000
committerru <ru@FreeBSD.org>2001-07-05 08:22:01 +0000
commit262a8126f08da3e33df7f30558d7d8862196c579 (patch)
tree178b04863f6ebffad232dd05f4fd7fa4ba893c05 /usr.sbin/lpr
parent62daf61425fb633804f8526484144b1ba9ec5f3d (diff)
downloadFreeBSD-src-262a8126f08da3e33df7f30558d7d8862196c579.zip
FreeBSD-src-262a8126f08da3e33df7f30558d7d8862196c579.tar.gz
mdoc(7) police: removed hard sentence breaks, use new .Brq macro.
Diffstat (limited to 'usr.sbin/lpr')
-rw-r--r--usr.sbin/lpr/lpc/lpc.881
1 files changed, 27 insertions, 54 deletions
diff --git a/usr.sbin/lpr/lpc/lpc.8 b/usr.sbin/lpr/lpc/lpc.8
index ae1b6a6..7d041d2 100644
--- a/usr.sbin/lpr/lpc/lpc.8
+++ b/usr.sbin/lpr/lpc/lpc.8
@@ -34,7 +34,7 @@
.\"
.Dd June 20, 2001
.Dt LPC 8
-.Os BSD 4.2
+.Os
.Sh NAME
.Nm lpc
.Nd line printer control program
@@ -44,7 +44,7 @@
.Sh DESCRIPTION
.Nm Lpc
is used by the system administrator to control the
-operation of the line printer system.
+operation of the line printer system.
For each line printer configured in
.Pa /etc/printcap ,
.Nm
@@ -67,7 +67,8 @@ will prompt for commands from the standard input.
If arguments are supplied,
.Nm
interprets the first argument as a command and the remaining
-arguments as parameters to the command. The standard input
+arguments as parameters to the command.
+The standard input
may be redirected causing
.Nm
to read commands from file.
@@ -80,41 +81,34 @@ the following is the list of recognized commands.
Print a short description of each command specified in the argument list,
or, if no argument is given, a list of the recognized commands.
.Pp
-.It Ic abort Xo
-.Es \&{ \&}
-.En Cm all | Ar printer
-.Xc
+.It Ic abort Brq Cm all | Ar printer
Terminate an active spooling daemon on the local host immediately and
then disable printing (preventing new daemons from being started by
.Xr lpr 1 )
for the specified printers.
.Pp
-.It Ic clean Xo
-.Es \&{ \&}
-.En Cm all | Ar printer
-.Xc
+.It Ic clean Brq Cm all | Ar printer
Remove any temporary files, data files, and control files that cannot
be printed (i.e., do not form a complete printer job)
from the specified printer queue(s) on the local machine.
-This command will also look for 'core' files in spool directory
+This command will also look for
+.Pa core
+files in spool directory
for each printer queue, and list any that are found.
-It will not remove any 'core' files. See also the
+It will not remove any
+.Pa core
+files.
+See also the
.Ic tclean
command.
.Pp
-.It Ic disable Xo
-.Es \&{ \&}
-.En Cm all | Ar printer
-.Xc
-Turn the specified printer queues off. This prevents new
+.It Ic disable Brq Cm all | Ar printer
+Turn the specified printer queues off.
+This prevents new
printer jobs from being entered into the queue by
.Xr lpr 1 .
.Pp
-.It Ic down Xo
-.Es \&{ \&}
-.En Cm all | Ar printer
-.Ar message ...
-.Xc
+.It Ic down Bro Cm all | Ar printer Brc Ar message ...
Turn the specified printer queue off, disable printing and put
.Ar message
in the printer status file.
@@ -125,11 +119,8 @@ This is normally used to take a printer down and let others know why
.Xr lpq 1
will indicate the printer is down and print the status message).
.Pp
-.It Ic enable Xo
-.Es \&{ \&}
-.En Cm all | Ar printer
-.Xc
-Enable spooling on the local queue for the listed printers.
+.It Ic enable Brq Cm all | Ar printer
+Enable spooling on the local queue for the listed printers.
This will allow
.Xr lpr 1
to put new jobs in the spool queue.
@@ -139,41 +130,26 @@ to put new jobs in the spool queue.
Exit from
.Nm .
.Pp
-.It Ic restart Xo
-.Es \&{ \&}
-.En Cm all | Ar printer
-.Xc
-Attempt to start a new printer daemon.
+.It Ic restart Brq Cm all | Ar printer
+Attempt to start a new printer daemon.
This is useful when some abnormal condition causes the daemon to
die unexpectedly, leaving jobs in the queue.
.Xr lpq 1
-will report that there is no daemon present when this condition occurs.
+will report that there is no daemon present when this condition occurs.
If the user is the super-user,
try to abort the current daemon first (i.e., kill and restart a stuck daemon).
.Pp
-.It Ic start Xo
-.Es \&{ \&}
-.En Cm all | Ar printer
-.Xc
+.It Ic start Brq Cm all | Ar printer
Enable printing and start a spooling daemon for the listed printers.
.Pp
-.It Ic status Xo
-.Es \&{ \&}
-.En Cm all | Ar printer
-.Xc
+.It Ic status Brq Cm all | Ar printer
Display the status of daemons and queues on the local machine.
.Pp
-.It Ic stop Xo
-.Es \&{ \&}
-.En Cm all | Ar printer
-.Xc
+.It Ic stop Brq Cm all | Ar printer
Stop a spooling daemon after the current job completes and disable
printing.
.Pp
-.It Ic tclean Xo
-.Es \&{ \&}
-.En Cm all | Ar printer
-.Xc
+.It Ic tclean Brq Cm all | Ar printer
This will do a test-run of the
.Ic clean
command.
@@ -194,10 +170,7 @@ command is not restricted.
.Xc
Place the jobs in the order listed at the top of the printer queue.
.Pp
-.It Ic up Xo
-.Es \&{ \&}
-.En Cm all | Ar printer
-.Xc
+.It Ic up Brq Cm all | Ar printer
Enable everything and start a new printer daemon.
Undoes the effects of
.Ic down .
OpenPOWER on IntegriCloud