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