macro and text revision (-mdoc version 3)

[unix-history] / usr / src / libexec / comsat / comsat.8

diff --git a/usr/src/libexec/comsat/comsat.8 b/usr/src/libexec/comsat/comsat.8
index 95f5c3f..3e05304 100644 (file)
--- a/usr/src/libexec/comsat/comsat.8
+++ b/usr/src/libexec/comsat/comsat.8
@@ -1,48 +1,70 @@
-.\" Copyright (c) 1983 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1983, 1991 The Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

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

 .\"
 .\"

-.TH COMSAT 8C "18 July 1983"
-.UC 5
-.SH NAME
-comsat \- biff server
-.SH SYNOPSIS
-.B /etc/comsat
-.SH DESCRIPTION
-.I Comsat
-is the server process which listens for reports of incoming mail
+.\"     @(#)comsat.8   6.5 (Berkeley) %G%
+.\"
+.Dd 
+.Dt COMSAT 8
+.Os BSD 4.2
+.Sh NAME
+.Nm comsat
+.Nd biff server
+.Sh SYNOPSIS
+.Nm comsat
+.Sh DESCRIPTION
+.Nm Comsat
+is the server process which receives reports of incoming mail

 and notifies users if they have requested this service.
 and notifies users if they have requested this service.

-.I Comsat
-listens on a datagram port associated with the ``biff'' service
+.Nm Comsat
+receives messages on a datagram port associated with the
+.Dq biff
+service

 specification (see
 specification (see

-.IR services (5))
-for one line messages of the form
-.PP
-.ti +0.5i
-user@mailbox-offset
-.PP
+.Xr services 5
+and
+.Xr inetd 8 ) .
+The one line messages are of the form:
+.Pp
+.Dl user@mailbox-offset
+.Pp

 If the
 If the

-.I user
+.Em user

 specified is logged in to the system and the associated terminal has
 specified is logged in to the system and the associated terminal has

-the owner execute bit turned on (by a ``biff y''), the
-.I offset
+the owner execute bit turned on (by a
+.Dq Li biff y ) ,
+the
+.Em offset

 is used as a seek offset into the appropriate mailbox file and
 the first 7 lines or 560 characters of the message are printed
 on the user's terminal.  Lines which appear to be part of
 is used as a seek offset into the appropriate mailbox file and
 the first 7 lines or 560 characters of the message are printed
 on the user's terminal.  Lines which appear to be part of

-the message header other than the ``From'', ``To'', ``Date'',
-or ``Subject'' lines are not included in the displayed message.
-.SH FILES
-.DT
-/etc/utmp      to find out who's logged on and on what terminals
-.SH "SEE ALSO"
-biff(1)
-.SH BUGS
+the message header other than the
+.Dq From ,
+.Dq \&To ,
+.Dq Date ,
+or
+.Dq Subject
+lines are not included in the displayed message.
+.Sh FILES
+.Bl -tag -width /var/run/utmp -compact
+.It Pa /var/run/utmp
+to find out who's logged on and on what terminals
+.El
+.Sh SEE ALSO
+.Xr biff 1 ,
+.Xr inetd 8
+.Sh BUGS

 The message header filtering is prone to error.
 The message header filtering is prone to error.

-.PP
+The density of the information presented is near the theoretical minimum.
+.Pp

 Users should be notified of mail which arrives on other
 Users should be notified of mail which arrives on other

-machines than the one they are currently logged in to.
-.PP
+machines than the one to which they are currently logged in.
+.Pp

 The notification should appear in a separate window so it
 does not mess up the screen.
 The notification should appear in a separate window so it
 does not mess up the screen.

+.Sh HISTORY
+The
+.Nm
+command appeared in
+.Bx 4.2 .