lock_file.c: close(2) file descriptor on failure, avoiding leak.

[nmh] / man / mhmail.man

diff --git a/man/mhmail.man b/man/mhmail.man
index 6eacf1671cc79acb71d8c2910b9644d5c54f6445..43b8991b05ff738095f35b91fdd9abf52b1f7bd3 100644 (file)
--- a/man/mhmail.man
+++ b/man/mhmail.man
@@ -1,15 +1,17 @@
-.\"
+.TH MHMAIL %manext1% 2012-07-01 "%nmhversion%"
+.
 .\" %nmhwarning%
-.\"
-.TH MHMAIL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.
 .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
@@ -98,13 +95,12 @@ mhmail u2@example.com -resent < `mhpath cur`
 .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
@@ -223,26 +217,26 @@ is not used, or
 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
+.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 "' defaults to sender's local mailbox (localmbox)"
+.RB ` "\-from localmbox" '
 .RB ` \-profile "' is enabled by default only with " \-attach
 .RB ` \-send '
 .fi
-
 .SH CONTEXT
 If
 .B inc
@@ -253,3 +247,6 @@ context changes occur.  With the
 switch, the context of
 .B send
 is used.
+.B mhmail
+does not read the context file itself, so an entry for it will be
+ignored.