diff options
author | Ruslan Ermilov <ru@FreeBSD.org> | 2001-07-05 08:22:01 +0000 |
---|---|---|
committer | Ruslan Ermilov <ru@FreeBSD.org> | 2001-07-05 08:22:01 +0000 |
commit | 11bccf341ed5a0e755536e1340adf0296cefb970 (patch) | |
tree | 178b04863f6ebffad232dd05f4fd7fa4ba893c05 /usr.sbin/lpr | |
parent | 69c828c6bc868b85bd68d467b6dd8a30d678d4c9 (diff) | |
download | src-11bccf341ed5a0e755536e1340adf0296cefb970.tar.gz src-11bccf341ed5a0e755536e1340adf0296cefb970.zip |
mdoc(7) police: removed hard sentence breaks, use new .Brq macro.
Notes
Notes:
svn path=/head/; revision=79296
Diffstat (limited to 'usr.sbin/lpr')
-rw-r--r-- | usr.sbin/lpr/lpc/lpc.8 | 81 |
1 files changed, 27 insertions, 54 deletions
diff --git a/usr.sbin/lpr/lpc/lpc.8 b/usr.sbin/lpr/lpc/lpc.8 index ae1b6a6b53e6..7d041d20be6e 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 . |