X-Git-Url: https://git.subgeniuskitty.com/unix-history/.git/blobdiff_plain/c2e1b7e66797c59f3922aac8e396d724e565cacd..fd88f5c5678c80ff5e338adc372d28a52ad20530:/usr/src/usr.bin/mail/mail.1

diff --git a/usr/src/usr.bin/mail/mail.1 b/usr/src/usr.bin/mail/mail.1
index 962302dc4d..c928843a5e 100644
--- a/usr/src/usr.bin/mail/mail.1
+++ b/usr/src/usr.bin/mail/mail.1
@@ -1,11 +1,37 @@
-.\" Copyright (c) 1980, 1990 The Regents of the University of California.
-.\" All rights reserved.
+.\" Copyright (c) 1980, 1990, 1993
+.\"	The Regents of the University of California.  All rights reserved.
 .\"
-.\" %sccs.include.redist.roff%
+.\" 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.
 .\"
-.\"	@(#)mail.1	6.20 (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.
 .\"
-.Dd 
+.\"	@(#)mail.1	8.8 (Berkeley) 4/28/95
+.\"
+.Dd April 28, 1995
 .Dt MAIL 1
 .Os BSD 4
 .Sh NAME
@@ -27,7 +53,7 @@
 .Op Fl u Ar user
 .Sh INTRODUCTION
 .Nm Mail
-is a intelligent mail processing system, which has
+is an intelligent mail processing system, which has
 a command syntax reminiscent of
 .Xr \&ed 1
 with lines replaced by messages.
@@ -36,7 +62,7 @@ with lines replaced by messages.
 .It Fl v
 Verbose mode.
 The details of
-delivery are displayed on the users terminal.
+delivery are displayed on the user's terminal.
 .It Fl i
 Ignore tty interrupt signals.
 This is
@@ -52,7 +78,7 @@ special
 character when sending mail is only active in interactive mode.
 .It Fl n
 Inhibits reading
-.Pa /usr/share/misc/Mail.rc
+.Pa /etc/mail.rc
 upon startup.
 .It Fl N
 Inhibits the initial display of message headers
@@ -82,7 +108,7 @@ writes undeleted messages back to this file.
 .It Fl u
 Is equivalent to:
 .Pp
-.Dl mail -f /var/spool/mail/user
+.Dl mail -f /var/mail/user
 .El
 .Ss Sending mail
 To send a message to one or more people,
@@ -420,6 +446,7 @@ argument is given, the previous 18\-message group is printed.
 .It Ic help
 A synonym for
 .Ic \&?
+.ne 1i
 .It Ic hold
 .Pf ( Ic ho ,
 also
@@ -433,7 +460,7 @@ Does not override the
 command.
 .It Ic ignore
 Add the list of header fields named to the
-.Ar ignored list
+.Ar ignored list .
 Header fields in the ignore list are not printed
 on your terminal when you print a message.
 This
@@ -449,6 +476,13 @@ If
 .Ic ignore
 is executed with no arguments, it lists the current set of
 ignored fields.
+.It Ic inc
+Incorporate any new messages that have arrived while mail
+is being read.
+The new messages are added to the end of the message list,
+and the current message is reset to be the first new mail message.
+This does not renumber the existing message list, nor does
+does it cause any changes made so far to be saved.
 .It Ic mail
 .Pq Ic m
 Takes as argument login names and distribution group names and sends
@@ -558,6 +592,7 @@ saving a message by
 .Ic save
 or when automatically saving to
 .Ar mbox  .
+.pl +1
 .It Ic saveretain
 .Ic Saveretain
 is to
@@ -685,6 +720,7 @@ Message headers currently being ignored (by the
 or
 .Ic retain
 command) are not included.
+.ne 1i
 .It Ic \&~F Ns Ar messages
 Identical to
 .Ic \&~f ,
@@ -769,18 +805,25 @@ Causes messages saved in
 .Ar mbox
 to be appended to the end rather than prepended.
 This should always be set (perhaps in
-.Pa /usr/share/misc/Mail.rc ) .
+.Pa /etc/mail.rc ) .
 .It Ar ask
 Causes
 .Nm mail
 to prompt you for the subject of each message you send.
 If
 you respond with simply a newline, no subject field will be sent.
+.ne 1i
 .It Ar askcc
 Causes you to be prompted for additional carbon copy recipients at the
 end of each message.
 Responding with a newline indicates your
 satisfaction with the current list.
+.It Ar autoinc
+Causes new mail to be automatically incorporated when it arrives.
+Setting this is similar to issuing the
+.Ic inc
+command at each prompt, except that the current message is not
+reset when new mail arrives.
 .It Ar autoprint
 Causes the
 .Ic delete
@@ -856,6 +899,13 @@ Suppresses the printing of the version when first invoked.
 If this option is set, then a message-list specifier in the form ``/x:y''
 will expand to all messages containing the substring ``y'' in the header
 field ``x''.  The string search is case insensitive.
+If ``x'' is ommitted, it will default to the ``Subject'' header field.
+The form ``/to:y'' is a special case, and will expand
+to all messages containing the substring ``y'' in the ``To'', ``Cc''
+or ``Bcc'' header fields.
+The check for "to" is case sensitive, so that
+``/To:y'' can be used to limit the search for ``y'' to just
+the ``To:'' field.
 .It Ar verbose
 Setting the option
 .Ar verbose
@@ -863,7 +913,7 @@ is the same as using the
 .Fl v
 flag on the command line.
 When mail runs in verbose mode,
-the actual delivery of messages is displayed on he users
+the actual delivery of messages is displayed on the user's
 terminal.
 .El
 .Ss Option String Values
@@ -904,6 +954,7 @@ Pathname of the text editor to use in the
 command and
 .Ic \&~v
 escape.
+.ne 1i
 .It Va crt
 The valued option
 .Va crt
@@ -959,17 +1010,20 @@ and
 environment variables.
 .Sh FILES
 .Bl -tag -width /usr/share/misc/Mail.help* -compact
-.It Pa /var/spool/mail/*
+.It Pa /var/mail/*
 Post office.
 .It ~/mbox
 User's old mail.
 .It ~/.mailrc
 File giving initial mail commands.
+This can be overridden by setting the
+.Ev MAILRC
+environment variable.
 .It Pa /tmp/R*
 Temporary files.
 .It Pa /usr/share/misc/Mail.help*
 Help files.
-.It Pa /usr/share/misc/Mail.rc
+.It Pa /etc/mail.rc
 System initialization file.
 .El
 .Sh SEE ALSO