diff options
author | Aaron Campbell <aaron@cvs.openbsd.org> | 1999-06-05 01:29:41 +0000 |
---|---|---|
committer | Aaron Campbell <aaron@cvs.openbsd.org> | 1999-06-05 01:29:41 +0000 |
commit | 6267016edabf294ae427e2066c9fe93d015f849b (patch) | |
tree | b3c44c6071fcd5d121e63bd0b1fd6e5bc380b245 /usr.sbin/lpr | |
parent | 1805b94e6caa317d402e398fa06fa3d93d6827a0 (diff) |
more .Os cleansing
Diffstat (limited to 'usr.sbin/lpr')
-rw-r--r-- | usr.sbin/lpr/lpq/lpq.1 | 34 | ||||
-rw-r--r-- | usr.sbin/lpr/lpr/lpr.1 | 29 | ||||
-rw-r--r-- | usr.sbin/lpr/lprm/lprm.1 | 32 | ||||
-rw-r--r-- | usr.sbin/lpr/lptest/lptest.1 | 10 |
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 . |