Add support for "inc" command and "autoinc" variable.

[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 24c16d4..fe1c4f6 100644 (file)
--- a/usr/src/usr.bin/mail/mail.1
+++ b/usr/src/usr.bin/mail/mail.1
@@ -1,9 +1,9 @@
-.\" 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%
 .\"
 .\"
 .\" %sccs.include.redist.roff%
 .\"

-.\"    @(#)mail.1      6.19 (Berkeley) %G%
+.\"    @(#)mail.1      8.5 (Berkeley) %G%

 .\"
 .Dd 
 .Dt MAIL 1
 .\"
 .Dd 
 .Dt MAIL 1


@@ -27,7 +27,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 +36,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 +52,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


@@ -420,6 +420,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 +434,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 +450,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 +566,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 +694,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 +779,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


@@ -852,6 +869,10 @@ and
 commands.
 .It Ar quiet
 Suppresses the printing of the version when first invoked.
 commands.
 .It Ar quiet
 Suppresses the printing of the version when first invoked.

+.It Ar searchheaders
+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.

 .It Ar verbose
 Setting the option
 .Ar verbose
 .It Ar verbose
 Setting the option
 .Ar verbose


@@ -859,7 +880,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


@@ -900,6 +921,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


@@ -961,11 +983,14 @@ Post office.
 User's old mail.
 .It ~/.mailrc
 File giving initial mail commands.
 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