xref: /freebsd/usr.bin/mail/mail.1 (revision 9b50d9027575220cb6dd09b3e62f03f511e908b8)
19b50d902SRodney W. Grimes.\" Copyright (c) 1980, 1990, 1993
29b50d902SRodney W. Grimes.\"	The Regents of the University of California.  All rights reserved.
39b50d902SRodney W. Grimes.\"
49b50d902SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without
59b50d902SRodney W. Grimes.\" modification, are permitted provided that the following conditions
69b50d902SRodney W. Grimes.\" are met:
79b50d902SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright
89b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer.
99b50d902SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright
109b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer in the
119b50d902SRodney W. Grimes.\"    documentation and/or other materials provided with the distribution.
129b50d902SRodney W. Grimes.\" 3. All advertising materials mentioning features or use of this software
139b50d902SRodney W. Grimes.\"    must display the following acknowledgement:
149b50d902SRodney W. Grimes.\"	This product includes software developed by the University of
159b50d902SRodney W. Grimes.\"	California, Berkeley and its contributors.
169b50d902SRodney W. Grimes.\" 4. Neither the name of the University nor the names of its contributors
179b50d902SRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
189b50d902SRodney W. Grimes.\"    without specific prior written permission.
199b50d902SRodney W. Grimes.\"
209b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
219b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
229b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
239b50d902SRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
249b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
259b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
269b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
279b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
289b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
299b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
309b50d902SRodney W. Grimes.\" SUCH DAMAGE.
319b50d902SRodney W. Grimes.\"
329b50d902SRodney W. Grimes.\"	@(#)mail.1	8.2 (Berkeley) 12/30/93
339b50d902SRodney W. Grimes.\"
349b50d902SRodney W. Grimes.Dd December 30, 1993
359b50d902SRodney W. Grimes.Dt MAIL 1
369b50d902SRodney W. Grimes.Os BSD 4
379b50d902SRodney W. Grimes.Sh NAME
389b50d902SRodney W. Grimes.Nm mail
399b50d902SRodney W. Grimes.Nd send and receive mail
409b50d902SRodney W. Grimes.Sh SYNOPSIS
419b50d902SRodney W. Grimes.Nm mail
429b50d902SRodney W. Grimes.Op Fl iInv
439b50d902SRodney W. Grimes.Op Fl s Ar subject
449b50d902SRodney W. Grimes.Op Fl c Ar cc-addr
459b50d902SRodney W. Grimes.Op Fl b Ar bcc-addr
469b50d902SRodney W. Grimes.Ar to-addr...
479b50d902SRodney W. Grimes.Nm mail
489b50d902SRodney W. Grimes.Op Fl iInNv
499b50d902SRodney W. Grimes.Fl f
509b50d902SRodney W. Grimes.Op Ar name
519b50d902SRodney W. Grimes.Nm mail
529b50d902SRodney W. Grimes.Op Fl iInNv
539b50d902SRodney W. Grimes.Op Fl u Ar user
549b50d902SRodney W. Grimes.Sh INTRODUCTION
559b50d902SRodney W. Grimes.Nm Mail
569b50d902SRodney W. Grimesis an intelligent mail processing system, which has
579b50d902SRodney W. Grimesa command syntax reminiscent of
589b50d902SRodney W. Grimes.Xr \&ed 1
599b50d902SRodney W. Grimeswith lines replaced by messages.
609b50d902SRodney W. Grimes.Pp
619b50d902SRodney W. Grimes.Bl -tag -width flag
629b50d902SRodney W. Grimes.It Fl v
639b50d902SRodney W. GrimesVerbose mode.
649b50d902SRodney W. GrimesThe details of
659b50d902SRodney W. Grimesdelivery are displayed on the user's terminal.
669b50d902SRodney W. Grimes.It Fl i
679b50d902SRodney W. GrimesIgnore tty interrupt signals.
689b50d902SRodney W. GrimesThis is
699b50d902SRodney W. Grimesparticularly useful when using
709b50d902SRodney W. Grimes.Nm mail
719b50d902SRodney W. Grimeson noisy phone lines.
729b50d902SRodney W. Grimes.It Fl I
739b50d902SRodney W. GrimesForces mail to run in interactive mode even when
749b50d902SRodney W. Grimesinput isn't a terminal.
759b50d902SRodney W. GrimesIn particular, the
769b50d902SRodney W. Grimes.Sq Ic \&~
779b50d902SRodney W. Grimesspecial
789b50d902SRodney W. Grimescharacter when sending mail is only active in interactive mode.
799b50d902SRodney W. Grimes.It Fl n
809b50d902SRodney W. GrimesInhibits reading
819b50d902SRodney W. Grimes.Pa /usr/share/misc/Mail.rc
829b50d902SRodney W. Grimesupon startup.
839b50d902SRodney W. Grimes.It Fl N
849b50d902SRodney W. GrimesInhibits the initial display of message headers
859b50d902SRodney W. Grimeswhen reading mail or editing a mail folder.
869b50d902SRodney W. Grimes.It Fl s
879b50d902SRodney W. GrimesSpecify subject on command line
889b50d902SRodney W. Grimes(only the first argument after the
899b50d902SRodney W. Grimes.Fl s
909b50d902SRodney W. Grimesflag is used as a subject; be careful to quote subjects
919b50d902SRodney W. Grimescontaining spaces.)
929b50d902SRodney W. Grimes.It Fl c
939b50d902SRodney W. GrimesSend carbon copies to
949b50d902SRodney W. Grimes.Ar list
959b50d902SRodney W. Grimesof users.
969b50d902SRodney W. Grimes.It Fl b
979b50d902SRodney W. GrimesSend blind carbon copies to
989b50d902SRodney W. Grimes.Ar list .
999b50d902SRodney W. GrimesList should be a comma-separated list of names.
1009b50d902SRodney W. Grimes.It Fl f
1019b50d902SRodney W. GrimesRead in the contents of your
1029b50d902SRodney W. Grimes.Ar mbox
1039b50d902SRodney W. Grimes(or the specified file)
1049b50d902SRodney W. Grimesfor processing; when you
1059b50d902SRodney W. Grimes.Ar quit  ,
1069b50d902SRodney W. Grimes.Nm mail
1079b50d902SRodney W. Grimeswrites undeleted messages back to this file.
1089b50d902SRodney W. Grimes.It Fl u
1099b50d902SRodney W. GrimesIs equivalent to:
1109b50d902SRodney W. Grimes.Pp
1119b50d902SRodney W. Grimes.Dl mail -f /var/spool/mail/user
1129b50d902SRodney W. Grimes.El
1139b50d902SRodney W. Grimes.Ss Sending mail
1149b50d902SRodney W. GrimesTo send a message to one or more people,
1159b50d902SRodney W. Grimes.Nm mail
1169b50d902SRodney W. Grimescan be invoked with arguments which are the names of people to
1179b50d902SRodney W. Grimeswhom the mail will be sent.
1189b50d902SRodney W. GrimesYou are then expected to type in
1199b50d902SRodney W. Grimesyour message, followed
1209b50d902SRodney W. Grimesby an
1219b50d902SRodney W. Grimes.Sq Li control\-D
1229b50d902SRodney W. Grimesat the beginning of a line.
1239b50d902SRodney W. GrimesThe section below
1249b50d902SRodney W. Grimes.Ar Replying to or originating mail ,
1259b50d902SRodney W. Grimesdescribes some features of
1269b50d902SRodney W. Grimes.Nm mail
1279b50d902SRodney W. Grimesavailable to help you compose your letter.
1289b50d902SRodney W. Grimes.Pp
1299b50d902SRodney W. Grimes.Ss Reading mail
1309b50d902SRodney W. GrimesIn normal usage
1319b50d902SRodney W. Grimes.Nm mail
1329b50d902SRodney W. Grimesis given no arguments and checks your mail out of the
1339b50d902SRodney W. Grimespost office, then
1349b50d902SRodney W. Grimesprints out a one line header of each message found.
1359b50d902SRodney W. GrimesThe current message is initially the first message (numbered 1)
1369b50d902SRodney W. Grimesand can be printed using the
1379b50d902SRodney W. Grimes.Ic print
1389b50d902SRodney W. Grimescommand (which can be abbreviated
1399b50d902SRodney W. Grimes.Ql Ic p ) .
1409b50d902SRodney W. GrimesYou can move among the messages much as you move between lines in
1419b50d902SRodney W. Grimes.Xr \&ed 1 ,
1429b50d902SRodney W. Grimeswith the commands
1439b50d902SRodney W. Grimes.Ql Ic \&+
1449b50d902SRodney W. Grimesand
1459b50d902SRodney W. Grimes.Ql Ic \&\-
1469b50d902SRodney W. Grimesmoving backwards and forwards, and
1479b50d902SRodney W. Grimessimple numbers.
1489b50d902SRodney W. Grimes.Pp
1499b50d902SRodney W. Grimes.Ss Disposing of mail.
1509b50d902SRodney W. GrimesAfter examining a message you can
1519b50d902SRodney W. Grimes.Ic delete
1529b50d902SRodney W. Grimes.Ql Ic d )
1539b50d902SRodney W. Grimesthe message or
1549b50d902SRodney W. Grimes.Ic reply
1559b50d902SRodney W. Grimes.Ql Ic r )
1569b50d902SRodney W. Grimesto it.
1579b50d902SRodney W. GrimesDeletion causes the
1589b50d902SRodney W. Grimes.Nm mail
1599b50d902SRodney W. Grimesprogram to forget about the message.
1609b50d902SRodney W. GrimesThis is not irreversible; the message can be
1619b50d902SRodney W. Grimes.Ic undeleted
1629b50d902SRodney W. Grimes.Ql Ic u )
1639b50d902SRodney W. Grimesby giving its number, or the
1649b50d902SRodney W. Grimes.Nm mail
1659b50d902SRodney W. Grimessession can be aborted by giving the
1669b50d902SRodney W. Grimes.Ic exit
1679b50d902SRodney W. Grimes.Ql Ic x )
1689b50d902SRodney W. Grimescommand.
1699b50d902SRodney W. GrimesDeleted messages will, however, usually disappear never to be seen again.
1709b50d902SRodney W. Grimes.Pp
1719b50d902SRodney W. Grimes.Ss Specifying messages
1729b50d902SRodney W. GrimesCommands such as
1739b50d902SRodney W. Grimes.Ic print
1749b50d902SRodney W. Grimesand
1759b50d902SRodney W. Grimes.Ic delete
1769b50d902SRodney W. Grimescan be given a list of message numbers as arguments to apply
1779b50d902SRodney W. Grimesto a number of messages at once.
1789b50d902SRodney W. GrimesThus
1799b50d902SRodney W. Grimes.Dq Li delete 1 2
1809b50d902SRodney W. Grimesdeletes messages 1 and 2, while
1819b50d902SRodney W. Grimes.Dq Li delete 1\-5
1829b50d902SRodney W. Grimesdeletes messages 1 through 5.
1839b50d902SRodney W. GrimesThe special name
1849b50d902SRodney W. Grimes.Ql Li \&*
1859b50d902SRodney W. Grimesaddresses all messages, and
1869b50d902SRodney W. Grimes.Ql Li \&$
1879b50d902SRodney W. Grimesaddresses
1889b50d902SRodney W. Grimesthe last message; thus the command
1899b50d902SRodney W. Grimes.Ic top
1909b50d902SRodney W. Grimeswhich prints the first few lines of a message could be used in
1919b50d902SRodney W. Grimes.Dq Li top \&*
1929b50d902SRodney W. Grimesto print the first few lines of all messages.
1939b50d902SRodney W. Grimes.Pp
1949b50d902SRodney W. Grimes.Ss Replying to or originating mail.
1959b50d902SRodney W. GrimesYou can use the
1969b50d902SRodney W. Grimes.Ic reply
1979b50d902SRodney W. Grimescommand to
1989b50d902SRodney W. Grimesset up a response to a message, sending it back to the
1999b50d902SRodney W. Grimesperson who it was from.
2009b50d902SRodney W. GrimesText you then type in, up to an end-of-file,
2019b50d902SRodney W. Grimesdefines the contents of the message.
2029b50d902SRodney W. GrimesWhile you are composing a message,
2039b50d902SRodney W. Grimes.Nm mail
2049b50d902SRodney W. Grimestreats lines beginning with the character
2059b50d902SRodney W. Grimes.Ql Ic \&~
2069b50d902SRodney W. Grimesspecially.
2079b50d902SRodney W. GrimesFor instance, typing
2089b50d902SRodney W. Grimes.Ql Ic \&~m
2099b50d902SRodney W. Grimes(alone on a line) will place a copy
2109b50d902SRodney W. Grimesof the current message into the response right shifting it by a tabstop
2119b50d902SRodney W. Grimes(see
2129b50d902SRodney W. Grimes.Em indentprefix
2139b50d902SRodney W. Grimesvariable, below).
2149b50d902SRodney W. GrimesOther escapes will set up subject fields, add and delete recipients
2159b50d902SRodney W. Grimesto the message and allow you to escape to an editor to revise the
2169b50d902SRodney W. Grimesmessage or to a shell to run some commands.
2179b50d902SRodney W. Grimes(These options
2189b50d902SRodney W. Grimesare given in the summary below.)
2199b50d902SRodney W. Grimes.Pp
2209b50d902SRodney W. Grimes.Ss Ending a mail processing session.
2219b50d902SRodney W. GrimesYou can end a
2229b50d902SRodney W. Grimes.Nm mail
2239b50d902SRodney W. Grimessession with the
2249b50d902SRodney W. Grimes.Ic quit
2259b50d902SRodney W. Grimes.Ql Ic q )
2269b50d902SRodney W. Grimescommand.
2279b50d902SRodney W. GrimesMessages which have been examined go to your
2289b50d902SRodney W. Grimes.Ar mbox
2299b50d902SRodney W. Grimesfile unless they have been deleted in which case they are discarded.
2309b50d902SRodney W. GrimesUnexamined messages go back to the post office.
2319b50d902SRodney W. Grimes(See the
2329b50d902SRodney W. Grimes.Fl f
2339b50d902SRodney W. Grimesoption above).
2349b50d902SRodney W. Grimes.Pp
2359b50d902SRodney W. Grimes.Ss Personal and systemwide distribution lists.
2369b50d902SRodney W. GrimesIt is also possible to create a personal distribution lists so that,
2379b50d902SRodney W. Grimesfor instance, you can send mail to
2389b50d902SRodney W. Grimes.Dq Li cohorts
2399b50d902SRodney W. Grimesand have it go
2409b50d902SRodney W. Grimesto a group of people.
2419b50d902SRodney W. GrimesSuch lists can be defined by placing a line like
2429b50d902SRodney W. Grimes.Pp
2439b50d902SRodney W. Grimes.Dl alias cohorts bill ozalp jkf mark kridle@ucbcory
2449b50d902SRodney W. Grimes.Pp
2459b50d902SRodney W. Grimesin the file
2469b50d902SRodney W. Grimes.Pa \&.mailrc
2479b50d902SRodney W. Grimesin your home directory.
2489b50d902SRodney W. GrimesThe current list of such aliases can be displayed with the
2499b50d902SRodney W. Grimes.Ic alias
2509b50d902SRodney W. Grimescommand in
2519b50d902SRodney W. Grimes.Nm mail  .
2529b50d902SRodney W. GrimesSystem wide distribution lists can be created by editing
2539b50d902SRodney W. Grimes.Pa /etc/aliases ,
2549b50d902SRodney W. Grimessee
2559b50d902SRodney W. Grimes.Xr aliases  5
2569b50d902SRodney W. Grimesand
2579b50d902SRodney W. Grimes.Xr sendmail  8  ;
2589b50d902SRodney W. Grimesthese are kept in a different syntax.
2599b50d902SRodney W. GrimesIn mail you send, personal aliases will be expanded in mail sent
2609b50d902SRodney W. Grimesto others so that they will be able to
2619b50d902SRodney W. Grimes.Ic reply
2629b50d902SRodney W. Grimesto the recipients.
2639b50d902SRodney W. GrimesSystem wide
2649b50d902SRodney W. Grimes.Ic aliases
2659b50d902SRodney W. Grimesare not expanded when the mail is sent,
2669b50d902SRodney W. Grimesbut any reply returned to the machine will have the system wide
2679b50d902SRodney W. Grimesalias expanded as all mail goes through
2689b50d902SRodney W. Grimes.Xr sendmail  .
2699b50d902SRodney W. Grimes.Pp
2709b50d902SRodney W. Grimes.Ss Network mail (ARPA, UUCP, Berknet)
2719b50d902SRodney W. GrimesSee
2729b50d902SRodney W. Grimes.Xr mailaddr 7
2739b50d902SRodney W. Grimesfor a description of network addresses.
2749b50d902SRodney W. Grimes.Pp
2759b50d902SRodney W. Grimes.Nm Mail
2769b50d902SRodney W. Grimeshas a number of options which can be set in the
2779b50d902SRodney W. Grimes.Pa .mailrc
2789b50d902SRodney W. Grimesfile to alter its behavior; thus
2799b50d902SRodney W. Grimes.Dq Li set askcc
2809b50d902SRodney W. Grimesenables the
2819b50d902SRodney W. Grimes.Ar askcc
2829b50d902SRodney W. Grimesfeature.
2839b50d902SRodney W. Grimes(These options are summarized below.)
2849b50d902SRodney W. Grimes.Sh SUMMARY
2859b50d902SRodney W. Grimes(Adapted from the `Mail Reference Manual')
2869b50d902SRodney W. Grimes.Pp
2879b50d902SRodney W. GrimesEach command is typed on a line by itself, and may take arguments
2889b50d902SRodney W. Grimesfollowing the command word.
2899b50d902SRodney W. GrimesThe command need not be typed in its
2909b50d902SRodney W. Grimesentirety \- the first command which matches the typed prefix is used.
2919b50d902SRodney W. GrimesFor commands which take message lists as arguments, if no message
2929b50d902SRodney W. Grimeslist is given, then the next message forward which satisfies the
2939b50d902SRodney W. Grimescommand's requirements is used.
2949b50d902SRodney W. GrimesIf there are no messages forward of
2959b50d902SRodney W. Grimesthe current message, the search proceeds backwards, and if there are no
2969b50d902SRodney W. Grimesgood messages at all,
2979b50d902SRodney W. Grimes.Nm mail
2989b50d902SRodney W. Grimestypes
2999b50d902SRodney W. Grimes.Dq Li No applicable messages
3009b50d902SRodney W. Grimesand
3019b50d902SRodney W. Grimesaborts the command.
3029b50d902SRodney W. Grimes.Bl -tag -width delete
3039b50d902SRodney W. Grimes.It Ic \&\-
3049b50d902SRodney W. GrimesPrint out the preceding message.
3059b50d902SRodney W. GrimesIf given a numeric
3069b50d902SRodney W. Grimesargument
3079b50d902SRodney W. Grimes.Ar n  ,
3089b50d902SRodney W. Grimesgoes to the
3099b50d902SRodney W. Grimes.Ar n Ns 'th
3109b50d902SRodney W. Grimesprevious message and prints it.
3119b50d902SRodney W. Grimes.It Ic \&?
3129b50d902SRodney W. GrimesPrints a brief summary of commands.
3139b50d902SRodney W. Grimes.It Ic \&!
3149b50d902SRodney W. GrimesExecutes the shell
3159b50d902SRodney W. Grimes(see
3169b50d902SRodney W. Grimes.Xr sh 1
3179b50d902SRodney W. Grimesand
3189b50d902SRodney W. Grimes.Xr csh 1 )
3199b50d902SRodney W. Grimescommand which follows.
3209b50d902SRodney W. Grimes.It Ic Print
3219b50d902SRodney W. Grimes.Pq Ic P
3229b50d902SRodney W. GrimesLike
3239b50d902SRodney W. Grimes.Ic print
3249b50d902SRodney W. Grimesbut also prints out ignored header fields.
3259b50d902SRodney W. GrimesSee also
3269b50d902SRodney W. Grimes.Ic print ,
3279b50d902SRodney W. Grimes.Ic ignore
3289b50d902SRodney W. Grimesand
3299b50d902SRodney W. Grimes.Ic retain .
3309b50d902SRodney W. Grimes.It Ic Reply
3319b50d902SRodney W. Grimes.Pq Ic R
3329b50d902SRodney W. GrimesReply to originator.
3339b50d902SRodney W. GrimesDoes not reply to other
3349b50d902SRodney W. Grimesrecipients of the original message.
3359b50d902SRodney W. Grimes.It Ic Type
3369b50d902SRodney W. Grimes.Pq Ic T
3379b50d902SRodney W. GrimesIdentical to the
3389b50d902SRodney W. Grimes.Ic Print
3399b50d902SRodney W. Grimescommand.
3409b50d902SRodney W. Grimes.It Ic alias
3419b50d902SRodney W. Grimes.Pq Ic a
3429b50d902SRodney W. GrimesWith no arguments, prints out all currently-defined aliases.
3439b50d902SRodney W. GrimesWith one
3449b50d902SRodney W. Grimesargument, prints out that alias.
3459b50d902SRodney W. GrimesWith more than one argument, creates
3469b50d902SRodney W. Grimesa new alias or changes an old one.
3479b50d902SRodney W. Grimes.It Ic alternates
3489b50d902SRodney W. Grimes.Pq Ic alt
3499b50d902SRodney W. GrimesThe
3509b50d902SRodney W. Grimes.Ic alternates
3519b50d902SRodney W. Grimescommand is useful if you have accounts on several machines.
3529b50d902SRodney W. GrimesIt can be used to inform
3539b50d902SRodney W. Grimes.Nm mail
3549b50d902SRodney W. Grimesthat the listed addresses are really you.
3559b50d902SRodney W. GrimesWhen you
3569b50d902SRodney W. Grimes.Ic reply
3579b50d902SRodney W. Grimesto messages,
3589b50d902SRodney W. Grimes.Nm mail
3599b50d902SRodney W. Grimeswill not send a copy of the message to any of the addresses
3609b50d902SRodney W. Grimeslisted on the
3619b50d902SRodney W. Grimes.Ic alternates
3629b50d902SRodney W. Grimeslist.
3639b50d902SRodney W. GrimesIf the
3649b50d902SRodney W. Grimes.Ic alternates
3659b50d902SRodney W. Grimescommand is given with no argument, the current set of alternate
3669b50d902SRodney W. Grimesnames is displayed.
3679b50d902SRodney W. Grimes.It Ic chdir
3689b50d902SRodney W. Grimes.Pq Ic c
3699b50d902SRodney W. GrimesChanges the user's working directory to that specified, if given.
3709b50d902SRodney W. GrimesIf
3719b50d902SRodney W. Grimesno directory is given, then changes to the user's login directory.
3729b50d902SRodney W. Grimes.It Ic copy
3739b50d902SRodney W. Grimes.Pq Ic co
3749b50d902SRodney W. GrimesThe
3759b50d902SRodney W. Grimes.Ic copy
3769b50d902SRodney W. Grimescommand does the same thing that
3779b50d902SRodney W. Grimes.Ic save
3789b50d902SRodney W. Grimesdoes, except that it does not mark the messages it
3799b50d902SRodney W. Grimesis used on for deletion when you quit.
3809b50d902SRodney W. Grimes.It Ic delete
3819b50d902SRodney W. Grimes.Pq Ic d
3829b50d902SRodney W. GrimesTakes a list of messages as argument and marks them all as deleted.
3839b50d902SRodney W. GrimesDeleted messages will not be saved in
3849b50d902SRodney W. Grimes.Ar mbox  ,
3859b50d902SRodney W. Grimesnor will they be available for most other commands.
3869b50d902SRodney W. Grimes.It Ic dp
3879b50d902SRodney W. Grimes(also
3889b50d902SRodney W. Grimes.Ic dt )
3899b50d902SRodney W. GrimesDeletes the current message and prints the next message.
3909b50d902SRodney W. GrimesIf there is no next message,
3919b50d902SRodney W. Grimes.Nm mail
3929b50d902SRodney W. Grimessays
3939b50d902SRodney W. Grimes.Dq Li "at EOF" .
3949b50d902SRodney W. Grimes.It Ic edit
3959b50d902SRodney W. Grimes.Pq Ic e
3969b50d902SRodney W. GrimesTakes a list of messages and points the text editor at each one in
3979b50d902SRodney W. Grimesturn.
3989b50d902SRodney W. GrimesOn return from the editor, the message is read back in.
3999b50d902SRodney W. Grimes.It Ic exit
4009b50d902SRodney W. Grimes.Pf ( Ic ex
4019b50d902SRodney W. Grimesor
4029b50d902SRodney W. Grimes.Ic x )
4039b50d902SRodney W. GrimesEffects an immediate return to the Shell without
4049b50d902SRodney W. Grimesmodifying the user's system mailbox, his
4059b50d902SRodney W. Grimes.Ar mbox
4069b50d902SRodney W. Grimesfile, or his edit file in
4079b50d902SRodney W. Grimes.Fl f  .
4089b50d902SRodney W. Grimes.It Ic file
4099b50d902SRodney W. Grimes.Pq Ic fi
4109b50d902SRodney W. GrimesThe same as
4119b50d902SRodney W. Grimes.Ic folder  .
4129b50d902SRodney W. Grimes.It Ic folders
4139b50d902SRodney W. GrimesList the names of the folders in your folder directory.
4149b50d902SRodney W. Grimes.It Ic folder
4159b50d902SRodney W. Grimes.Pq Ic fo
4169b50d902SRodney W. GrimesThe
4179b50d902SRodney W. Grimes.Ic folder
4189b50d902SRodney W. Grimescommand switches to a new mail file or folder.
4199b50d902SRodney W. GrimesWith no
4209b50d902SRodney W. Grimesarguments, it tells you which file you are currently reading.
4219b50d902SRodney W. GrimesIf you give it an argument, it will write out changes (such
4229b50d902SRodney W. Grimesas deletions) you have made in the current file and read in
4239b50d902SRodney W. Grimesthe new file.
4249b50d902SRodney W. GrimesSome special conventions are recognized for
4259b50d902SRodney W. Grimesthe name.
4269b50d902SRodney W. Grimes# means the previous file, % means your system
4279b50d902SRodney W. Grimesmailbox, %user means user's system mailbox, & means
4289b50d902SRodney W. Grimesyour
4299b50d902SRodney W. Grimes.Ar mbox
4309b50d902SRodney W. Grimesfile, and
4319b50d902SRodney W. Grimes\&+\&folder means a file in your folder
4329b50d902SRodney W. Grimesdirectory.
4339b50d902SRodney W. Grimes.It Ic from
4349b50d902SRodney W. Grimes.Pq Ic f
4359b50d902SRodney W. GrimesTakes a list of messages and prints their message headers.
4369b50d902SRodney W. Grimes.It Ic headers
4379b50d902SRodney W. Grimes.Pq Ic h
4389b50d902SRodney W. GrimesLists the current range of headers, which is an 18\-message group.
4399b50d902SRodney W. GrimesIf
4409b50d902SRodney W. Grimesa
4419b50d902SRodney W. Grimes.Ql \&+
4429b50d902SRodney W. Grimesargument is given, then the next 18\-message group is printed, and if
4439b50d902SRodney W. Grimesa
4449b50d902SRodney W. Grimes.Ql \&\-
4459b50d902SRodney W. Grimesargument is given, the previous 18\-message group is printed.
4469b50d902SRodney W. Grimes.It Ic help
4479b50d902SRodney W. GrimesA synonym for
4489b50d902SRodney W. Grimes.Ic \&?
4499b50d902SRodney W. Grimes.It Ic hold
4509b50d902SRodney W. Grimes.Pf ( Ic ho ,
4519b50d902SRodney W. Grimesalso
4529b50d902SRodney W. Grimes.Ic preserve )
4539b50d902SRodney W. GrimesTakes a message list and marks each
4549b50d902SRodney W. Grimesmessage therein to be saved in the
4559b50d902SRodney W. Grimesuser's system mailbox instead of in
4569b50d902SRodney W. Grimes.Ar mbox  .
4579b50d902SRodney W. GrimesDoes not override the
4589b50d902SRodney W. Grimes.Ic delete
4599b50d902SRodney W. Grimescommand.
4609b50d902SRodney W. Grimes.It Ic ignore
4619b50d902SRodney W. GrimesAdd the list of header fields named to the
4629b50d902SRodney W. Grimes.Ar ignored list .
4639b50d902SRodney W. GrimesHeader fields in the ignore list are not printed
4649b50d902SRodney W. Grimeson your terminal when you print a message.
4659b50d902SRodney W. GrimesThis
4669b50d902SRodney W. Grimescommand is very handy for suppression of certain machine-generated
4679b50d902SRodney W. Grimesheader fields.
4689b50d902SRodney W. GrimesThe
4699b50d902SRodney W. Grimes.Ic Type
4709b50d902SRodney W. Grimesand
4719b50d902SRodney W. Grimes.Ic Print
4729b50d902SRodney W. Grimescommands can be used to print a message in its entirety, including
4739b50d902SRodney W. Grimesignored fields.
4749b50d902SRodney W. GrimesIf
4759b50d902SRodney W. Grimes.Ic ignore
4769b50d902SRodney W. Grimesis executed with no arguments, it lists the current set of
4779b50d902SRodney W. Grimesignored fields.
4789b50d902SRodney W. Grimes.It Ic mail
4799b50d902SRodney W. Grimes.Pq Ic m
4809b50d902SRodney W. GrimesTakes as argument login names and distribution group names and sends
4819b50d902SRodney W. Grimesmail to those people.
4829b50d902SRodney W. Grimes.It Ic mbox
4839b50d902SRodney W. GrimesIndicate that a list of messages be sent to
4849b50d902SRodney W. Grimes.Ic mbox
4859b50d902SRodney W. Grimesin your home directory when you quit.
4869b50d902SRodney W. GrimesThis is the default
4879b50d902SRodney W. Grimesaction for messages if you do
4889b50d902SRodney W. Grimes.Em not
4899b50d902SRodney W. Grimeshave the
4909b50d902SRodney W. Grimes.Ic hold
4919b50d902SRodney W. Grimesoption set.
4929b50d902SRodney W. Grimes.It Ic next
4939b50d902SRodney W. Grimes.Pq Ic n
4949b50d902SRodney W. Grimeslike
4959b50d902SRodney W. Grimes.Ic \&+
4969b50d902SRodney W. Grimesor
4979b50d902SRodney W. Grimes.Tn CR )
4989b50d902SRodney W. GrimesGoes to the next message in sequence and types it.
4999b50d902SRodney W. GrimesWith an argument list, types the next matching message.
5009b50d902SRodney W. Grimes.It Ic preserve
5019b50d902SRodney W. Grimes.Pq Ic pre
5029b50d902SRodney W. GrimesA synonym for
5039b50d902SRodney W. Grimes.Ic hold  .
5049b50d902SRodney W. Grimes.It Ic print
5059b50d902SRodney W. Grimes.Pq Ic p
5069b50d902SRodney W. GrimesTakes a message list and types out each message on the user's terminal.
5079b50d902SRodney W. Grimes.It Ic quit
5089b50d902SRodney W. Grimes.Pq Ic q
5099b50d902SRodney W. GrimesTerminates the session, saving all undeleted, unsaved messages in
5109b50d902SRodney W. Grimesthe user's
5119b50d902SRodney W. Grimes.Ar mbox
5129b50d902SRodney W. Grimesfile in his login directory, preserving all messages marked with
5139b50d902SRodney W. Grimes.Ic hold
5149b50d902SRodney W. Grimesor
5159b50d902SRodney W. Grimes.Ic preserve
5169b50d902SRodney W. Grimesor never referenced
5179b50d902SRodney W. Grimesin his system mailbox, and removing all other messages from his system
5189b50d902SRodney W. Grimesmailbox.
5199b50d902SRodney W. GrimesIf new mail has arrived during the session, the message
5209b50d902SRodney W. Grimes.Dq Li "You have new mail"
5219b50d902SRodney W. Grimesis given.
5229b50d902SRodney W. GrimesIf given while editing a
5239b50d902SRodney W. Grimesmailbox file with the
5249b50d902SRodney W. Grimes.Fl f
5259b50d902SRodney W. Grimesflag, then the edit file is rewritten.
5269b50d902SRodney W. GrimesA return to the Shell is
5279b50d902SRodney W. Grimeseffected, unless the rewrite of edit file fails, in which case the user
5289b50d902SRodney W. Grimescan escape with the
5299b50d902SRodney W. Grimes.Ic exit
5309b50d902SRodney W. Grimescommand.
5319b50d902SRodney W. Grimes.It Ic reply
5329b50d902SRodney W. Grimes.Pq Ic r
5339b50d902SRodney W. GrimesTakes a message list and sends mail to the sender and all
5349b50d902SRodney W. Grimesrecipients of the specified message.
5359b50d902SRodney W. GrimesThe default message must not be deleted.
5369b50d902SRodney W. Grimes.It Ic respond
5379b50d902SRodney W. GrimesA synonym for
5389b50d902SRodney W. Grimes.Ic reply  .
5399b50d902SRodney W. Grimes.It Ic retain
5409b50d902SRodney W. GrimesAdd the list of header fields named to the
5419b50d902SRodney W. Grimes.Ar retained list
5429b50d902SRodney W. GrimesOnly the header fields in the retain list
5439b50d902SRodney W. Grimesare shown on your terminal when you print a message.
5449b50d902SRodney W. GrimesAll other header fields are suppressed.
5459b50d902SRodney W. GrimesThe
5469b50d902SRodney W. Grimes.Ic Type
5479b50d902SRodney W. Grimesand
5489b50d902SRodney W. Grimes.Ic Print
5499b50d902SRodney W. Grimescommands can be used to print a message in its entirety.
5509b50d902SRodney W. GrimesIf
5519b50d902SRodney W. Grimes.Ic retain
5529b50d902SRodney W. Grimesis executed with no arguments, it lists the current set of
5539b50d902SRodney W. Grimesretained fields.
5549b50d902SRodney W. Grimes.It Ic save
5559b50d902SRodney W. Grimes.Pq Ic s
5569b50d902SRodney W. GrimesTakes a message list and a filename and appends each message in
5579b50d902SRodney W. Grimesturn to the end of the file.
5589b50d902SRodney W. GrimesThe filename in quotes, followed by the line
5599b50d902SRodney W. Grimescount and character count is echoed on the user's terminal.
5609b50d902SRodney W. Grimes.It Ic set
5619b50d902SRodney W. Grimes.Pq Ic se
5629b50d902SRodney W. GrimesWith no arguments, prints all variable values.
5639b50d902SRodney W. GrimesOtherwise, sets
5649b50d902SRodney W. Grimesoption.
5659b50d902SRodney W. GrimesArguments are of the form
5669b50d902SRodney W. Grimes.Ar option=value
5679b50d902SRodney W. Grimes(no space before or after =) or
5689b50d902SRodney W. Grimes.Ar option .
5699b50d902SRodney W. GrimesQuotation marks may be placed around any part of the assignment statement to
5709b50d902SRodney W. Grimesquote blanks or tabs, i.e.
5719b50d902SRodney W. Grimes.Dq Li "set indentprefix=\*q->\*q"
5729b50d902SRodney W. Grimes.It Ic saveignore
5739b50d902SRodney W. Grimes.Ic Saveignore
5749b50d902SRodney W. Grimesis to
5759b50d902SRodney W. Grimes.Ic save
5769b50d902SRodney W. Grimeswhat
5779b50d902SRodney W. Grimes.Ic ignore
5789b50d902SRodney W. Grimesis to
5799b50d902SRodney W. Grimes.Ic print
5809b50d902SRodney W. Grimesand
5819b50d902SRodney W. Grimes.Ic type  .
5829b50d902SRodney W. GrimesHeader fields thus marked are filtered out when
5839b50d902SRodney W. Grimessaving a message by
5849b50d902SRodney W. Grimes.Ic save
5859b50d902SRodney W. Grimesor when automatically saving to
5869b50d902SRodney W. Grimes.Ar mbox  .
5879b50d902SRodney W. Grimes.It Ic saveretain
5889b50d902SRodney W. Grimes.Ic Saveretain
5899b50d902SRodney W. Grimesis to
5909b50d902SRodney W. Grimes.Ic save
5919b50d902SRodney W. Grimeswhat
5929b50d902SRodney W. Grimes.Ic retain
5939b50d902SRodney W. Grimesis to
5949b50d902SRodney W. Grimes.Ic print
5959b50d902SRodney W. Grimesand
5969b50d902SRodney W. Grimes.Ic type  .
5979b50d902SRodney W. GrimesHeader fields thus marked are the only ones saved
5989b50d902SRodney W. Grimeswith a message when saving by
5999b50d902SRodney W. Grimes.Ic save
6009b50d902SRodney W. Grimesor when automatically saving to
6019b50d902SRodney W. Grimes.Ar mbox  .
6029b50d902SRodney W. Grimes.Ic Saveretain
6039b50d902SRodney W. Grimesoverrides
6049b50d902SRodney W. Grimes.Ic saveignore  .
6059b50d902SRodney W. Grimes.It Ic shell
6069b50d902SRodney W. Grimes.Pq Ic sh
6079b50d902SRodney W. GrimesInvokes an interactive version of the shell.
6089b50d902SRodney W. Grimes.It Ic size
6099b50d902SRodney W. GrimesTakes a message list and prints out the size in characters of each
6109b50d902SRodney W. Grimesmessage.
6119b50d902SRodney W. Grimes.It Ic source
6129b50d902SRodney W. GrimesThe
6139b50d902SRodney W. Grimes.Ic source
6149b50d902SRodney W. Grimescommand reads
6159b50d902SRodney W. Grimescommands from a file.
6169b50d902SRodney W. Grimes.It Ic top
6179b50d902SRodney W. GrimesTakes a message list and prints the top few lines of each.
6189b50d902SRodney W. GrimesThe number of
6199b50d902SRodney W. Grimeslines printed is controlled by the variable
6209b50d902SRodney W. Grimes.Ic toplines
6219b50d902SRodney W. Grimesand defaults to five.
6229b50d902SRodney W. Grimes.It Ic type
6239b50d902SRodney W. Grimes.Pq Ic t
6249b50d902SRodney W. GrimesA synonym for
6259b50d902SRodney W. Grimes.Ic print  .
6269b50d902SRodney W. Grimes.It Ic unalias
6279b50d902SRodney W. GrimesTakes a list of names defined by
6289b50d902SRodney W. Grimes.Ic alias
6299b50d902SRodney W. Grimescommands and discards the remembered groups of users.
6309b50d902SRodney W. GrimesThe group names
6319b50d902SRodney W. Grimesno longer have any significance.
6329b50d902SRodney W. Grimes.It Ic undelete
6339b50d902SRodney W. Grimes.Pq Ic u
6349b50d902SRodney W. GrimesTakes a message list and marks each message as
6359b50d902SRodney W. Grimes.Ic not
6369b50d902SRodney W. Grimesbeing deleted.
6379b50d902SRodney W. Grimes.It Ic unread
6389b50d902SRodney W. Grimes.Pq Ic U
6399b50d902SRodney W. GrimesTakes a message list and marks each message as
6409b50d902SRodney W. Grimes.Ic not
6419b50d902SRodney W. Grimeshaving been read.
6429b50d902SRodney W. Grimes.It Ic unset
6439b50d902SRodney W. GrimesTakes a list of option names and discards their remembered values;
6449b50d902SRodney W. Grimesthe inverse of
6459b50d902SRodney W. Grimes.Ic set  .
6469b50d902SRodney W. Grimes.It Ic visual
6479b50d902SRodney W. Grimes.Pq Ic v
6489b50d902SRodney W. GrimesTakes a message list and invokes the display editor on each message.
6499b50d902SRodney W. Grimes.It Ic write
6509b50d902SRodney W. Grimes.Pq Ic w
6519b50d902SRodney W. GrimesSimilar to
6529b50d902SRodney W. Grimes.Ic save  ,
6539b50d902SRodney W. Grimesexcept that
6549b50d902SRodney W. Grimes.Ic only
6559b50d902SRodney W. Grimesthe message body
6569b50d902SRodney W. Grimes.Pq Ar without
6579b50d902SRodney W. Grimesthe header) is saved.
6589b50d902SRodney W. GrimesExtremely useful for such tasks as sending and receiving source
6599b50d902SRodney W. Grimesprogram text over the message system.
6609b50d902SRodney W. Grimes.It Ic xit
6619b50d902SRodney W. Grimes.Pq Ic x
6629b50d902SRodney W. GrimesA synonym for
6639b50d902SRodney W. Grimes.Ic exit  .
6649b50d902SRodney W. Grimes.It Ic z
6659b50d902SRodney W. Grimes.Nm Mail
6669b50d902SRodney W. Grimespresents message headers in windowfuls as described under the
6679b50d902SRodney W. Grimes.Ic headers
6689b50d902SRodney W. Grimescommand.
6699b50d902SRodney W. GrimesYou can move
6709b50d902SRodney W. Grimes.Nm mail Ns 's
6719b50d902SRodney W. Grimesattention forward to the next window with the
6729b50d902SRodney W. Grimes.Ic \&z
6739b50d902SRodney W. Grimescommand.
6749b50d902SRodney W. GrimesAlso, you can move to the previous window by using
6759b50d902SRodney W. Grimes.Ic \&z\&\-  .
6769b50d902SRodney W. Grimes.El
6779b50d902SRodney W. Grimes.Ss Tilde/Escapes
6789b50d902SRodney W. Grimes.Pp
6799b50d902SRodney W. GrimesHere is a summary of the tilde escapes,
6809b50d902SRodney W. Grimeswhich are used when composing messages to perform
6819b50d902SRodney W. Grimesspecial functions.
6829b50d902SRodney W. GrimesTilde escapes are only recognized at the beginning
6839b50d902SRodney W. Grimesof lines.
6849b50d902SRodney W. GrimesThe name
6859b50d902SRodney W. Grimes.Dq Em tilde\ escape
6869b50d902SRodney W. Grimesis somewhat of a misnomer since the actual escape character can be set
6879b50d902SRodney W. Grimesby the option
6889b50d902SRodney W. Grimes.Ic escape .
6899b50d902SRodney W. Grimes.Bl -tag -width Ds
6909b50d902SRodney W. Grimes.It Ic \&~! Ns Ar command
6919b50d902SRodney W. GrimesExecute the indicated shell command, then return to the message.
6929b50d902SRodney W. Grimes.It Ic \&~b Ns Ar name ...
6939b50d902SRodney W. GrimesAdd the given names to the list of carbon copy recipients but do not make
6949b50d902SRodney W. Grimesthe names visible in the Cc: line ("blind" carbon copy).
6959b50d902SRodney W. Grimes.It Ic \&~c Ns Ar name ...
6969b50d902SRodney W. GrimesAdd the given names to the list of carbon copy recipients.
6979b50d902SRodney W. Grimes.It Ic \&~d
6989b50d902SRodney W. GrimesRead the file
6999b50d902SRodney W. Grimes.Dq Pa dead.letter
7009b50d902SRodney W. Grimesfrom your home directory into the message.
7019b50d902SRodney W. Grimes.It Ic \&~e
7029b50d902SRodney W. GrimesInvoke the text editor on the message collected so far.
7039b50d902SRodney W. GrimesAfter the
7049b50d902SRodney W. Grimesediting session is finished, you may continue appending text to the
7059b50d902SRodney W. Grimesmessage.
7069b50d902SRodney W. Grimes.It Ic \&~f Ns Ar messages
7079b50d902SRodney W. GrimesRead the named messages into the message being sent.
7089b50d902SRodney W. GrimesIf no messages are specified, read in the current message.
7099b50d902SRodney W. GrimesMessage headers currently being ignored (by the
7109b50d902SRodney W. Grimes.Ic ignore
7119b50d902SRodney W. Grimesor
7129b50d902SRodney W. Grimes.Ic retain
7139b50d902SRodney W. Grimescommand) are not included.
7149b50d902SRodney W. Grimes.It Ic \&~F Ns Ar messages
7159b50d902SRodney W. GrimesIdentical to
7169b50d902SRodney W. Grimes.Ic \&~f ,
7179b50d902SRodney W. Grimesexcept all message headers are included.
7189b50d902SRodney W. Grimes.It Ic \&~h
7199b50d902SRodney W. GrimesEdit the message header fields by typing each one in turn and allowing
7209b50d902SRodney W. Grimesthe user to append text to the end or modify the field by using the
7219b50d902SRodney W. Grimescurrent terminal erase and kill characters.
7229b50d902SRodney W. Grimes.It Ic \&~m Ns Ar messages
7239b50d902SRodney W. GrimesRead the named messages into the message being sent, indented by a
7249b50d902SRodney W. Grimestab or by the value of
7259b50d902SRodney W. Grimes.Ar indentprefix  .
7269b50d902SRodney W. GrimesIf no messages are specified,
7279b50d902SRodney W. Grimesread the current message.
7289b50d902SRodney W. GrimesMessage headers currently being ignored (by the
7299b50d902SRodney W. Grimes.Ic ignore
7309b50d902SRodney W. Grimesor
7319b50d902SRodney W. Grimes.Ic retain
7329b50d902SRodney W. Grimescommand) are not included.
7339b50d902SRodney W. Grimes.It Ic \&~M Ns Ar messages
7349b50d902SRodney W. GrimesIdentical to
7359b50d902SRodney W. Grimes.Ic \&~m ,
7369b50d902SRodney W. Grimesexcept all message headers are included.
7379b50d902SRodney W. Grimes.It Ic \&~p
7389b50d902SRodney W. GrimesPrint out the message collected so far, prefaced by the message header
7399b50d902SRodney W. Grimesfields.
7409b50d902SRodney W. Grimes.It Ic \&~q
7419b50d902SRodney W. GrimesAbort the message being sent, copying the message to
7429b50d902SRodney W. Grimes.Dq Pa dead.letter
7439b50d902SRodney W. Grimesin your home directory if
7449b50d902SRodney W. Grimes.Ic save
7459b50d902SRodney W. Grimesis set.
7469b50d902SRodney W. Grimes.It Ic \&~r Ns Ar filename
7479b50d902SRodney W. GrimesRead the named file into the message.
7489b50d902SRodney W. Grimes.It Ic \&~s Ns Ar string
7499b50d902SRodney W. GrimesCause the named string to become the current subject field.
7509b50d902SRodney W. Grimes.It Ic \&~\&t Ns Ar name ...
7519b50d902SRodney W. GrimesAdd the given names to the direct recipient list.
7529b50d902SRodney W. Grimes.It Ic \&~\&v
7539b50d902SRodney W. GrimesInvoke an alternate editor (defined by the
7549b50d902SRodney W. Grimes.Ev VISUAL
7559b50d902SRodney W. Grimesoption) on the
7569b50d902SRodney W. Grimesmessage collected so far.
7579b50d902SRodney W. GrimesUsually, the alternate editor will be a
7589b50d902SRodney W. Grimesscreen editor.
7599b50d902SRodney W. GrimesAfter you quit the editor, you may resume appending
7609b50d902SRodney W. Grimestext to the end of your message.
7619b50d902SRodney W. Grimes.It Ic \&~w Ns Ar filename
7629b50d902SRodney W. GrimesWrite the message onto the named file.
7639b50d902SRodney W. Grimes.It Ic \&~\&| Ns Ar command
7649b50d902SRodney W. GrimesPipe the message through the command as a filter.
7659b50d902SRodney W. GrimesIf the command gives
7669b50d902SRodney W. Grimesno output or terminates abnormally, retain the original text of the
7679b50d902SRodney W. Grimesmessage.
7689b50d902SRodney W. GrimesThe command
7699b50d902SRodney W. Grimes.Xr fmt 1
7709b50d902SRodney W. Grimesis often used as
7719b50d902SRodney W. Grimes.Ic command
7729b50d902SRodney W. Grimesto rejustify the message.
7739b50d902SRodney W. Grimes.It Ic \&~: Ns Ar mail-command
7749b50d902SRodney W. GrimesExecute the given mail command.
7759b50d902SRodney W. GrimesNot all commands, however, are allowed.
7769b50d902SRodney W. Grimes.It Ic \&~~ Ns Ar string
7779b50d902SRodney W. GrimesInsert the string of text in the message prefaced by a single ~.
7789b50d902SRodney W. GrimesIf
7799b50d902SRodney W. Grimesyou have changed the escape character, then you should double
7809b50d902SRodney W. Grimesthat character in order to send it.
7819b50d902SRodney W. Grimes.El
7829b50d902SRodney W. Grimes.Ss Mail Options
7839b50d902SRodney W. GrimesOptions are controlled via
7849b50d902SRodney W. Grimes.Ic set
7859b50d902SRodney W. Grimesand
7869b50d902SRodney W. Grimes.Ic unset
7879b50d902SRodney W. Grimescommands.
7889b50d902SRodney W. GrimesOptions may be either binary, in which case it is only
7899b50d902SRodney W. Grimessignificant to see whether they are set or not; or string, in which
7909b50d902SRodney W. Grimescase the actual value is of interest.
7919b50d902SRodney W. GrimesThe binary options include the following:
7929b50d902SRodney W. Grimes.Bl -tag -width append
7939b50d902SRodney W. Grimes.It Ar append
7949b50d902SRodney W. GrimesCauses messages saved in
7959b50d902SRodney W. Grimes.Ar mbox
7969b50d902SRodney W. Grimesto be appended to the end rather than prepended.
7979b50d902SRodney W. GrimesThis should always be set (perhaps in
7989b50d902SRodney W. Grimes.Pa /usr/share/misc/Mail.rc ) .
7999b50d902SRodney W. Grimes.It Ar ask
8009b50d902SRodney W. GrimesCauses
8019b50d902SRodney W. Grimes.Nm mail
8029b50d902SRodney W. Grimesto prompt you for the subject of each message you send.
8039b50d902SRodney W. GrimesIf
8049b50d902SRodney W. Grimesyou respond with simply a newline, no subject field will be sent.
8059b50d902SRodney W. Grimes.It Ar askcc
8069b50d902SRodney W. GrimesCauses you to be prompted for additional carbon copy recipients at the
8079b50d902SRodney W. Grimesend of each message.
8089b50d902SRodney W. GrimesResponding with a newline indicates your
8099b50d902SRodney W. Grimessatisfaction with the current list.
8109b50d902SRodney W. Grimes.It Ar autoprint
8119b50d902SRodney W. GrimesCauses the
8129b50d902SRodney W. Grimes.Ic delete
8139b50d902SRodney W. Grimescommand to behave like
8149b50d902SRodney W. Grimes.Ic dp
8159b50d902SRodney W. Grimes\- thus, after deleting a message, the next one will be typed
8169b50d902SRodney W. Grimesautomatically.
8179b50d902SRodney W. Grimes.It Ar debug
8189b50d902SRodney W. GrimesSetting the binary option
8199b50d902SRodney W. Grimes.Ar debug
8209b50d902SRodney W. Grimesis the same as specifying
8219b50d902SRodney W. Grimes.Fl d
8229b50d902SRodney W. Grimeson the command line and causes
8239b50d902SRodney W. Grimes.Nm mail
8249b50d902SRodney W. Grimesto output all sorts of information useful for debugging
8259b50d902SRodney W. Grimes.Nm mail  .
8269b50d902SRodney W. Grimes.It Ar dot
8279b50d902SRodney W. GrimesThe binary option
8289b50d902SRodney W. Grimes.Ar dot
8299b50d902SRodney W. Grimescauses
8309b50d902SRodney W. Grimes.Nm mail
8319b50d902SRodney W. Grimesto interpret a period alone on a line as the terminator
8329b50d902SRodney W. Grimesof a message you are sending.
8339b50d902SRodney W. Grimes.It Ar hold
8349b50d902SRodney W. GrimesThis option is used to hold messages in the system mailbox
8359b50d902SRodney W. Grimesby default.
8369b50d902SRodney W. Grimes.It Ar ignore
8379b50d902SRodney W. GrimesCauses interrupt signals from your terminal to be ignored and echoed as
8389b50d902SRodney W. Grimes@'s.
8399b50d902SRodney W. Grimes.It Ar ignoreeof
8409b50d902SRodney W. GrimesAn option related to
8419b50d902SRodney W. Grimes.Ar dot
8429b50d902SRodney W. Grimesis
8439b50d902SRodney W. Grimes.Ar ignoreeof
8449b50d902SRodney W. Grimeswhich makes
8459b50d902SRodney W. Grimes.Nm mail
8469b50d902SRodney W. Grimesrefuse to accept a control-d as the end of a message.
8479b50d902SRodney W. Grimes.Ar Ignoreeof
8489b50d902SRodney W. Grimesalso applies to
8499b50d902SRodney W. Grimes.Nm mail
8509b50d902SRodney W. Grimescommand mode.
8519b50d902SRodney W. Grimes.It Ar metoo
8529b50d902SRodney W. GrimesUsually, when a group is expanded that contains the sender, the sender
8539b50d902SRodney W. Grimesis removed from the expansion.
8549b50d902SRodney W. GrimesSetting this option causes the sender
8559b50d902SRodney W. Grimesto be included in the group.
8569b50d902SRodney W. Grimes.It Ar noheader
8579b50d902SRodney W. GrimesSetting the option
8589b50d902SRodney W. Grimes.Ar noheader
8599b50d902SRodney W. Grimesis the same as giving the
8609b50d902SRodney W. Grimes.Fl N
8619b50d902SRodney W. Grimesflag on the command line.
8629b50d902SRodney W. Grimes.It Ar nosave
8639b50d902SRodney W. GrimesNormally, when you abort a message with two
8649b50d902SRodney W. Grimes.Tn RUBOUT
8659b50d902SRodney W. Grimes(erase or delete)
8669b50d902SRodney W. Grimes.Nm mail
8679b50d902SRodney W. Grimescopies the partial letter to the file
8689b50d902SRodney W. Grimes.Dq Pa dead.letter
8699b50d902SRodney W. Grimesin your home directory.
8709b50d902SRodney W. GrimesSetting the binary option
8719b50d902SRodney W. Grimes.Ar nosave
8729b50d902SRodney W. Grimesprevents this.
8739b50d902SRodney W. Grimes.It Ar Replyall
8749b50d902SRodney W. GrimesReverses the sense of
8759b50d902SRodney W. Grimes.Ic reply
8769b50d902SRodney W. Grimesand
8779b50d902SRodney W. Grimes.Ic Reply
8789b50d902SRodney W. Grimescommands.
8799b50d902SRodney W. Grimes.It Ar quiet
8809b50d902SRodney W. GrimesSuppresses the printing of the version when first invoked.
8819b50d902SRodney W. Grimes.It Ar searchheaders
8829b50d902SRodney W. GrimesIf this option is set, then a message-list specifier in the form ``/x:y''
8839b50d902SRodney W. Grimeswill expand to all messages containing the substring ``y'' in the header
8849b50d902SRodney W. Grimesfield ``x''.  The string search is case insensitive.
8859b50d902SRodney W. Grimes.It Ar verbose
8869b50d902SRodney W. GrimesSetting the option
8879b50d902SRodney W. Grimes.Ar verbose
8889b50d902SRodney W. Grimesis the same as using the
8899b50d902SRodney W. Grimes.Fl v
8909b50d902SRodney W. Grimesflag on the command line.
8919b50d902SRodney W. GrimesWhen mail runs in verbose mode,
8929b50d902SRodney W. Grimesthe actual delivery of messages is displayed on the user's
8939b50d902SRodney W. Grimesterminal.
8949b50d902SRodney W. Grimes.El
8959b50d902SRodney W. Grimes.Ss Option String Values
8969b50d902SRodney W. Grimes.Bl -tag -width Va
8979b50d902SRodney W. Grimes.It Ev EDITOR
8989b50d902SRodney W. GrimesPathname of the text editor to use in the
8999b50d902SRodney W. Grimes.Ic edit
9009b50d902SRodney W. Grimescommand and
9019b50d902SRodney W. Grimes.Ic \&~e
9029b50d902SRodney W. Grimesescape.
9039b50d902SRodney W. GrimesIf not defined, then a default editor is used.
9049b50d902SRodney W. Grimes.It Ev LISTER
9059b50d902SRodney W. GrimesPathname of the directory lister to use in the
9069b50d902SRodney W. Grimes.Ic folders
9079b50d902SRodney W. Grimescommand.
9089b50d902SRodney W. GrimesDefault is
9099b50d902SRodney W. Grimes.Pa /bin/ls .
9109b50d902SRodney W. Grimes.It Ev PAGER
9119b50d902SRodney W. GrimesPathname of the program to use in the
9129b50d902SRodney W. Grimes.Ic more
9139b50d902SRodney W. Grimescommand or when
9149b50d902SRodney W. Grimes.Ic crt
9159b50d902SRodney W. Grimesvariable is set.
9169b50d902SRodney W. GrimesThe default paginator
9179b50d902SRodney W. Grimes.Xr more 1
9189b50d902SRodney W. Grimesis used if this option is not defined.
9199b50d902SRodney W. Grimes.It Ev SHELL
9209b50d902SRodney W. GrimesPathname of the shell to use in the
9219b50d902SRodney W. Grimes.Ic \&!
9229b50d902SRodney W. Grimescommand and the
9239b50d902SRodney W. Grimes.Ic \&~!
9249b50d902SRodney W. Grimesescape.
9259b50d902SRodney W. GrimesA default shell is used if this option is
9269b50d902SRodney W. Grimesnot defined.
9279b50d902SRodney W. Grimes.It Ev VISUAL
9289b50d902SRodney W. GrimesPathname of the text editor to use in the
9299b50d902SRodney W. Grimes.Ic visual
9309b50d902SRodney W. Grimescommand and
9319b50d902SRodney W. Grimes.Ic \&~v
9329b50d902SRodney W. Grimesescape.
9339b50d902SRodney W. Grimes.It Va crt
9349b50d902SRodney W. GrimesThe valued option
9359b50d902SRodney W. Grimes.Va crt
9369b50d902SRodney W. Grimesis used as a threshold to determine how long a message must
9379b50d902SRodney W. Grimesbe before
9389b50d902SRodney W. Grimes.Ev PAGER
9399b50d902SRodney W. Grimesis used to read it.
9409b50d902SRodney W. GrimesIf
9419b50d902SRodney W. Grimes.Va crt
9429b50d902SRodney W. Grimesis set without a value,
9439b50d902SRodney W. Grimesthen the height of the terminal screen stored in the system
9449b50d902SRodney W. Grimesis used to compute the threshold (see
9459b50d902SRodney W. Grimes.Xr stty 1 ) .
9469b50d902SRodney W. Grimes.It Ar escape
9479b50d902SRodney W. GrimesIf defined, the first character of this option gives the character to
9489b50d902SRodney W. Grimesuse in the place of ~ to denote escapes.
9499b50d902SRodney W. Grimes.It Ar folder
9509b50d902SRodney W. GrimesThe name of the directory to use for storing folders of
9519b50d902SRodney W. Grimesmessages.
9529b50d902SRodney W. GrimesIf this name begins with a `/',
9539b50d902SRodney W. Grimes.Nm mail
9549b50d902SRodney W. Grimesconsiders it to be an absolute pathname; otherwise, the
9559b50d902SRodney W. Grimesfolder directory is found relative to your home directory.
9569b50d902SRodney W. Grimes.It Ev MBOX
9579b50d902SRodney W. GrimesThe name of the
9589b50d902SRodney W. Grimes.Ar mbox
9599b50d902SRodney W. Grimesfile.
9609b50d902SRodney W. GrimesIt can be the name of a folder.
9619b50d902SRodney W. GrimesThe default is
9629b50d902SRodney W. Grimes.Dq Li mbox
9639b50d902SRodney W. Grimesin the user's home directory.
9649b50d902SRodney W. Grimes.It Ar record
9659b50d902SRodney W. GrimesIf defined, gives the pathname of the file used to record all outgoing
9669b50d902SRodney W. Grimesmail.
9679b50d902SRodney W. GrimesIf not defined, then outgoing mail is not so saved.
9689b50d902SRodney W. Grimes.It Ar indentprefix
9699b50d902SRodney W. GrimesString used by the ``~m'' tilde escape for indenting messages, in place of
9709b50d902SRodney W. Grimesthe normal tab character (^I).
9719b50d902SRodney W. GrimesBe sure to quote the value if it contains
9729b50d902SRodney W. Grimesspaces or tabs.
9739b50d902SRodney W. Grimes.It Ar toplines
9749b50d902SRodney W. GrimesIf defined, gives the number of lines of a message to be printed out
9759b50d902SRodney W. Grimeswith the
9769b50d902SRodney W. Grimes.Ic top
9779b50d902SRodney W. Grimescommand; normally, the first five lines are printed.
9789b50d902SRodney W. Grimes.El
9799b50d902SRodney W. Grimes.Sh ENVIRONMENT
9809b50d902SRodney W. Grimes.Nm Mail
9819b50d902SRodney W. Grimesutilizes the
9829b50d902SRodney W. Grimes.Ev HOME
9839b50d902SRodney W. Grimesand
9849b50d902SRodney W. Grimes.Ev USER
9859b50d902SRodney W. Grimesenvironment variables.
9869b50d902SRodney W. Grimes.Sh FILES
9879b50d902SRodney W. Grimes.Bl -tag -width /usr/share/misc/Mail.help* -compact
9889b50d902SRodney W. Grimes.It Pa /var/spool/mail/*
9899b50d902SRodney W. GrimesPost office.
9909b50d902SRodney W. Grimes.It ~/mbox
9919b50d902SRodney W. GrimesUser's old mail.
9929b50d902SRodney W. Grimes.It ~/.mailrc
9939b50d902SRodney W. GrimesFile giving initial mail commands.
9949b50d902SRodney W. Grimes.It Pa /tmp/R*
9959b50d902SRodney W. GrimesTemporary files.
9969b50d902SRodney W. Grimes.It Pa /usr/share/misc/Mail.help*
9979b50d902SRodney W. GrimesHelp files.
9989b50d902SRodney W. Grimes.It Pa /usr/share/misc/Mail.rc
9999b50d902SRodney W. GrimesSystem initialization file.
10009b50d902SRodney W. Grimes.El
10019b50d902SRodney W. Grimes.Sh SEE ALSO
10029b50d902SRodney W. Grimes.Xr fmt 1 ,
10039b50d902SRodney W. Grimes.Xr newaliases 1 ,
10049b50d902SRodney W. Grimes.Xr vacation 1 ,
10059b50d902SRodney W. Grimes.Xr aliases 5 ,
10069b50d902SRodney W. Grimes.Xr mailaddr 7 ,
10079b50d902SRodney W. Grimes.Xr sendmail 8
10089b50d902SRodney W. Grimesand
10099b50d902SRodney W. Grimes.Rs
10109b50d902SRodney W. Grimes.%T "The Mail Reference Manual" .
10119b50d902SRodney W. Grimes.Re
10129b50d902SRodney W. Grimes.Sh HISTORY
10139b50d902SRodney W. GrimesA
10149b50d902SRodney W. Grimes.Nm mail
10159b50d902SRodney W. Grimescommand
10169b50d902SRodney W. Grimesappeared in
10179b50d902SRodney W. Grimes.At v6 .
10189b50d902SRodney W. GrimesThis man page is derived from
10199b50d902SRodney W. Grimes.%T "The Mail Reference Manual"
10209b50d902SRodney W. Grimesoriginally written by Kurt Shoens.
10219b50d902SRodney W. Grimes.Sh BUGS
10229b50d902SRodney W. GrimesThere are some flags that are not documented here.
10239b50d902SRodney W. GrimesMost are
10249b50d902SRodney W. Grimesnot useful to the general user.
10259b50d902SRodney W. Grimes.Pp
10269b50d902SRodney W. GrimesUsually,
10279b50d902SRodney W. Grimes.Nm mail
10289b50d902SRodney W. Grimesis just a link to
10299b50d902SRodney W. Grimes.Nm Mail  ,
10309b50d902SRodney W. Grimeswhich can be confusing.
1031