BSD 4_3_Net_2 release

[unix-history] / usr / src / usr.bin / msgs / msgs.1

diff --git a/usr/src/usr.bin/msgs/msgs.1 b/usr/src/usr.bin/msgs/msgs.1
index 1328a32..0daa964 100644 (file)
--- a/usr/src/usr.bin/msgs/msgs.1
+++ b/usr/src/usr.bin/msgs/msgs.1
@@ -1,13 +1,37 @@
 .\" 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%
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.

 .\"
 .\"

-.\"     @(#)msgs.1     6.7 (Berkeley) %G%
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.

 .\"
 .\"

-.Vx
-.Vx
-.Dd 
+.\"    @(#)msgs.1      6.9 (Berkeley) 7/30/91
+.\"
+.Dd July 30, 1991

 .Dt MSGS 1
 .Os BSD 4
 .Sh NAME
 .Dt MSGS 1
 .Os BSD 4
 .Sh NAME


@@ -18,10 +42,8 @@
 .Op Fl fhlpq
 .Op Ar number
 .Op Ar \-number
 .Op Fl fhlpq
 .Op Ar number
 .Op Ar \-number

-.Pp

 .Nm msgs
 .Op Fl s
 .Nm msgs
 .Op Fl s

-.Pp

 .Nm msgs
 .Op Fl c
 .Op \-days
 .Nm msgs
 .Op Fl c
 .Op \-days


@@ -35,9 +57,9 @@ of the system.
 .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

-.Pa \& .login
+.Pa .login

 (or
 (or

-.Pa \&.profile
+.Pa .profile

 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.


@@ -46,32 +68,34 @@ message will be displayed.
 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

 .Nm msgs ;
 .Nm msgs ;

-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

 mailbox and
 .Xr mail  1
 mailbox and
 .Xr mail  1

-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 `\-'.

-.Tp
+.El

 .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


@@ -120,23 +144,21 @@ A different expiration may be specified on the command line to override
 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.

-.Tp Fl q
+.It Fl q

 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


@@ -149,18 +171,16 @@ Thus
 .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
+.It Ar \-number
+Start

 .Ar number
 .Ar number

-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

 .Xr more  1  .
 .Xr more  1  .

-.Tp
+.El

 .Pp
 Within
 .Nm msgs
 .Pp
 Within
 .Nm msgs


@@ -176,23 +196,19 @@ and
 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/*

 database
 database

-.Dp ~/.msgsrc
+.It ~/.msgsrc

 number of next message to be presented
 number of next message to be presented

-.Dp
-.Sh AUTHORS
-William Joy
-.br
-David Wasley
+.El

 .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 .