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