BSD 4_4_Lite2 release

[unix-history] / 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 962302d..c928843 100644 (file)
--- 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
 .Dt MAIL 1
 .Os BSD 4
 .Sh NAME


@@ -27,7 +53,7 @@
 .Op Fl u Ar user
 .Sh INTRODUCTION
 .Nm Mail
 .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.
 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
 .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
 .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
 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
 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
 .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,
 .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 \&?
 .It Ic help
 A synonym for
 .Ic \&?

+.ne 1i

 .It Ic hold
 .Pf ( Ic ho ,
 also
 .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
 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
 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.
 .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
 .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  .
 .Ic save
 or when automatically saving to
 .Ar mbox  .

+.pl +1

 .It Ic saveretain
 .Ic Saveretain
 is to
 .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.
 or
 .Ic retain
 command) are not included.

+.ne 1i

 .It Ic \&~F Ns Ar messages
 Identical to
 .Ic \&~f ,
 .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
 .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.
 .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 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
 .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 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
 .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,
 .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
 terminal.
 .El
 .Ss Option String Values


@@ -904,6 +954,7 @@ Pathname of the text editor to use in the
 command and
 .Ic \&~v
 escape.
 command and
 .Ic \&~v
 escape.

+.ne 1i

 .It Va crt
 The valued option
 .Va crt
 .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
 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.
 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 /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
 System initialization file.
 .El
 .Sh SEE ALSO