1.\" Copyright (c) 1980, 1990, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" %sccs.include.redist.roff% 5.\" 6.\" @(#)mail.1 8.8 (Berkeley) 04/28/95 7.\" 8.Dd 9.Dt MAIL 1 10.Os BSD 4 11.Sh NAME 12.Nm mail 13.Nd send and receive mail 14.Sh SYNOPSIS 15.Nm mail 16.Op Fl iInv 17.Op Fl s Ar subject 18.Op Fl c Ar cc-addr 19.Op Fl b Ar bcc-addr 20.Ar to-addr... 21.Nm mail 22.Op Fl iInNv 23.Fl f 24.Op Ar name 25.Nm mail 26.Op Fl iInNv 27.Op Fl u Ar user 28.Sh INTRODUCTION 29.Nm Mail 30is an intelligent mail processing system, which has 31a command syntax reminiscent of 32.Xr \&ed 1 33with lines replaced by messages. 34.Pp 35.Bl -tag -width flag 36.It Fl v 37Verbose mode. 38The details of 39delivery are displayed on the user's terminal. 40.It Fl i 41Ignore tty interrupt signals. 42This is 43particularly useful when using 44.Nm mail 45on noisy phone lines. 46.It Fl I 47Forces mail to run in interactive mode even when 48input isn't a terminal. 49In particular, the 50.Sq Ic \&~ 51special 52character when sending mail is only active in interactive mode. 53.It Fl n 54Inhibits reading 55.Pa /etc/mail.rc 56upon startup. 57.It Fl N 58Inhibits the initial display of message headers 59when reading mail or editing a mail folder. 60.It Fl s 61Specify subject on command line 62(only the first argument after the 63.Fl s 64flag is used as a subject; be careful to quote subjects 65containing spaces.) 66.It Fl c 67Send carbon copies to 68.Ar list 69of users. 70.It Fl b 71Send blind carbon copies to 72.Ar list . 73List should be a comma-separated list of names. 74.It Fl f 75Read in the contents of your 76.Ar mbox 77(or the specified file) 78for processing; when you 79.Ar quit , 80.Nm mail 81writes undeleted messages back to this file. 82.It Fl u 83Is equivalent to: 84.Pp 85.Dl mail -f /var/mail/user 86.El 87.Ss Sending mail 88To send a message to one or more people, 89.Nm mail 90can be invoked with arguments which are the names of people to 91whom the mail will be sent. 92You are then expected to type in 93your message, followed 94by an 95.Sq Li control\-D 96at the beginning of a line. 97The section below 98.Ar Replying to or originating mail , 99describes some features of 100.Nm mail 101available to help you compose your letter. 102.Pp 103.Ss Reading mail 104In normal usage 105.Nm mail 106is given no arguments and checks your mail out of the 107post office, then 108prints out a one line header of each message found. 109The current message is initially the first message (numbered 1) 110and can be printed using the 111.Ic print 112command (which can be abbreviated 113.Ql Ic p ) . 114You can move among the messages much as you move between lines in 115.Xr \&ed 1 , 116with the commands 117.Ql Ic \&+ 118and 119.Ql Ic \&\- 120moving backwards and forwards, and 121simple numbers. 122.Pp 123.Ss Disposing of mail. 124After examining a message you can 125.Ic delete 126.Ql Ic d ) 127the message or 128.Ic reply 129.Ql Ic r ) 130to it. 131Deletion causes the 132.Nm mail 133program to forget about the message. 134This is not irreversible; the message can be 135.Ic undeleted 136.Ql Ic u ) 137by giving its number, or the 138.Nm mail 139session can be aborted by giving the 140.Ic exit 141.Ql Ic x ) 142command. 143Deleted messages will, however, usually disappear never to be seen again. 144.Pp 145.Ss Specifying messages 146Commands such as 147.Ic print 148and 149.Ic delete 150can be given a list of message numbers as arguments to apply 151to a number of messages at once. 152Thus 153.Dq Li delete 1 2 154deletes messages 1 and 2, while 155.Dq Li delete 1\-5 156deletes messages 1 through 5. 157The special name 158.Ql Li \&* 159addresses all messages, and 160.Ql Li \&$ 161addresses 162the last message; thus the command 163.Ic top 164which prints the first few lines of a message could be used in 165.Dq Li top \&* 166to print the first few lines of all messages. 167.Pp 168.Ss Replying to or originating mail. 169You can use the 170.Ic reply 171command to 172set up a response to a message, sending it back to the 173person who it was from. 174Text you then type in, up to an end-of-file, 175defines the contents of the message. 176While you are composing a message, 177.Nm mail 178treats lines beginning with the character 179.Ql Ic \&~ 180specially. 181For instance, typing 182.Ql Ic \&~m 183(alone on a line) will place a copy 184of the current message into the response right shifting it by a tabstop 185(see 186.Em indentprefix 187variable, below). 188Other escapes will set up subject fields, add and delete recipients 189to the message and allow you to escape to an editor to revise the 190message or to a shell to run some commands. 191(These options 192are given in the summary below.) 193.Pp 194.Ss Ending a mail processing session. 195You can end a 196.Nm mail 197session with the 198.Ic quit 199.Ql Ic q ) 200command. 201Messages which have been examined go to your 202.Ar mbox 203file unless they have been deleted in which case they are discarded. 204Unexamined messages go back to the post office. 205(See the 206.Fl f 207option above). 208.Pp 209.Ss Personal and systemwide distribution lists. 210It is also possible to create a personal distribution lists so that, 211for instance, you can send mail to 212.Dq Li cohorts 213and have it go 214to a group of people. 215Such lists can be defined by placing a line like 216.Pp 217.Dl alias cohorts bill ozalp jkf mark kridle@ucbcory 218.Pp 219in the file 220.Pa \&.mailrc 221in your home directory. 222The current list of such aliases can be displayed with the 223.Ic alias 224command in 225.Nm mail . 226System wide distribution lists can be created by editing 227.Pa /etc/aliases , 228see 229.Xr aliases 5 230and 231.Xr sendmail 8 ; 232these are kept in a different syntax. 233In mail you send, personal aliases will be expanded in mail sent 234to others so that they will be able to 235.Ic reply 236to the recipients. 237System wide 238.Ic aliases 239are not expanded when the mail is sent, 240but any reply returned to the machine will have the system wide 241alias expanded as all mail goes through 242.Xr sendmail . 243.Pp 244.Ss Network mail (ARPA, UUCP, Berknet) 245See 246.Xr mailaddr 7 247for a description of network addresses. 248.Pp 249.Nm Mail 250has a number of options which can be set in the 251.Pa .mailrc 252file to alter its behavior; thus 253.Dq Li set askcc 254enables the 255.Ar askcc 256feature. 257(These options are summarized below.) 258.Sh SUMMARY 259(Adapted from the `Mail Reference Manual') 260.Pp 261Each command is typed on a line by itself, and may take arguments 262following the command word. 263The command need not be typed in its 264entirety \- the first command which matches the typed prefix is used. 265For commands which take message lists as arguments, if no message 266list is given, then the next message forward which satisfies the 267command's requirements is used. 268If there are no messages forward of 269the current message, the search proceeds backwards, and if there are no 270good messages at all, 271.Nm mail 272types 273.Dq Li No applicable messages 274and 275aborts the command. 276.Bl -tag -width delete 277.It Ic \&\- 278Print out the preceding message. 279If given a numeric 280argument 281.Ar n , 282goes to the 283.Ar n Ns 'th 284previous message and prints it. 285.It Ic \&? 286Prints a brief summary of commands. 287.It Ic \&! 288Executes the shell 289(see 290.Xr sh 1 291and 292.Xr csh 1 ) 293command which follows. 294.It Ic Print 295.Pq Ic P 296Like 297.Ic print 298but also prints out ignored header fields. 299See also 300.Ic print , 301.Ic ignore 302and 303.Ic retain . 304.It Ic Reply 305.Pq Ic R 306Reply to originator. 307Does not reply to other 308recipients of the original message. 309.It Ic Type 310.Pq Ic T 311Identical to the 312.Ic Print 313command. 314.It Ic alias 315.Pq Ic a 316With no arguments, prints out all currently-defined aliases. 317With one 318argument, prints out that alias. 319With more than one argument, creates 320a new alias or changes an old one. 321.It Ic alternates 322.Pq Ic alt 323The 324.Ic alternates 325command is useful if you have accounts on several machines. 326It can be used to inform 327.Nm mail 328that the listed addresses are really you. 329When you 330.Ic reply 331to messages, 332.Nm mail 333will not send a copy of the message to any of the addresses 334listed on the 335.Ic alternates 336list. 337If the 338.Ic alternates 339command is given with no argument, the current set of alternate 340names is displayed. 341.It Ic chdir 342.Pq Ic c 343Changes the user's working directory to that specified, if given. 344If 345no directory is given, then changes to the user's login directory. 346.It Ic copy 347.Pq Ic co 348The 349.Ic copy 350command does the same thing that 351.Ic save 352does, except that it does not mark the messages it 353is used on for deletion when you quit. 354.It Ic delete 355.Pq Ic d 356Takes a list of messages as argument and marks them all as deleted. 357Deleted messages will not be saved in 358.Ar mbox , 359nor will they be available for most other commands. 360.It Ic dp 361(also 362.Ic dt ) 363Deletes the current message and prints the next message. 364If there is no next message, 365.Nm mail 366says 367.Dq Li "at EOF" . 368.It Ic edit 369.Pq Ic e 370Takes a list of messages and points the text editor at each one in 371turn. 372On return from the editor, the message is read back in. 373.It Ic exit 374.Pf ( Ic ex 375or 376.Ic x ) 377Effects an immediate return to the Shell without 378modifying the user's system mailbox, his 379.Ar mbox 380file, or his edit file in 381.Fl f . 382.It Ic file 383.Pq Ic fi 384The same as 385.Ic folder . 386.It Ic folders 387List the names of the folders in your folder directory. 388.It Ic folder 389.Pq Ic fo 390The 391.Ic folder 392command switches to a new mail file or folder. 393With no 394arguments, it tells you which file you are currently reading. 395If you give it an argument, it will write out changes (such 396as deletions) you have made in the current file and read in 397the new file. 398Some special conventions are recognized for 399the name. 400# means the previous file, % means your system 401mailbox, %user means user's system mailbox, & means 402your 403.Ar mbox 404file, and 405\&+\&folder means a file in your folder 406directory. 407.It Ic from 408.Pq Ic f 409Takes a list of messages and prints their message headers. 410.It Ic headers 411.Pq Ic h 412Lists the current range of headers, which is an 18\-message group. 413If 414a 415.Ql \&+ 416argument is given, then the next 18\-message group is printed, and if 417a 418.Ql \&\- 419argument is given, the previous 18\-message group is printed. 420.It Ic help 421A synonym for 422.Ic \&? 423.ne 1i 424.It Ic hold 425.Pf ( Ic ho , 426also 427.Ic preserve ) 428Takes a message list and marks each 429message therein to be saved in the 430user's system mailbox instead of in 431.Ar mbox . 432Does not override the 433.Ic delete 434command. 435.It Ic ignore 436Add the list of header fields named to the 437.Ar ignored list . 438Header fields in the ignore list are not printed 439on your terminal when you print a message. 440This 441command is very handy for suppression of certain machine-generated 442header fields. 443The 444.Ic Type 445and 446.Ic Print 447commands can be used to print a message in its entirety, including 448ignored fields. 449If 450.Ic ignore 451is executed with no arguments, it lists the current set of 452ignored fields. 453.It Ic inc 454Incorporate any new messages that have arrived while mail 455is being read. 456The new messages are added to the end of the message list, 457and the current message is reset to be the first new mail message. 458This does not renumber the existing message list, nor does 459does it cause any changes made so far to be saved. 460.It Ic mail 461.Pq Ic m 462Takes as argument login names and distribution group names and sends 463mail to those people. 464.It Ic mbox 465Indicate that a list of messages be sent to 466.Ic mbox 467in your home directory when you quit. 468This is the default 469action for messages if you do 470.Em not 471have the 472.Ic hold 473option set. 474.It Ic next 475.Pq Ic n 476like 477.Ic \&+ 478or 479.Tn CR ) 480Goes to the next message in sequence and types it. 481With an argument list, types the next matching message. 482.It Ic preserve 483.Pq Ic pre 484A synonym for 485.Ic hold . 486.It Ic print 487.Pq Ic p 488Takes a message list and types out each message on the user's terminal. 489.It Ic quit 490.Pq Ic q 491Terminates the session, saving all undeleted, unsaved messages in 492the user's 493.Ar mbox 494file in his login directory, preserving all messages marked with 495.Ic hold 496or 497.Ic preserve 498or never referenced 499in his system mailbox, and removing all other messages from his system 500mailbox. 501If new mail has arrived during the session, the message 502.Dq Li "You have new mail" 503is given. 504If given while editing a 505mailbox file with the 506.Fl f 507flag, then the edit file is rewritten. 508A return to the Shell is 509effected, unless the rewrite of edit file fails, in which case the user 510can escape with the 511.Ic exit 512command. 513.It Ic reply 514.Pq Ic r 515Takes a message list and sends mail to the sender and all 516recipients of the specified message. 517The default message must not be deleted. 518.It Ic respond 519A synonym for 520.Ic reply . 521.It Ic retain 522Add the list of header fields named to the 523.Ar retained list 524Only the header fields in the retain list 525are shown on your terminal when you print a message. 526All other header fields are suppressed. 527The 528.Ic Type 529and 530.Ic Print 531commands can be used to print a message in its entirety. 532If 533.Ic retain 534is executed with no arguments, it lists the current set of 535retained fields. 536.It Ic save 537.Pq Ic s 538Takes a message list and a filename and appends each message in 539turn to the end of the file. 540The filename in quotes, followed by the line 541count and character count is echoed on the user's terminal. 542.It Ic set 543.Pq Ic se 544With no arguments, prints all variable values. 545Otherwise, sets 546option. 547Arguments are of the form 548.Ar option=value 549(no space before or after =) or 550.Ar option . 551Quotation marks may be placed around any part of the assignment statement to 552quote blanks or tabs, i.e. 553.Dq Li "set indentprefix=\*q->\*q" 554.It Ic saveignore 555.Ic Saveignore 556is to 557.Ic save 558what 559.Ic ignore 560is to 561.Ic print 562and 563.Ic type . 564Header fields thus marked are filtered out when 565saving a message by 566.Ic save 567or when automatically saving to 568.Ar mbox . 569.pl +1 570.It Ic saveretain 571.Ic Saveretain 572is to 573.Ic save 574what 575.Ic retain 576is to 577.Ic print 578and 579.Ic type . 580Header fields thus marked are the only ones saved 581with a message when saving by 582.Ic save 583or when automatically saving to 584.Ar mbox . 585.Ic Saveretain 586overrides 587.Ic saveignore . 588.It Ic shell 589.Pq Ic sh 590Invokes an interactive version of the shell. 591.It Ic size 592Takes a message list and prints out the size in characters of each 593message. 594.It Ic source 595The 596.Ic source 597command reads 598commands from a file. 599.It Ic top 600Takes a message list and prints the top few lines of each. 601The number of 602lines printed is controlled by the variable 603.Ic toplines 604and defaults to five. 605.It Ic type 606.Pq Ic t 607A synonym for 608.Ic print . 609.It Ic unalias 610Takes a list of names defined by 611.Ic alias 612commands and discards the remembered groups of users. 613The group names 614no longer have any significance. 615.It Ic undelete 616.Pq Ic u 617Takes a message list and marks each message as 618.Ic not 619being deleted. 620.It Ic unread 621.Pq Ic U 622Takes a message list and marks each message as 623.Ic not 624having been read. 625.It Ic unset 626Takes a list of option names and discards their remembered values; 627the inverse of 628.Ic set . 629.It Ic visual 630.Pq Ic v 631Takes a message list and invokes the display editor on each message. 632.It Ic write 633.Pq Ic w 634Similar to 635.Ic save , 636except that 637.Ic only 638the message body 639.Pq Ar without 640the header) is saved. 641Extremely useful for such tasks as sending and receiving source 642program text over the message system. 643.It Ic xit 644.Pq Ic x 645A synonym for 646.Ic exit . 647.It Ic z 648.Nm Mail 649presents message headers in windowfuls as described under the 650.Ic headers 651command. 652You can move 653.Nm mail Ns 's 654attention forward to the next window with the 655.Ic \&z 656command. 657Also, you can move to the previous window by using 658.Ic \&z\&\- . 659.El 660.Ss Tilde/Escapes 661.Pp 662Here is a summary of the tilde escapes, 663which are used when composing messages to perform 664special functions. 665Tilde escapes are only recognized at the beginning 666of lines. 667The name 668.Dq Em tilde\ escape 669is somewhat of a misnomer since the actual escape character can be set 670by the option 671.Ic escape . 672.Bl -tag -width Ds 673.It Ic \&~! Ns Ar command 674Execute the indicated shell command, then return to the message. 675.It Ic \&~b Ns Ar name ... 676Add the given names to the list of carbon copy recipients but do not make 677the names visible in the Cc: line ("blind" carbon copy). 678.It Ic \&~c Ns Ar name ... 679Add the given names to the list of carbon copy recipients. 680.It Ic \&~d 681Read the file 682.Dq Pa dead.letter 683from your home directory into the message. 684.It Ic \&~e 685Invoke the text editor on the message collected so far. 686After the 687editing session is finished, you may continue appending text to the 688message. 689.It Ic \&~f Ns Ar messages 690Read the named messages into the message being sent. 691If no messages are specified, read in the current message. 692Message headers currently being ignored (by the 693.Ic ignore 694or 695.Ic retain 696command) are not included. 697.ne 1i 698.It Ic \&~F Ns Ar messages 699Identical to 700.Ic \&~f , 701except all message headers are included. 702.It Ic \&~h 703Edit the message header fields by typing each one in turn and allowing 704the user to append text to the end or modify the field by using the 705current terminal erase and kill characters. 706.It Ic \&~m Ns Ar messages 707Read the named messages into the message being sent, indented by a 708tab or by the value of 709.Ar indentprefix . 710If no messages are specified, 711read the current message. 712Message headers currently being ignored (by the 713.Ic ignore 714or 715.Ic retain 716command) are not included. 717.It Ic \&~M Ns Ar messages 718Identical to 719.Ic \&~m , 720except all message headers are included. 721.It Ic \&~p 722Print out the message collected so far, prefaced by the message header 723fields. 724.It Ic \&~q 725Abort the message being sent, copying the message to 726.Dq Pa dead.letter 727in your home directory if 728.Ic save 729is set. 730.It Ic \&~r Ns Ar filename 731Read the named file into the message. 732.It Ic \&~s Ns Ar string 733Cause the named string to become the current subject field. 734.It Ic \&~\&t Ns Ar name ... 735Add the given names to the direct recipient list. 736.It Ic \&~\&v 737Invoke an alternate editor (defined by the 738.Ev VISUAL 739option) on the 740message collected so far. 741Usually, the alternate editor will be a 742screen editor. 743After you quit the editor, you may resume appending 744text to the end of your message. 745.It Ic \&~w Ns Ar filename 746Write the message onto the named file. 747.It Ic \&~\&| Ns Ar command 748Pipe the message through the command as a filter. 749If the command gives 750no output or terminates abnormally, retain the original text of the 751message. 752The command 753.Xr fmt 1 754is often used as 755.Ic command 756to rejustify the message. 757.It Ic \&~: Ns Ar mail-command 758Execute the given mail command. 759Not all commands, however, are allowed. 760.It Ic \&~~ Ns Ar string 761Insert the string of text in the message prefaced by a single ~. 762If 763you have changed the escape character, then you should double 764that character in order to send it. 765.El 766.Ss Mail Options 767Options are controlled via 768.Ic set 769and 770.Ic unset 771commands. 772Options may be either binary, in which case it is only 773significant to see whether they are set or not; or string, in which 774case the actual value is of interest. 775The binary options include the following: 776.Bl -tag -width append 777.It Ar append 778Causes messages saved in 779.Ar mbox 780to be appended to the end rather than prepended. 781This should always be set (perhaps in 782.Pa /etc/mail.rc ) . 783.It Ar ask 784Causes 785.Nm mail 786to prompt you for the subject of each message you send. 787If 788you respond with simply a newline, no subject field will be sent. 789.ne 1i 790.It Ar askcc 791Causes you to be prompted for additional carbon copy recipients at the 792end of each message. 793Responding with a newline indicates your 794satisfaction with the current list. 795.It Ar autoinc 796Causes new mail to be automatically incorporated when it arrives. 797Setting this is similar to issuing the 798.Ic inc 799command at each prompt, except that the current message is not 800reset when new mail arrives. 801.It Ar autoprint 802Causes the 803.Ic delete 804command to behave like 805.Ic dp 806\- thus, after deleting a message, the next one will be typed 807automatically. 808.It Ar debug 809Setting the binary option 810.Ar debug 811is the same as specifying 812.Fl d 813on the command line and causes 814.Nm mail 815to output all sorts of information useful for debugging 816.Nm mail . 817.It Ar dot 818The binary option 819.Ar dot 820causes 821.Nm mail 822to interpret a period alone on a line as the terminator 823of a message you are sending. 824.It Ar hold 825This option is used to hold messages in the system mailbox 826by default. 827.It Ar ignore 828Causes interrupt signals from your terminal to be ignored and echoed as 829@'s. 830.It Ar ignoreeof 831An option related to 832.Ar dot 833is 834.Ar ignoreeof 835which makes 836.Nm mail 837refuse to accept a control-d as the end of a message. 838.Ar Ignoreeof 839also applies to 840.Nm mail 841command mode. 842.It Ar metoo 843Usually, when a group is expanded that contains the sender, the sender 844is removed from the expansion. 845Setting this option causes the sender 846to be included in the group. 847.It Ar noheader 848Setting the option 849.Ar noheader 850is the same as giving the 851.Fl N 852flag on the command line. 853.It Ar nosave 854Normally, when you abort a message with two 855.Tn RUBOUT 856(erase or delete) 857.Nm mail 858copies the partial letter to the file 859.Dq Pa dead.letter 860in your home directory. 861Setting the binary option 862.Ar nosave 863prevents this. 864.It Ar Replyall 865Reverses the sense of 866.Ic reply 867and 868.Ic Reply 869commands. 870.It Ar quiet 871Suppresses the printing of the version when first invoked. 872.It Ar searchheaders 873If this option is set, then a message-list specifier in the form ``/x:y'' 874will expand to all messages containing the substring ``y'' in the header 875field ``x''. The string search is case insensitive. 876If ``x'' is ommitted, it will default to the ``Subject'' header field. 877The form ``/to:y'' is a special case, and will expand 878to all messages containing the substring ``y'' in the ``To'', ``Cc'' 879or ``Bcc'' header fields. 880The check for "to" is case sensitive, so that 881``/To:y'' can be used to limit the search for ``y'' to just 882the ``To:'' field. 883.It Ar verbose 884Setting the option 885.Ar verbose 886is the same as using the 887.Fl v 888flag on the command line. 889When mail runs in verbose mode, 890the actual delivery of messages is displayed on the user's 891terminal. 892.El 893.Ss Option String Values 894.Bl -tag -width Va 895.It Ev EDITOR 896Pathname of the text editor to use in the 897.Ic edit 898command and 899.Ic \&~e 900escape. 901If not defined, then a default editor is used. 902.It Ev LISTER 903Pathname of the directory lister to use in the 904.Ic folders 905command. 906Default is 907.Pa /bin/ls . 908.It Ev PAGER 909Pathname of the program to use in the 910.Ic more 911command or when 912.Ic crt 913variable is set. 914The default paginator 915.Xr more 1 916is used if this option is not defined. 917.It Ev SHELL 918Pathname of the shell to use in the 919.Ic \&! 920command and the 921.Ic \&~! 922escape. 923A default shell is used if this option is 924not defined. 925.It Ev VISUAL 926Pathname of the text editor to use in the 927.Ic visual 928command and 929.Ic \&~v 930escape. 931.ne 1i 932.It Va crt 933The valued option 934.Va crt 935is used as a threshold to determine how long a message must 936be before 937.Ev PAGER 938is used to read it. 939If 940.Va crt 941is set without a value, 942then the height of the terminal screen stored in the system 943is used to compute the threshold (see 944.Xr stty 1 ) . 945.It Ar escape 946If defined, the first character of this option gives the character to 947use in the place of ~ to denote escapes. 948.It Ar folder 949The name of the directory to use for storing folders of 950messages. 951If this name begins with a `/', 952.Nm mail 953considers it to be an absolute pathname; otherwise, the 954folder directory is found relative to your home directory. 955.It Ev MBOX 956The name of the 957.Ar mbox 958file. 959It can be the name of a folder. 960The default is 961.Dq Li mbox 962in the user's home directory. 963.It Ar record 964If defined, gives the pathname of the file used to record all outgoing 965mail. 966If not defined, then outgoing mail is not so saved. 967.It Ar indentprefix 968String used by the ``~m'' tilde escape for indenting messages, in place of 969the normal tab character (^I). 970Be sure to quote the value if it contains 971spaces or tabs. 972.It Ar toplines 973If defined, gives the number of lines of a message to be printed out 974with the 975.Ic top 976command; normally, the first five lines are printed. 977.El 978.Sh ENVIRONMENT 979.Nm Mail 980utilizes the 981.Ev HOME 982and 983.Ev USER 984environment variables. 985.Sh FILES 986.Bl -tag -width /usr/share/misc/Mail.help* -compact 987.It Pa /var/mail/* 988Post office. 989.It ~/mbox 990User's old mail. 991.It ~/.mailrc 992File giving initial mail commands. 993This can be overridden by setting the 994.Ev MAILRC 995environment variable. 996.It Pa /tmp/R* 997Temporary files. 998.It Pa /usr/share/misc/Mail.help* 999Help files. 1000.It Pa /etc/mail.rc 1001System initialization file. 1002.El 1003.Sh SEE ALSO 1004.Xr fmt 1 , 1005.Xr newaliases 1 , 1006.Xr vacation 1 , 1007.Xr aliases 5 , 1008.Xr mailaddr 7 , 1009.Xr sendmail 8 1010and 1011.Rs 1012.%T "The Mail Reference Manual" . 1013.Re 1014.Sh HISTORY 1015A 1016.Nm mail 1017command 1018appeared in 1019.At v6 . 1020This man page is derived from 1021.%T "The Mail Reference Manual" 1022originally written by Kurt Shoens. 1023.Sh BUGS 1024There are some flags that are not documented here. 1025Most are 1026not useful to the general user. 1027.Pp 1028Usually, 1029.Nm mail 1030is just a link to 1031.Nm Mail , 1032which can be confusing. 1033