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 cc36ce2856dab2fc506535ebd3531106acc68b8a..43b8991b05ff738095f35b91fdd9abf52b1f7bd3 100644 (file)
--- a/man/mhmail.man
+++ b/man/mhmail.man
@@ -1,15 +1,17 @@
-.TH MHMAIL %manext1% "October 16, 2012" "%nmhversion%"
-.\"
+.TH MHMAIL %manext1% 2012-07-01 "%nmhversion%"
+.

 .\" %nmhwarning%
 .\" %nmhwarning%

-.\"
+.

 .SH NAME
 .SH NAME

-mhmail \- send or read mail
+mhmail \- send or read mail non-interactively with nmh

 .SH SYNOPSIS
 .HP 5
 .na
 .B mhmail
 .SH SYNOPSIS
 .HP 5
 .na
 .B mhmail

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

 .RB [ \-to ]
 .RB [ \-to ]

-.RI addrs
+.I addrs

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


@@ -28,14 +30,11 @@ mhmail \- send or read mail
 [switches\ for
 .I post
 \&... |
 [switches\ for
 .I post
 \&... |

-.RB \-profile
+.B \-profile

 [switches\ for
 .I send
 \&...]]
 .RB [ \-send " | " \-nosend ]
 [switches\ for
 .I send
 \&...]]
 .RB [ \-send " | " \-nosend ]

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

 .HP 5
 .B mhmail
 with no arguments is equivalent to
 .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
 .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
 .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 ,
 .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
 .B nmh

-commands to mail various
-error notifications.  Although
+commands to mail error notifications.  Although

 .B mhmail
 .B mhmail

-can be used interactively,
-it is recommended that
+can be used interactively, it is recommended that

 .B comp
 and
 .B send
 .B comp
 and
 .B send

-be used instead to send messages.
+be used instead, to send messages.

 .PP
 .PP

-When invoked without arguments, it simply invokes
+When invoked without arguments,
+.B mhmail
+simply invokes

 .B inc
 .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
 .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
 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
 \*(lqSubject:\*(rq field of the message.
 .PP
 The


@@ -98,13 +95,12 @@ mhmail u2@example.com -resent < `mhpath cur`
 .PP
 By default,
 .B mhmail
 .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
 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
 .B mhmail
 will not send the message and return with status 1.  You can use the switch
 .B \-body


@@ -129,8 +125,7 @@ switches may be given multiple times.
 By using
 .B \-from
 .IR addr ,
 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
 .B \-from
 switch is used when sending,
 .B mhmail


@@ -141,8 +136,7 @@ in
 .IR mh-format (5).
 Naturally,
 .B post
 .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
 .PP
 The
 .B \-headerfield


@@ -214,7 +208,7 @@ can be used to disable
 .BR \-nosend ,
 for example, when using a shell alias.
 .PP
 .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
 .B post
 if
 .B \-profile


@@ -227,15 +221,15 @@ is used.
 .fc ^ ~
 .nf
 .ta \w'%nmhetcdir%/ExtraBigFileName  'u
 .fc ^ ~
 .nf
 .ta \w'%nmhetcdir%/ExtraBigFileName  'u

-^%bindir%/inc~^Program to incorporate maildrop into folder
+^%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"
 .IR dist (1),
 ^%nmhlibexecdir%/post~^Program to deliver a message
 ^/tmp/mhmail*~^Temporary copy of message
 .fi
 .SH "SEE ALSO"
 .IR dist (1),

-.IR inc (1),

 .IR send (1),
 .IR mh-format (5),
 .IR send (1),
 .IR mh-format (5),

+.IR send (1),

 .IR post (8)
 .SH DEFAULTS
 .nf
 .IR post (8)
 .SH DEFAULTS
 .nf