macro and text revision (-mdoc version 3)

[unix-history] / usr / src / usr.bin / uucp / uupoll / uupoll.8

diff --git a/usr/src/usr.bin/uucp/uupoll/uupoll.8 b/usr/src/usr.bin/uucp/uupoll/uupoll.8
index bd8f792..e67e948 100644 (file)
--- a/usr/src/usr.bin/uucp/uupoll/uupoll.8
+++ b/usr/src/usr.bin/uucp/uupoll/uupoll.8
@@ -1,75 +1,85 @@
-.\" Copyright (c) 1986 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1986, 1991 Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.\"    @(#)uupoll.8    6.4 (Berkeley) %G%
+.\" %sccs.include.redist.man%

 .\"
 .\"

-.TH UUPOLL 8 ""
-.UC 6
-.SH NAME
-uupoll \- poll a remote \s-1UUCP\s+1 site
-.SH SYNOPSIS
-.B uupoll
-[
-.BI \-g grade
-] [
-.B \-n
-]
-.I system
-.SH DESCRIPTION
-.I Uupoll
+.\"     @(#)uupoll.8   6.5 (Berkeley) %G%
+.\"
+.Dd 
+.Dt UUPOLL 8
+.Os BSD 4.3
+.Sh NAME
+.Nm uupoll
+.Nd poll a remote
+.Tn UUCP
+site
+.Sh SYNOPSIS
+.Nm uupoll
+.Op Fl g Ns Ar grade
+.Op Fl n
+.Ar system
+.Sh DESCRIPTION
+.Nm Uupoll

 is used to force a poll of a remote system. It queues a null job for the
 remote system and then invokes
 is used to force a poll of a remote system. It queues a null job for the
 remote system and then invokes

-.IR uucico (8).
-.PP
+.Xr uucico 8 .
+.Pp

 The following options are available:
 The following options are available:

-.TP 8
-.BI \-g grade
+.Bl -tag -width Fl
+.It Fl g Ns Ar grade

 Only send jobs of grade
 Only send jobs of grade

-.I grade
+.Ar grade

 or higher on this call.
 or higher on this call.

-.TP 8
-.B \-n
+.It Fl n

 Queue the null job, but do not invoke
 Queue the null job, but do not invoke

-.IR uucico .
-.PP
-.I Uupoll
+.Xr uucico .
+.El
+.Pp
+.Nm Uupoll

 is usually run by
 is usually run by

-.IR cron (5)
+.Xr cron 5

 or by a user who wants to hurry a job along. A typical entry in
 or by a user who wants to hurry a job along. A typical entry in

-.I crontab
+.Em crontab

 could be:
 could be:

-.PP
-.nf
-       0       0,8,16  *       *       *       daemon  /usr/bin/uupoll ihnp4
-       0       4,12,20 *       *       *       daemon  /usr/bin/uupoll ucbvax
-.fi
+.Bd -literal
+0    0,8,16     *    *    *    daemon    /usr/bin/uupoll ihnp4
+0    4,12,20    *    *    *    daemon    /usr/bin/uupoll ucbvax
+.Ed
+.Pp

 This will poll
 This will poll

-.B ihnp4
+.Em ihnp4

 at midnight, 0800, and 1600, and
 at midnight, 0800, and 1600, and

-.B ucbvax
+.Em ucbvax

 at 0400, noon, and 2000.
 at 0400, noon, and 2000.

-.PP
+.Pp

 If the local machine is already running
 If the local machine is already running

-.I uucico
+.Xr uucico

 every
 hour and has a limited number of outgoing modems, a more elegant approach
 might be:
 every
 hour and has a limited number of outgoing modems, a more elegant approach
 might be:

-.PP
-.nf
-       0       0,8,16  *       *       *       daemon  /usr/bin/uupoll -n ihnp4
-       0       4,12,20 *       *       *       daemon  /usr/bin/uupoll -n ucbvax
-       5               *       *       *       *       daemon  /usr/lib/uucp/uucico -r1
-.fi
+.Bd -literal
+0    0,8,16    *    *    *    daemon    /usr/bin/uupoll -n ihnp4
+0    4,12,20   *    *    *    daemon    /usr/bin/uupoll -n ucbvax
+5        *     *    *    *    daemon    /usr/lib/uucp/uucico -r1
+.Ed
+.Pp

 This will queue null jobs for the remote sites at the top of hour; they
 will be processed by
 This will queue null jobs for the remote sites at the top of hour; they
 will be processed by

-.I uucico
+.Xr uucico

 when it runs five minutes later.
 when it runs five minutes later.

-.SH FILES
-.ta \w'/var/spool/uucp/   'u
-.nf
-/usr/lib/uucp/ UUCP internal files/utilities
-/var/spool/uucp/       Spool directory
-.fi
-.SH SEE ALSO
-uucp(1), uux(1), uucico(8)
+.Sh FILES
+.Bl -tag -width /usr/lib/uucp/UUCP -compact
+.It Pa /usr/lib/uucp/UUCP
+internal files/utilities
+.It Pa /var/spool/uucp/
+Spool directory
+.El
+.Sh SEE ALSO
+.Xr uucp 1 ,
+.Xr uux 1 ,
+.Xr uucico 8
+.Sh HISTORY
+The
+.Nm
+command appeared in
+.Bx 4.3 .