]> diplodocus.org Git - nmh/blobdiff - man/mhmail.man
Fix invalid pointer arithmetic.
[nmh] / man / mhmail.man
index f6620c0a9a6c81110db59c665bbb463a77610356..5b7fec264ad45624daf2a859ad6d0b12f9ea33ff 100644 (file)
@@ -1,15 +1,17 @@
-.TH MHMAIL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
-.\"
+.TH MHMAIL %manext1% 2012-07-01 "%nmhversion%"
+.
 .\" %nmhwarning%
-.\"
+.
 .SH NAME
-mhmail \- send or read mail
+mhmail \- send or read mail non-interactively with nmh
 .SH SYNOPSIS
 .HP 5
 .na
 .B mhmail
+.RB [ \-help ]
+.RB [ \-version ]
 .RB [ \-to ]
-.RI addrs
+.I addrs
 \&...
 .RB [ \-attach
 .IR file ]
@@ -28,14 +30,11 @@ mhmail \- send or read mail
 [switches\ for
 .I post
 \&... |
-.RB \-profile
+.B \-profile
 [switches\ for
 .I send
 \&...]]
 .RB [ \-send " | " \-nosend ]
-.RB [ \-version ]
-.RB [ \-help ]
-.PP
 .HP 5
 .B mhmail
 with no arguments is equivalent to
@@ -43,44 +42,42 @@ with no arguments is equivalent to
 .ad
 .SH DESCRIPTION
 .B mhmail
-is intended as a replacement for the standard Berkeley
-mail program
+is intended as a replacement, compatible with
+.BR nmh ,
+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 mailx ).
+.B nmh
+is intended for the use of programs such as
 .BR cron ,
-which expect to send mail automatically to various addresses.  It is
-also used by various
+which expect to send mail automatically.  It is also used by some
 .B nmh
-commands to mail various
-error notifications.  Although
+commands to mail error notifications.  Although
 .B mhmail
-can be used interactively,
-it is recommended that
+can be used interactively, it is recommended that
 .B comp
 and
 .B send
-be used instead to send messages.
+be used instead, to send messages.
 .PP
-When invoked without arguments, it simply invokes
+When invoked without arguments,
+.B mhmail
+simply invokes
 .B inc
-to incorporate new messages from the user's maildrop.
+to incorporate new messages from the user's mail drop.
 .PP
 When one or more addresses are specified, a message is read from the
 standard input and spooled to a temporary file.
 .B mhmail
 then invokes
-.BR post ,
+by default, with the name of the temporary file as its argument, to
 by default, with the name of the temporary file as its argument to
 deliver the message to the specified address.
 .PP
 The
 .B \-subject
-.I subject
-switch can be used to specify the
+switch can be used to specify the \*(lqSubject:\*(rq field of the message.
 \*(lqSubject:\*(rq field of the message.
 .PP
 The
@@ -92,19 +89,18 @@ would do.  For example:
 .PP
 .RS 5
 .nf
-mhmail u2@example.com -resent < `mhpath cur`
+mhmail u2@example.com -resent <\`mhpath cur\`
 .fi
 .RE
 .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
+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
 .B \-body
 .I text
-switch.  If the standard input has zero
-length,
+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
@@ -112,7 +108,7 @@ will not send the message and return with status 1.  You can use the switch
 .PP
 Normally, addresses appearing as arguments are put in the \*(lqTo:\*(rq
 field.  At least one such address is required when sending a message,
-i.e., if any other switches are supplied. If the
+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 other than
@@ -129,8 +125,7 @@ switches may be given multiple times.
 By using
 .B \-from
 .IR addr ,
-you can specify the \*(lqFrom:\*(rq header of
-the draft.  If no
+you can specify the \*(lqFrom:\*(rq header of the draft.  If no
 .B \-from
 switch is used when sending,
 .B mhmail
@@ -138,11 +133,10 @@ will supply a \*(lqFrom:\*(rq header field using the sender's local mailbox,
 see
 .I localmbox
 in
-.BR mh-format (5).
+.IR mh-format (5).
 Naturally,
 .B post
-will fill\-in the \*(lqSender:\*(rq
-header correctly.
+will fill in the \*(lqSender:\*(rq header correctly.
 .PP
 The
 .B \-headerfield
@@ -214,7 +208,7 @@ can be used to disable
 .BR \-nosend ,
 for example, when using a shell alias.
 .PP
-All other switches are passed on to
+All other switches are passed to
 .B post
 if
 .B \-profile
@@ -226,13 +220,17 @@ 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
+.ta \w'%nmhetcdir%/ExtraBigFileName  'u
+^%bindir%/inc~^Program to incorporate mail drop into folder
+^%nmhlibexecdir%/post~^Program to deliver a message
 ^/tmp/mhmail*~^Temporary copy of message
 .fi
 .SH "SEE ALSO"
-dist(1), inc(1), mh-format(5), post(8), send(1)
+.IR dist (1),
+.IR send (1),
+.IR mh-format (5),
+.IR send (1),
+.IR post (8)
 .SH DEFAULTS
 .nf
 .RB ` "\-from localmbox" '