SCCS-vsn: usr.bin/msgs/msgs.1 6.8
SCCS-vsn: usr.bin/mesg/mesg.1 6.7
SCCS-vsn: old/machine/machine.1 5.5
.\" Copyright (c) 1980, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" Copyright (c) 1980, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
-.\" %sccs.include.redist.man%
+.\" %sccs.include.redist.roff%
-.\" @(#)machine.1 5.4 (Berkeley) %G%
+.\" @(#)machine.1 5.5 (Berkeley) %G%
.Sh NAME
.Nm machine
.Nd print machine type
.Sh SYNOPSIS
.Nm machine
.Sh DESCRIPTION
.Sh NAME
.Nm machine
.Nd print machine type
.Sh SYNOPSIS
.Nm machine
.Sh DESCRIPTION
-.Nm Machine
-prints out the machine type.
+The
+.Nm machine
+command displays the machine type.
+The
+.Nm machine
+command is
+.Ud .
.\" Copyright (c) 1987, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" Copyright (c) 1987, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
-.\" %sccs.include.redist.man%
+.\" %sccs.include.redist.roff%
-.\" @(#)mesg.1 6.6 (Berkeley) %G%
+.\" @(#)mesg.1 6.7 (Berkeley) %G%
.Dd
.Dt MESG 1
.Os
.Sh NAME
.Nm mesg
.Dd
.Dt MESG 1
.Os
.Sh NAME
.Nm mesg
-.Nd Display (do not display) messages from other users
+.Nd display (do not display) messages from other users
.Sh DESCRIPTION
The
.Nm mesg
.Sh DESCRIPTION
The
.Nm mesg
-utility allows a user to decide if other users may write
-messages to his or her screen. Programs such as
+utility is invoked by a user to control write access others have to
+her or his terminal. By default, write access is allowed, and
+programs such as
.Xr talk 1 ,
.Xr write 1
and
.Xr echo 1
.Xr talk 1 ,
.Xr write 1
and
.Xr echo 1
-are social and display a message on the target user's terminal.
-Sometimes this is inconvenient.
+may display messages on the target user's terminal.
-Options:
-.Tw Ds
-.Tp Cm n
-Disallow messages, providing peace, and informing the contacting
-party
+Options available:
+.Bl -tag -width flag
+.It Cm n
+Disallows messages and informs the
+sender
that `Your party is refusing messages'.
that `Your party is refusing messages'.
-.Tp Cm y
-Allow messages to be displayed.
-.Tp
+.It Cm y
+Allows messages to be displayed.
+.El
.Pp
If no arguments are given,
.Nm mesg
.Pp
If no arguments are given,
.Nm mesg
The
.Nm mesg
utility exits with one of the following values:
The
.Nm mesg
utility exits with one of the following values:
-.Dw Ds
-.Dp Li \&\ 0
-messages are allowed
-.Dp Li \&\ 1
-messages are not allowed
-.Dp Li \&\-\&1
+.Bl -tag -width flag -compact -offset indent
+.Pp
+.It Li "\ 0"
+Messages are allowed.
+.It Li "\ 1"
+Messages are not allowed.
+.It Li "\-1"
-.Dw /dev/[pt]ty[pq]?
-.Di L
-.Dp Pa /dev/[pt]ty[pq]?
-.Dp
+.Bl -tag -width /dev/[pt]ty[pq]? -compact
+.It Pa /dev/[pt]ty[pq]?
+.El
.Sh SEE ALSO
.Xr write 1 ,
.Xr talk 1 ,
.Sh SEE ALSO
.Xr write 1 ,
.Xr talk 1 ,
-command appeared in Version 6 AT&T Unix.
+command appeared in
+.At v6 .
.\" Copyright (c) 1980, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" Copyright (c) 1980, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
-.\" %sccs.include.redist.man%
+.\" %sccs.include.redist.roff%
-.\" @(#)msgs.1 6.7 (Berkeley) %G%
+.\" @(#)msgs.1 6.8 (Berkeley) %G%
.Pp
.Nm Msgs
is normally invoked each time you login, by placing it in the file
.Pp
.Nm Msgs
is normally invoked each time you login, by placing it in the file
if you use
.Xr sh 1 ) .
It will then prompt you with the source and subject of each new message.
if you use
.Xr sh 1 ) .
It will then prompt you with the source and subject of each new message.
If there is more to the message, you will be told how
long it is and asked whether you wish to see the rest of the message.
The possible responses are:
If there is more to the message, you will be told how
long it is and asked whether you wish to see the rest of the message.
The possible responses are:
-.Tw Fl
-.Tp Fl y
-type the rest of the message.
-.Tp Ic RETURN
-synonym for y.
-.Tp Fl n
-skip this message
+.Bl -tag -width Fl
+.It Fl y
+Type the rest of the message.
+.It Ic RETURN
+Synonym for y.
+.It Fl n
+Skip this message
and go on to the next message.
and go on to the next message.
-.Tp Fl
-redisplay the last message.
-.Tp Fl q
-drops you out of
+.It Fl
+Redisplay the last message.
+.It Fl q
+Drop out of
-the next time you run the program it will pick up where you left off.
-.Tp Fl s
-append the current message to the file ``Messages'' in the current directory;
+the next time
+.Nm msgs
+will pick up where it last left off.
+.It Fl s
+Append the current message to the file ``Messages'' in the current directory;
`s\-' will save the previously displayed message. A `s' or `s\-' may
be followed by a space and a file name to receive the message replacing
the default ``Messages''.
`s\-' will save the previously displayed message. A `s' or `s\-' may
be followed by a space and a file name to receive the message replacing
the default ``Messages''.
-.Tp Fl m
-or `m\-' causes a copy of the specified message to be placed in a temporary
+.It Fl m
+A copy of the specified message is placed in a temporary
-to be invoked on that mailbox.
+is invoked on that mailbox.
Both `m' and `s' accept a numeric argument in place of the `\-'.
Both `m' and `s' accept a numeric argument in place of the `\-'.
.Pp
.Nm Msgs
keeps track of the next message you will see by a number in the file
.Pp
.Nm Msgs
keeps track of the next message you will see by a number in the file
the default.
.Pp
Options when reading messages include:
the default.
.Pp
Options when reading messages include:
-.Tw Fl
-.Tp Fl f
-which causes it not to say ``No new messages.''.
-This is useful in your
-.Pa \& .login
+.Bl -tag -width Fl
+.It Fl f
+Do not to say ``No new messages.''.
+This is useful in a
+.Pa .login
file since this is often the case here.
file since this is often the case here.
Queries whether there are messages, printing
``There are new messages.'' if there are.
The command ``msgs \-q'' is often used in login scripts.
Queries whether there are messages, printing
``There are new messages.'' if there are.
The command ``msgs \-q'' is often used in login scripts.
-.Tp Fl h
-causes
-.Nm msgs
-to print the first part of messages only.
-.Tp Fl l
-option causes only locally originated messages to be reported.
-.Tp Ar num
+.It Fl h
+Print the first part of messages only.
+.It Fl l
+Option causes only locally originated messages to be reported.
+.It Ar num
A message number can be given
on the command line, causing
.Nm msgs
A message number can be given
on the command line, causing
.Nm msgs
.Dl msgs \-h 1
.Pp
prints the first part of all messages.
.Dl msgs \-h 1
.Pp
prints the first part of all messages.
-.Tp Ar \-number
-will cause
-.Nm msgs
-to start
-messages back from the one indicated by your
+messages back from the one indicated in the
.Pa \&.msgsrc
file, useful for reviews of recent messages.
.Pa \&.msgsrc
file, useful for reviews of recent messages.
-.Tp Fl p
-causes long messages to be piped through
+.It Fl p
+Pipe long messages through
environment variables for the default home directory and
terminal type.
.Sh FILES
environment variables for the default home directory and
terminal type.
.Sh FILES
-.Dw /usr/msgs/*
-.Di L
-.Dp Pa /usr/msgs/*
+.Bl -tag -width /usr/msgs/* -compact
+.It Pa /usr/msgs/*
number of next message to be presented
number of next message to be presented
-.Dp
-.Sh AUTHORS
-William Joy
-.br
-David Wasley
.Sh SEE ALSO
.Xr aliases 5 ,
.\".Xr crontab 5 ,
.Xr mail 1 ,
.Xr more 1
.Sh HISTORY
.Sh SEE ALSO
.Xr aliases 5 ,
.\".Xr crontab 5 ,
.Xr mail 1 ,
.Xr more 1
.Sh HISTORY
-.Nm Msgs
-appeared in 3 BSD.
-.Sh BUGS
+The
+.Nm msgs
+command appeared in
+.Bx 3.0 .