X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;ds=sidebyside;f=man%2Fmhmail.man;h=c1c8149134023ebef3c7bd3e0abddb4349e8e4a7;hb=702512891eb9936eab9626558387b6d2188d3a2c;hp=9e324212491fad3169af18cf669a4cabdccf89b2;hpb=b36e2ab7892cdf30a8b33d02e00af70398013b5d;p=mmh

diff --git a/man/mhmail.man b/man/mhmail.man
index 9e32421..c1c8149 100644
--- a/man/mhmail.man
+++ b/man/mhmail.man
@@ -1,71 +1,159 @@
 .\"
 .\" %nmhwarning%
-.\" $Id$
-.\"
-.\" include the -mh macro file
-.so %etcdir%/tmac.h
 .\"
 .TH MHMAIL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 mhmail \- send or read mail
 .SH SYNOPSIS
-.in +.5i
-.ti -.5i
-mhmail
-\%[
-addrs\ ... 
-\%[\-body\ text]
-\%[\-cc\ addrs\ ...]
-.br
-\%[\-from\ addr]
-\%[\-subject subject]]
-.br
-\%[\-version]
-\%[\-help]
-.in -.5i
+.HP 5
+.na
+.B mhmail
+.RI [ addrs
+\&...]
+.RB [ \-body
+.IR text ]
+.RB [ \-cc
+.I addrs
+\&...]
+.RB [ \-from
+.IR addr ]
+.RB [ \-subject
+.IR subject ]
+[switches\ for
+.I post
+\&... |
+.RB \-profile
+[switches\ for
+.I send
+\&...]]
+.RB [ \-version ]
+.RB [ \-help ]
+.RB [ \-debug ]
+.ad
 .SH DESCRIPTION
-\fImhmail\fR is intended as a replacement for the standard Berkeley
-mail program (\fImail\fR(1) or \fImailx\fR(1)), which is compatible
-with \fInmh\fR.  This program is intended for the use of programs such
-as \fIcron\fR(1), which expect to send mail automatically to various
-users.  It is also used by various \fInmh\fR commands to mail various
-error notifications.  Although \fImhmail\fR can be used interactively,
-it is recommended that \fIcomp\fR(1) and \fIsend\fR(1) be used instead
-to send messages.
-
-When invoked without arguments, it simply invokes \fIinc\fR(1) to
-incorporate new messages from the user's maildrop.  When one or more users
+.B mhmail
+is intended as a replacement for the standard Berkeley
+mail program
+.RB ( mail
+or
+.BR mailx ),
+which is compatible with
+.BR nmh .
+This program is intended for the use of programs such as
+.BR cron ,
+which expect to send mail automatically to various
+users.  It is also used by various
+.B nmh
+commands to mail various
+error notifications.  Although
+.B mhmail
+can be used interactively,
+it is recommended that
+.B comp
+and
+.B send
+be used instead to send messages.
+.PP
+When invoked without arguments, it simply invokes
+.B inc
+to incorporate new messages from the user's maildrop.  When one or more users
 is specified, a message is read from the standard input and spooled to
-a temporary file.  \fImhmail\fR then invokes \fIpost\fR(8) with the
+a temporary file.
+.B mhmail
+then invokes
+.B post
+with the
 name of the temporary file as its argument to deliver the message to
 the specified user.
-
-The `\-subject\ subject' switch can be used to specify the
+.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 \-subject
+.I subject
+switch can be used to specify the
 \*(lqSubject:\*(rq field of the message.
-
-By default, \fImhmail\fR will read the message to be sent from the
+.PP
+By default,
+.B mhmail
+will read the message to be sent from the
 standard input.  You can specify the text of the message at the command
-line with the `\-body\ text' switch.  If the standard input has zero
-length, \fImhmail\fR will not send the message.  You can use the switch
-`\-body\ ""' to force an empty message.
-
+line with the
+.B \-body
+.I text
+switch.  If the standard input has zero
+length,
+.B mhmail
+will not send the message and return with status 1.  You can use the switch
+.B \-body
+\*(lq\*(rq to force an empty message.
+.PP
 Normally, addresses appearing as arguments are put in the \*(lqTo:\*(rq
-field.  If the `\-cc' switch is used, all addresses following it are
-placed in the \*(lqcc:\*(rq field.
-
-By using `\-from\ addr', you can specify the \*(lqFrom:\*(rq header of
-the draft.  Naturally, \fIpost\fR will fill\-in the \*(lqSender:\*(rq
+field.  If the
+.B \-cc
+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.  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.
-.Fi
+.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.
+.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'%etcdir%/ExtraBigFileName  'u
 ^%bindir%/inc~^Program to incorporate maildrop into folder
 ^%libdir%/post~^Program to deliver a message
 ^/tmp/mhmail*~^Temporary copy of message
-.Pr
-None
-.Sa
-inc(1), post(8)
-.De
+.fi
+
+.SH "SEE ALSO"
+inc(1), post(8), send(1)
+
+.SH DEFAULTS
 None
-.Co
-If \fIinc\fR is invoked, then \fIinc\fR's context changes occur.
-.En
+
+.SH CONTEXT
+If
+.B inc
+is invoked, then
+.BR inc 's
+context changes occur.  With the
+.B \-profile
+switch, the context of
+.B send
+is used.