mhmail now supports -profile -resend.

[mmh] / man / mhmail.man

diff --git a/man/mhmail.man b/man/mhmail.man
index 9f92776..fb271e1 100644 (file)
--- a/man/mhmail.man
+++ b/man/mhmail.man
@@ -1,6 +1,5 @@
 .\"
 .\" %nmhwarning%
-.\" $Id$
 .\"
 .TH MHMAIL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
@@ -15,13 +14,22 @@ mhmail \- send or read mail
 .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
@@ -65,6 +73,15 @@ The
 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
@@ -75,43 +92,82 @@ line with 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.