Truncated -help test in test-whom because its output depends on whether

[nmh] / man / mhmail.man

diff --git a/man/mhmail.man b/man/mhmail.man
index 3abd6d3b049be279b34c6e3d7cf26cb5f40581ff..4f1635a414874158d29901b17d1f4aa0b8dfbd56 100644 (file)
--- a/man/mhmail.man
+++ b/man/mhmail.man
@@ -10,6 +10,8 @@ mhmail \- send or read mail
 .B mhmail
 .RI [ addrs
 \&...]
+.RB [ \-attach
+.IR file ]
 .RB [ \-body
 .IR text ]
 .RB [ \-cc
@@ -103,7 +105,8 @@ will not send the message and return with status 1.  You can use the switch
 \*(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.
@@ -116,7 +119,11 @@ 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.
+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
@@ -143,6 +150,14 @@ 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
@@ -154,6 +169,22 @@ instead of
 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.
@@ -183,10 +214,14 @@ is used.
 .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