51be22ac8d73e364c75ddcf1ed940610914440cf
[mmh] / man / mhmail.man
1 .\"
2 .\" %nmhwarning%
3 .\" $Id$
4 .\"
5 .TH MHMAIL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
6 .SH NAME
7 mhmail \- send or read mail
8 .SH SYNOPSIS
9 .HP 5
10 .B mhmail
11 .RI [ addrs
12 \&...]
13 .RB [ \-body
14 .IR text ]
15 .RB [ \-cc
16 .I addrs
17 ...]
18 .RB [ \-from
19 .IR addr ]
20 .RB [ \-subject
21 .IR subject ]
22 .RB [ \-version ]
23 .RB [ \-help ] 
24 .SH DESCRIPTION
25 .B mhmail
26 is intended as a replacement for the standard Berkeley
27 mail program
28 .RB ( mail
29 or
30 .BR mailx ),
31 which is compatible with
32 .BR nmh .
33 This program is intended for the use of programs such as
34 .BR cron ,
35 which expect to send mail automatically to various
36 users.  It is also used by various
37 .B nmh
38 commands to mail various
39 error notifications.  Although
40 .B mhmail
41 can be used interactively,
42 it is recommended that
43 .B comp
44 and
45 .B send
46 be used instead to send messages.
47 .PP
48 When invoked without arguments, it simply invokes
49 .B inc
50 to incorporate new messages from the user's maildrop.  When one or more users
51 is specified, a message is read from the standard input and spooled to
52 a temporary file.
53 .B mhmail
54 then invokes
55 .B post
56 with the
57 name of the temporary file as its argument to deliver the message to
58 the specified user.
59 .PP
60 The
61 .B \-subject
62 .I subject
63 switch can be used to specify the
64 \*(lqSubject:\*(rq field of the message.
65 .PP
66 By default,
67 .B mhmail
68 will read the message to be sent from the
69 standard input.  You can specify the text of the message at the command
70 line with the
71 .B \-body
72 .I text
73 switch.  If the standard input has zero
74 length,
75 .B mhmail
76 will not send the message.  You can use the switch
77 .B \-body
78 \*(lr\*(rq to force an empty message.
79 .PP
80 Normally, addresses appearing as arguments are put in the \*(lqTo:\*(rq
81 field.  If the
82 .B \-cc
83 switch is used, all addresses following it are
84 placed in the \*(lqcc:\*(rq field.
85 .PP
86 By using
87 .B \-from
88 .IR addr ,
89 you can specify the \*(lqFrom:\*(rq header of
90 the draft.  Naturally,
91 .B post
92 will fill\-in the \*(lqSender:\*(rq
93 header correctly.
94
95 .SH FILES
96 .fc ^ ~
97 .nf
98 .ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
99 ^%bindir%/inc~^Program to incorporate maildrop into folder
100 ^%libdir%/post~^Program to deliver a message
101 ^/tmp/mhmail*~^Temporary copy of message
102 .fi
103
104 .SH "SEE ALSO"
105 inc(1), post(8)
106
107 .SH DEFAULTS
108 None
109
110 .SH CONTEXT
111 If
112 .B inc
113 is invoked, then
114 .BR inc 's
115 context changes occur.