78567d87cb7c5b684bf15119d2de8fe9172267a9
[mmh] / man / mhmail.man1
1 .\"
2 .\" %nmhwarning%
3 .\"
4 .TH MHMAIL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
5 .SH NAME
6 mhmail \- send mail
7 .SH SYNOPSIS
8 .HP 5
9 .na
10 .B mhmail
11 .IR addrs ...
12 .RB [ \-cc
13 .IR addrs ...]
14 .RB [ \-from
15 .IR addr ]
16 .RB [ \-subject
17 .IR subject ]
18 .RB [ \-bodytext
19 .IR text ]
20 .RB [ \-Version ]
21 .RB [ \-help ]
22 .ad
23 .SH DESCRIPTION
24 .B mhmail
25 is intended as an
26 .BR mmh -compatible
27 replacement for the standard Berkeley
28 mail program
29 .RB ( mail
30 or
31 .BR mailx ).
32 This program is intended for the use of programs such as
33 .BR cron ,
34 which expect to send mail automatically to various
35 addresses.  It is also used by various
36 .B nmh
37 commands to mail various
38 error notifications.
39 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 one or more addresses
49 are specified, a message is read from the standard input and spooled to
50 a temporary file.
51 .B mhmail
52 then invokes
53 .B spost
54 to deliver the message.
55 .PP
56 .B mhmail
57 can not be used for mal reading. Use
58 .BR inc ,
59 .BR scan ,
60 .B show
61 instead.
62 .PP
63 The
64 .B \-subject
65 .I subject
66 switch can be used to specify the
67 `Subject:' field of the message.
68 .PP
69 By default,
70 .B mhmail
71 will read the message to be sent from the
72 standard input.
73 The message is terminated by either end-of-file or by a single period
74 alone on a line. This is compatible to
75 .B mail
76 and
77 .BR mailx .
78 Alternatively, you can specify the text of the message at the command
79 line with the
80 .B \-bodytext
81 .I text
82 switch.
83 .PP
84 If the standard input has zero length,
85 .B mhmail
86 will not send the message.  You can use
87 .B \-bodytext
88 "" to force an empty message.
89 .PP
90 Normally, addresses appearing as arguments are put in the `To:'
91 field.  If the
92 .B \-cc
93 switch is used, all addresses following it are
94 placed in the `Cc:' field.
95 .PP
96 By using
97 .B \-from
98 .IR addr ,
99 you can specify the `From:' header of
100 the draft.  Naturally,
101 .B post
102 will fill\-in the `Sender:'
103 header correctly.
104
105 .SH FILES
106 .fc ^ ~
107 .nf
108 .ta \w'%etcdir%/BigFileName  'u
109 ^/tmp/mhmail*~^Temporary copy of message
110 .fi
111
112 .SH "SEE ALSO"
113 inc(1), scan(1), show(1), post(8)
114
115 .SH DEFAULTS
116 None
117
118 .SH CONTEXT
119 None