summaryrefslogtreecommitdiff
path: root/usr.sbin/lpr
diff options
context:
space:
mode:
authorAaron Campbell <aaron@cvs.openbsd.org>1999-06-05 01:29:41 +0000
committerAaron Campbell <aaron@cvs.openbsd.org>1999-06-05 01:29:41 +0000
commit6267016edabf294ae427e2066c9fe93d015f849b (patch)
treeb3c44c6071fcd5d121e63bd0b1fd6e5bc380b245 /usr.sbin/lpr
parent1805b94e6caa317d402e398fa06fa3d93d6827a0 (diff)
more .Os cleansing
Diffstat (limited to 'usr.sbin/lpr')
-rw-r--r--usr.sbin/lpr/lpq/lpq.134
-rw-r--r--usr.sbin/lpr/lpr/lpr.129
-rw-r--r--usr.sbin/lpr/lprm/lprm.132
-rw-r--r--usr.sbin/lpr/lptest/lptest.110
4 files changed, 58 insertions, 47 deletions
diff --git a/usr.sbin/lpr/lpq/lpq.1 b/usr.sbin/lpr/lpq/lpq.1
index 200f60d7fe1..c484a41e59c 100644
--- a/usr.sbin/lpr/lpq/lpq.1
+++ b/usr.sbin/lpr/lpq/lpq.1
@@ -33,7 +33,7 @@
.\"
.Dd April 28, 1995
.Dt LPQ 1
-.Os BSD 4.2
+.Os
.Sh NAME
.Nm lpq
.Nd spool queue examination program
@@ -42,15 +42,15 @@
.Op Fl a
.Op Fl l
.Op Fl P Ns Ar printer
-.Op job # ...
-.Op user ...
+.Op Ar job# Ar ...
+.Op Ar user Ar ...
.Sh DESCRIPTION
-.Nm Lpq
+.Nm lpq
examines the spooling area used by
.Xr lpd 8
for printing files on the line printer, and reports the status of the
specified jobs or all jobs associated with a user.
-.Nm Lpq
+.Nm lpq
invoked
without any arguments reports on any jobs currently in the queue.
.Pp
@@ -73,7 +73,7 @@ Report on the local queues for all printers,
rather than just the specified printer.
.El
.Pp
-For each job submitted (i.e. invocation of
+For each job submitted (i.e., invocation of
.Xr lpr 1 )
.Nm lpq
reports the user's name, current rank in the queue, the
@@ -85,16 +85,17 @@ Job ordering is dependent on
the algorithm used to scan the spooling directory and is supposed
to be
.Tn FIFO
-(First in First Out).
+(First In First Out).
File names comprising a job may be unavailable
(when
.Xr lpr 1
is used as a sink in a pipeline) in which case the file
-is indicated as ``(standard input)''.
+is indicated as
+.Dq (standard input) .
.Pp
If
.Nm lpq
-warns that there is no daemon present (i.e. due to some malfunction),
+warns that there is no daemon present (i.e., due to some malfunction),
the
.Xr lpc 8
command can be used to restart the printer daemon.
@@ -108,13 +109,13 @@ Specifies an alternate default printer.
.Sh FILES
.Bl -tag -width "/var/spool/*/lock" -compact
.It Pa /etc/printcap
-To determine printer characteristics.
+for determining printer characteristics
.It Pa /var/spool/*
-The spooling directory, as determined from printcap.
+spooling directory, as determined from printcap
.It Pa /var/spool/*/cf*
-Control files specifying jobs.
+control files specifying jobs
.It Pa /var/spool/*/lock
-The lock file to obtain the currently active job.
+lock file to obtain the currently active job
.El
.Sh SEE ALSO
.Xr lpr 1 ,
@@ -122,15 +123,16 @@ The lock file to obtain the currently active job.
.Xr lpc 8 ,
.Xr lpd 8
.Sh HISTORY
-.Nm Lpq
+.Nm lpq
appeared in
.Bx 3 .
.Sh BUGS
-Due to the dynamic nature of the information in the spooling directory
+Due to the dynamic nature of the information in the spooling directory,
.Nm lpq
may report unreliably.
Output formatting is sensitive to the line length of the terminal;
-this can results in widely spaced columns.
+this can result in widely spaced columns.
.Sh DIAGNOSTICS
Unable to open various files. The lock file being malformed. Garbage
files when there is no daemon active, but files in the spooling directory.
+
diff --git a/usr.sbin/lpr/lpr/lpr.1 b/usr.sbin/lpr/lpr/lpr.1
index 382d50886a9..82eee40ca59 100644
--- a/usr.sbin/lpr/lpr/lpr.1
+++ b/usr.sbin/lpr/lpr/lpr.1
@@ -33,7 +33,7 @@
.\"
.Dd June 6, 1993
.Dt LPR 1
-.Os BSD 4
+.Os
.Sh NAME
.Nm lpr
.Nd off line print
@@ -51,7 +51,7 @@
.Op Fl cdfghlnmprstv
.Op Ar name ...
.Sh DESCRIPTION
-.Nm Lpr
+.Nm lpr
uses a spooling daemon to print the named files when facilities
become available. If no names appear, the standard input is assumed.
.Pp
@@ -61,7 +61,7 @@ use the appropriate filters to print the data accordingly.
.Bl -tag -width indent
.It Fl c
The files are assumed to contain data produced by
-.Xr cifplot 1
+.Xr cifplot 1 .
.It Fl d
The files are assumed to contain data from
.Em tex
@@ -137,6 +137,7 @@ is the number of copies desired of each file named. For example,
.Bd -literal -offset indent
lpr \-#3 foo.c bar.c more.c
.Ed
+.Pp
would result in 3 copies of the file foo.c, followed by 3 copies
of the file bar.c, etc. On the other hand,
.Bd -literal -offset indent
@@ -180,7 +181,7 @@ instead of the file name.
.It Fl U Ar user
User name to print on the burst page,
also for accounting purposes.
-This option is only honored if the real user-id is daemon
+This option is only honored if the real user ID is daemon
(or that specified in the printcap file instead of daemon),
and is intended for those instances where print filters wish to requeue jobs.
.It Fl i Op numcols
@@ -205,19 +206,23 @@ Specifies an alternate default printer.
.Sh FILES
.Bl -tag -width /var/spool/output/*/tf* -compact
.It Pa /etc/passwd
-Personal identification.
+personal identification
.It Pa /etc/printcap
-Printer capabilities data base.
+printer capabilities database
.It Pa /usr/sbin/lpd*
-Line printer daemons.
+line printer daemons
.It Pa /var/spool/output/*
-Directories used for spooling.
+directories used for spooling
.It Pa /var/spool/output/*/cf*
-Daemon control files.
+daemon control files
.It Pa /var/spool/output/*/df*
-Data files specified in "cf" files.
+data files specified in
+.Dq cf
+files
.It Pa /var/spool/output/*/tf*
-Temporary copies of "cf" files.
+temporary copies of
+.Dq cf
+files
.El
.Sh SEE ALSO
.Xr lpq 1 ,
@@ -234,7 +239,7 @@ command appeared in
.Bx 3 .
.Sh DIAGNOSTICS
If you try to spool too large a file, it will be truncated.
-.Nm Lpr
+.Nm lpr
will object to printing binary files.
If a user other than root prints a file and spooling is disabled,
.Nm lpr
diff --git a/usr.sbin/lpr/lprm/lprm.1 b/usr.sbin/lpr/lprm/lprm.1
index ecdf3909e4e..e52ce2b1cfd 100644
--- a/usr.sbin/lpr/lprm/lprm.1
+++ b/usr.sbin/lpr/lprm/lprm.1
@@ -33,7 +33,7 @@
.\"
.Dd June 6, 1993
.Dt LPRM 1
-.Os BSD 4.2
+.Os
.Sh NAME
.Nm lprm
.Nd remove jobs from the line printer spooling queue
@@ -41,10 +41,10 @@
.Nm lprm
.Op Fl P Ns Ar printer
.Op Fl
-.Op job # ...
-.Op Ar user ...
+.Op Ar job# Ar ...
+.Op Ar user Ar ...
.Sh DESCRIPTION
-.Nm Lprm
+.Nm lprm
will remove a job, or jobs, from a printer's spool queue.
Since the spooling directory is protected from users, using
.Nm lprm
@@ -62,7 +62,7 @@ Specify the queue associated with a specific
(otherwise the default printer is used).
.It Fl
If a single
-.Sq Fl
+.Dq Fl
is given,
.Nm lprm
will remove all jobs which a user
@@ -91,22 +91,22 @@ program, e.g.
.El
.Pp
If neither arguments or options are given,
-.Nm Lprm
+.Nm lprm
will delete the currently active job if it is
owned by the user who invoked
.Nm lprm .
.Pp
-.Nm Lprm
+.Nm lprm
announces the names of any files it removes and is silent if
there are no jobs in the queue which match the request list.
.Pp
-.Nm Lprm
+.Nm lprm
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
If the following environment variable exists, it is utilized by
-.Nm lprm .
+.Nm lprm :
.Bl -tag -width PRINTER
.It Ev PRINTER
If the environment variable
@@ -121,20 +121,22 @@ the default printer is assumed from
.Sh FILES
.Bl -tag -width /var/spool/*/lock/ -compact
.It Pa /etc/printcap
-Printer characteristics file.
+printer characteristics file
.It Pa /var/spool/*
-Spooling directories.
+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.
+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 lpq 1 ,
.Xr lpr 1 ,
.Xr lpd 8
.Sh DIAGNOSTICS
-.Dq Permission denied
-if the user tries to remove files other than his own.
+.Bl -tag -width Ds
+.It Sy Permission denied
+Printed if the user tries to remove files other than his own.
+.El
.Sh BUGS
Since there are race conditions possible in the update of the lock file,
the currently active job may be incorrectly identified.
diff --git a/usr.sbin/lpr/lptest/lptest.1 b/usr.sbin/lpr/lptest/lptest.1
index 95b28f3525b..ca69df2fb73 100644
--- a/usr.sbin/lpr/lptest/lptest.1
+++ b/usr.sbin/lpr/lptest/lptest.1
@@ -33,7 +33,7 @@
.\"
.Dd December 30, 1993
.Dt LPTEST 1
-.Os BSD 4.3
+.Os
.Sh NAME
.Nm lptest
.Nd generate lineprinter ripple pattern
@@ -42,8 +42,10 @@
.Op Ar length
.Op Ar count
.Sh DESCRIPTION
-.Nm Lptest
-writes the traditional "ripple test" pattern on standard output.
+.Nm lptest
+writes the traditional
+.Dq ripple test
+pattern on standard output.
In 96 lines,
this pattern will print all 96 printable
.Tn ASCII
@@ -69,6 +71,6 @@ is to be specified,
.Ar length
must be also be specified.
.Sh HISTORY
-.Nm Lptest
+.Nm lptest
appeared in
.Bx 4.3 .