.\"
.\" %nmhwarning%
-.\" $Id$
.\"
.TH MHMAIL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
mhmail \- send or read mail
.SH SYNOPSIS
.HP 5
+.na
.B mhmail
.RI [ addrs
\&...]
.IR text ]
.RB [ \-cc
.I addrs
-...]
+\&...]
.RB [ \-from
.IR addr ]
.RB [ \-subject
.IR subject ]
+.RB [ \-resent ]
+[switches\ for
+.I post
+\&... |
+.RB \-profile
+[switches\ for
+.I send
+\&...]]
+.RB [ \-send " | " \-nosend ]
.RB [ \-version ]
-.RB [ \-help ]
+.RB [ \-help ]
+.ad
.SH DESCRIPTION
.B mhmail
is intended as a replacement for the standard Berkeley
switch can be used to specify the
\*(lqSubject:\*(rq field of the message.
.PP
+The
+.B \-resent
+switch indicates that the message body is a fully formed message that
+will be resent, as
+.B dist
+would do. For example:
+.PP
+ mhmail u2@example.com -resent < `mhpath cur`
+.PP
By default,
.B mhmail
will read the message to be sent from the
switch. If the standard input has zero
length,
.B mhmail
-will not send the message. You can use the switch
+will not send the message and return with status 1. You can use the switch
.B \-body
-\*(lr\*(rq to force an empty message.
+\*(lq\*(rq to force an empty message.
.PP
Normally, addresses appearing as arguments are put in the \*(lqTo:\*(rq
field. If the
.B \-cc
-switch is used, all addresses following it are
-placed in the \*(lqcc:\*(rq field.
+switch is used, all addresses following it, even if there are
+intervening switches, are placed in the \*(lqcc:\*(rq field.
.PP
By using
.B \-from
.IR addr ,
you can specify the \*(lqFrom:\*(rq header of
-the draft. Naturally,
+the draft. If no
+.B \-from
+switch is used when sending,
+.B mhmail
+will supply a \*(lqFrom:\*(rq header field using the sender's local mailbox.
+Naturally,
.B post
will fill\-in the \*(lqSender:\*(rq
header correctly.
+.PP
+The
+.B \-profile
+switch instructs
+.B mhmail
+to use
+.B send
+instead of
+.B post
+to send the message. This allows use of the user's context and aliases.
+.PP
+The
+.B \-nosend
+option shows the draft file that would be posted/sent on the command's
+standard output but does not post or send it.
+.B \-send
+provides the default behavior of posting or sending the message. It
+can be used to disable
+.BR \-nosend ,
+for example, when using a shell alias.
+.PP
+All other switches are passed on to
+.B post
+if
+.B \-profile
+is not used, or
+.B send
+if
+.B \-profile
+is used.
.SH FILES
.fc ^ ~
.nf
-.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
+.ta \w'%etcdir%/ExtraBigFileName 'u
^%bindir%/inc~^Program to incorporate maildrop into folder
^%libdir%/post~^Program to deliver a message
^/tmp/mhmail*~^Temporary copy of message
.fi
.SH "SEE ALSO"
-inc(1), post(8)
+dist(1), inc(1), post(8), send(1)
.SH DEFAULTS
-None
+.RB ` \-send '
.SH CONTEXT
If
.B inc
is invoked, then
.BR inc 's
-context changes occur.
+context changes occur. With the
+.B \-profile
+switch, the context of
+.B send
+is used.