.\"
.\" %nmhwarning%
.\" $Id$
.\"
.\" include the -mh macro file
.so %etcdir%/tmac.h
.\"
.TH MHMAIL %manext1% MH.6.8 [%nmhversion%]
.SH NAME
mhmail \- send or read mail
.SH SYNOPSIS
.in +.5i
.ti -.5i
mhmail
\%[
addrs\ ... 
\%[\-body\ text]
\%[\-cc\ addrs\ ...]
.br
\%[\-from\ addr]
\%[\-subject subject]]
.br
\%[\-version]
\%[\-help]
.in -.5i
.SH DESCRIPTION
\fImhmail\fR is intended as a replacement for the standard Berkeley
mail program (\fImail\fR(1) or \fImailx\fR(1)), which is compatible
with \fInmh\fR.  This program is intended for the use of programs such
as \fIcron\fR(1), which expect to send mail automatically to various
users.  It is also used by various \fInmh\fR commands to mail various
error notifications.  Although \fImhmail\fR can be used interactively,
it is recommended that \fIcomp\fR(1) and \fIsend\fR(1) be used instead
to send messages.

When invoked without arguments, it simply invokes \fIinc\fR(1) to
incorporate new messages from the user's maildrop.  When one or more users
is specified, a message is read from the standard input and spooled to
a temporary file.  \fImhmail\fR then invokes \fIpost\fR(8) with the
name of the temporary file as its argument to deliver the message to
the specified user.

The `\-subject\ subject' switch can be used to specify the
\*(lqSubject:\*(rq field of the message.

By default, \fImhmail\fR will read the message to be sent from the
standard input.  You can specify the text of the message at the command
line with the `\-body\ text' switch.  If the standard input has zero
length, \fImhmail\fR will not send the message.  You can use the switch
`\-body\ ""' to force an empty message.

Normally, addresses appearing as arguments are put in the \*(lqTo:\*(rq
field.  If the `\-cc' switch is used, all addresses following it are
placed in the \*(lqcc:\*(rq field.

By using `\-from\ addr', you can specify the \*(lqFrom:\*(rq header of
the draft.  Naturally, \fIpost\fR will fill\-in the \*(lqSender:\*(rq
header correctly.
.Fi
^%bindir%/inc~^Program to incorporate maildrop into folder
^%libdir%/post~^Program to deliver a message
^/tmp/mhmail*~^Temporary copy of message
.Pr
None
.Sa
inc(1), post(8)
.De
None
.Co
If \fIinc\fR is invoked, then \fIinc\fR's context changes occur.
.En