Added all of the MH sources, including RCS files, in
[mmh] / docs / historical / mh-6.8.5 / conf / doc / mhmail.rf
1 .\"     @(MHWARNING)
2 .\" @(#)$Id: mhmail.rf,v 1.5 90/04/05 15:13:18 sources Exp $
3 .SC MHMAIL 1
4 .NA
5 mhmail \- send or read mail
6 .SY
7 mhmail
8 \%[
9 addrs\ ... 
10 \%[\-body\ text]
11 \%[\-cc\ addrs\ ...]
12 \%[\-from\ addr]
13 \%[\-subject subject]]
14 \%[\-help]
15 .DE
16 \fIMHmail\fR
17 is intended as a replacement for the standard Bell mail program
18 (\fIbellmail\fR\0(1)), compatible with \fIMH\fR.
19 When invoked without arguments, it simply 
20 invokes \fIinc\fR\0(1)
21 to incorporate new messages from the user's maildrop.
22 When one or more users is specified, a message is read from
23 the standard input and spooled to a temporary file.
24 \fIMHmail\fR then invokes \fIpost\fR\0(8)
25 with the name of the temporary file as
26 its argument to deliver the message to the specified user.
27
28 The `\-subject\ subject' switch can be used to specify the \*(lqSubject:\*(rq field
29 of the message.  The `\-body\ text' switch can be used to specify the text of
30 the message; if it is specified, then the standard input is not read.
31 Normally, addresses appearing as arguments are put in the \*(lqTo:\*(rq field.
32 If the `\-cc' switch is used, all addresses following it are placed in the
33 \*(lqcc:\*(rq field.
34
35 By using `\-from\ addr',
36 you can specify the \*(lqFrom:\*(rq header of the draft.
37 Naturally,
38 \fIpost\fR will fill\-in the \*(lqSender:\*(rq header correctly.
39
40 This program is intended for the use of programs 
41 such as \fIat\fR\0(1), which expect
42 to send mail automatically to various users.
43 Normally, real people (as opposed to the \*(lqunreal\*(rq ones)
44 will prefer to use \fIcomp\fR\0(1) and \fIsend\fR\0(1) to send messages.
45 .Fi
46 ^@(MHBINPATH)/inc~^Program to incorporate a maildrop into a folder
47 ^@(MHETCPATH)/post~^Program to deliver a message
48 ^/tmp/mhmail*~^Temporary copy of message
49 .Pr
50 None
51 .Sa
52 inc(1), post(8)
53 .De
54 None
55 .Co
56 If \fIinc\fR is invoked, then \fIinc\fR's context changes occur.
57 .En