summaryrefslogtreecommitdiffstats
path: root/usr.sbin/lpr
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2001-02-01 16:44:04 +0000
committerru <ru@FreeBSD.org>2001-02-01 16:44:04 +0000
commit66cd8f698eee895c4da383fadb4b96550cc19ccd (patch)
treeefb92661e8583b2bb0d620c324f4873ee0c94ab9 /usr.sbin/lpr
parent0b32553f8976489cd5ee11687f70c18b25edafec (diff)
downloadFreeBSD-src-66cd8f698eee895c4da383fadb4b96550cc19ccd.zip
FreeBSD-src-66cd8f698eee895c4da383fadb4b96550cc19ccd.tar.gz
mdoc(7) police: split punctuation characters + misc fixes.
Diffstat (limited to 'usr.sbin/lpr')
-rw-r--r--usr.sbin/lpr/lpc/lpc.877
-rw-r--r--usr.sbin/lpr/lpr/printcap.56
2 files changed, 57 insertions, 26 deletions
diff --git a/usr.sbin/lpr/lpc/lpc.8 b/usr.sbin/lpr/lpc/lpc.8
index e24d4b5..76782ba 100644
--- a/usr.sbin/lpr/lpc/lpc.8
+++ b/usr.sbin/lpr/lpc/lpc.8
@@ -40,10 +40,7 @@
.Nd line printer control program
.Sh SYNOPSIS
.Nm
-.Oo
-.Ar command
-.Op Ar argument ...
-.Oc
+.Op Ar command Op Ar argument ...
.Sh DESCRIPTION
.Nm Lpc
is used by the system administrator to control the
@@ -77,31 +74,44 @@ to read commands from file.
Commands may be abbreviated;
the following is the list of recognized commands.
.Pp
-.Bl -tag -width Ds -compact
-.It Ic \&? No [ command ... ]
-.It Ic help No [ command ... ]
+.Bl -tag -width indent -compact
+.It Ic \&? Op Ar command ...
+.It Ic help Op Ar command ...
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 No {\ all\ |\ printer\ }
+.It Ic abort Xo
+.Es \&{ \&}
+.En Cm all | Ar printer
+.Xc
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 No {\ all\ |\ printer\ }
+.It Ic clean Xo
+.Es \&{ \&}
+.En Cm all | Ar printer
+.Xc
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.
.Pp
-.It Ic disable No {\ all\ |\ printer\ }
+.It Ic disable Xo
+.Es \&{ \&}
+.En Cm all | Ar printer
+.Xc
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 No {\ all\ |\ printer\ } message ...
+.It Ic down Xo
+.Es \&{ \&}
+.En Cm all | Ar printer
+.Ar message ...
+.Xc
Turn the specified printer queue off, disable printing and put
-.Em message
+.Ar message
in the printer status file.
The message doesn't need to be quoted, the
remaining arguments are treated like
@@ -110,7 +120,10 @@ 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 No {\ all\ |\ printer\ }
+.It Ic enable Xo
+.Es \&{ \&}
+.En Cm all | Ar printer
+.Xc
Enable spooling on the local queue for the listed printers.
This will allow
.Xr lpr 1
@@ -118,32 +131,50 @@ to put new jobs in the spool queue.
.Pp
.It Ic exit
.It Ic quit
-Exit from lpc.
-.\" ne 1i
+Exit from
+.Nm .
.Pp
-.It Ic restart No {\ all\ |\ printer\ }
+.It Ic restart Xo
+.Es \&{ \&}
+.En Cm all | Ar printer
+.Xc
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
+.Xr lpq 1
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 No {\ all\ |\ printer\ }
+.It Ic start Xo
+.Es \&{ \&}
+.En Cm all | Ar printer
+.Xc
Enable printing and start a spooling daemon for the listed printers.
.Pp
-.It Ic status No {\ all\ |\ printer\ }
+.It Ic status Xo
+.Es \&{ \&}
+.En Cm all | Ar printer
+.Xc
Display the status of daemons and queues on the local machine.
.Pp
-.It Ic stop No {\ all\ |\ printer\ }
+.It Ic stop Xo
+.Es \&{ \&}
+.En Cm all | Ar printer
+.Xc
Stop a spooling daemon after the current job completes and disable
printing.
.Pp
-.It Ic topq No printer\ [\ jobnum\ ...\ ]\ [\ user\ ...\ ]
+.It Ic topq Ar printer Xo
+.Op Ar jobnum ...
+.Op Ar user ...
+.Xc
Place the jobs in the order listed at the top of the printer queue.
.Pp
-.It Ic up No {\ all\ |\ printer\ }
+.It Ic up Xo
+.Es \&{ \&}
+.En Cm all | Ar printer
+.Xc
Enable everything and start a new printer daemon.
Undoes the effects of
.Ic down .
@@ -164,7 +195,7 @@ lock file for queue control
.Xr printcap 5 ,
.Xr lpd 8
.Sh DIAGNOSTICS
-.Bl -tag -width Ds
+.Bl -tag -width indent
.It Sy "?Ambiguous command"
abbreviation matches more than one command
.It Sy "?Invalid command"
diff --git a/usr.sbin/lpr/lpr/printcap.5 b/usr.sbin/lpr/lpr/printcap.5
index 2533d45..5022ed1 100644
--- a/usr.sbin/lpr/lpr/printcap.5
+++ b/usr.sbin/lpr/lpr/printcap.5
@@ -93,9 +93,9 @@ format
.It "lf str" Ta Pa /dev/console Ta No "error logging file name"
.It "lo str" Ta Pa lock Ta No "name of lock file"
.It "lp str" Ta Pa /dev/lp Ta No "device name to open for output"
-.It "ms str" Ta Dv NULL Ta No "if lp is a tty, a comma-separated, "
-.Xr stty 1
--like list describing the tty modes
+.It "ms str" Ta Dv NULL Ta No "if lp is a tty, a comma-separated,"
+.Xr stty 1 Ns -like
+list describing the tty modes
.It "mx num 1000 maximum file size (in"
.Dv BUFSIZ
blocks), zero = unlimited
OpenPOWER on IntegriCloud