Added -attach switch to mhmail.

[mmh] / man / mhmail.man

diff --git a/man/mhmail.man b/man/mhmail.man
index cf8e73a..3b382af 100644 (file)
--- a/man/mhmail.man
+++ b/man/mhmail.man
@@ -10,6 +10,8 @@ mhmail \- send or read mail
 .B mhmail
 .RI [ addrs
 \&...]
 .B mhmail
 .RI [ addrs
 \&...]

+.RB [ \-attach
+.IR file ]

 .RB [ \-body
 .IR text ]
 .RB [ \-cc
 .RB [ \-body
 .IR text ]
 .RB [ \-cc

@@ -17,6 +19,8 @@ mhmail \- send or read mail
 \&...]
 .RB [ \-from
 .IR addr ]
 \&...]
 .RB [ \-from
 .IR addr ]

+.RB [ \-header\-field
+.IR name:body ]

 .RB [ \-subject
 .IR subject ]
 .RB [ \-resent ]
 .RB [ \-subject
 .IR subject ]
 .RB [ \-resent ]

@@ -27,9 +31,9 @@ mhmail \- send or read mail
 [switches\ for
 .I send
 \&...]]
 [switches\ for
 .I send
 \&...]]

+.RB [ \-send " | " \-nosend ]

 .RB [ \-version ]
 .RB [ \-help ]
 .RB [ \-version ]
 .RB [ \-help ]

-.RB [ \-debug ]

 .ad
 .SH DESCRIPTION
 .B mhmail
 .ad
 .SH DESCRIPTION
 .B mhmail

@@ -80,7 +84,11 @@ will be resent, as
 .B dist
 would do.  For example:
 .PP
 .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
 .PP
 By default,
 .B mhmail

@@ -117,6 +125,35 @@ will fill\-in the \*(lqSender:\*(rq
 header correctly.
 .PP
 The
 header correctly.
 .PP
 The

+.B \-header\-field
+.I name:body
+switch adds a header field with the specified name and body to the
+message.  There need not be a space after the colon that separates the
+name and body in the argument to this switch.  It is usually best to
+enclose the argument in quotes to protect it from the shell.  The
+.B \-header\-field
+switch may be given multiple times to add multiple header fields,
+for example,
+.PP
+.RS 5
+.nf
+mhmail -from sender@example.com \\
+-header\-field 'MIME-Version:1.0' \\
+-header\-field 'Content-Type:text/plain; charset=utf-8' \\
+-header\-field '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
 .B \-profile
 switch instructs
 .B mhmail

@@ -127,10 +164,30 @@ instead of
 to send the message.  This allows use of the user's context and aliases.
 .PP
 The
 to send the message.  This allows use of the user's context and aliases.
 .PP
 The

-.B \-debug
-option shows the draft file that would be posted/sent and the command
-that would be used to post/send the draft, but does not post or send
-it.
+.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.
+.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
 .PP
 All other switches are passed on to
 .B post

@@ -155,7 +212,12 @@ is used.
 dist(1), inc(1), post(8), send(1)
 
 .SH DEFAULTS
 dist(1), inc(1), post(8), send(1)
 
 .SH DEFAULTS

-None
+.nf
+.RB ` \-send '
+.fi
+.RB ` \-profile' ,
+enabled by default only with
+.B \-attach

 
 .SH CONTEXT
 If
 
 .SH CONTEXT
 If