.B mhmail
.RI [ addrs
\&...]
+.RB [ \-attach
+.IR file ]
.RB [ \-body
.IR text ]
.RB [ \-cc
\&...]
.RB [ \-from
.IR addr ]
+.RB [ \-headerfield
+.IR name:value ]
.RB [ \-subject
.IR subject ]
.RB [ \-resent ]
.B dist
would do. For example:
.PP
- mhmail u2@example.com -resent < `mhpath cur`
+.RS 5
+.nf
+mhmail u2@example.com -resent < `mhpath cur`
+.fi
+.RE
.PP
By default,
.B mhmail
\*(lq\*(rq to force an empty message.
.PP
Normally, addresses appearing as arguments are put in the \*(lqTo:\*(rq
-field. If the
+field. At least one such address is required when sending a message,
+i.e., if any other switches are supplied. If the
.B \-cc
switch is used, all addresses following it, even if there are
intervening switches, are placed in the \*(lqcc:\*(rq field.
.B \-from
switch is used when sending,
.B mhmail
-will supply a \*(lqFrom:\*(rq header field using the sender's local mailbox.
+will supply a \*(lqFrom:\*(rq header field using the sender's local mailbox,
+see
+.I localmbox
+in
+.BR mh-format (5).
Naturally,
.B post
will fill\-in the \*(lqSender:\*(rq
header correctly.
.PP
The
+.B \-headerfield
+.I name:value
+switch adds a header field with the specified name and value to the
+message. (The
+.I value
+is called the
+.I field body
+in RFC 2822, but that's too easily confused with the message body.)
+There need not be a space after the colon that separates the
+name and value in the argument to this switch. It is usually best to
+enclose the argument in quotes to protect it from the shell. The
+.B \-headerfield
+switch may be given multiple times to add multiple header fields,
+for example,
+.PP
+.RS 5
+.nf
+mhmail -from sender@example.com \\
+-headerfield 'MIME-Version:1.0' \\
+-headerfield 'Content-Type:text/plain; charset=utf-8' \\
+-headerfield 'Content-Transfer-Encoding:8bit' \\
+recipient@example.com
+.fi
+.RE
+.PP
+Note about this example: the
+.B \-attach
+switch causes
+.I MIME-Version
+and
+.I Content-Type
+headers to be added to the message.
+.PP
+The
.B \-profile
switch instructs
.B mhmail
to send the message. This allows use of the user's context and aliases.
.PP
The
+.B \-attach
+.I file
+switch attaches the specified file to the message. Use of
+.B \-attach
+enables
+.B \-profile
+because
+.B mhmail
+uses
+.B send
+to handle the attachment. It is usually best to enclose the argument
+in quotes to protect it from the shell. The
+.B \-attach
+switch may be given multiple times to add multiple attachments.
+.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.
.fi
.SH "SEE ALSO"
-dist(1), inc(1), post(8), send(1)
+dist(1), inc(1), mh-format(5), post(8), send(1)
.SH DEFAULTS
+.nf
+.RB ` \-from "' defaults to sender's local mailbox (localmbox)"
+.RB ` \-profile "' is enabled by default only with " \-attach
.RB ` \-send '
+.fi
.SH CONTEXT
If