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

[nmh] / man / prompter.man

diff --git a/man/prompter.man b/man/prompter.man
index 9b327a1d109d6b2ed8f7ffb42fa894cfe258799a..b6471dd4c8aae5ecb353794812b6407bea166d3c 100644 (file)
--- a/man/prompter.man
+++ b/man/prompter.man
@@ -1,13 +1,15 @@
-.TH PROMPTER %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
-.\"
+.TH PROMPTER %manext1% 1999-04-30 "%nmhversion%"
+.

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

-.\"
+.

 .SH NAME
 .SH NAME

-prompter \- prompting editor front-end for nmh
+prompter \- nmh's prompting editor front-end

 .SH SYNOPSIS
 .HP 5
 .na
 .B prompter
 .SH SYNOPSIS
 .HP 5
 .na
 .B prompter

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

 .RB [ \-erase
 .IR chr ]
 .RB [ \-kill
 .RB [ \-erase
 .IR chr ]
 .RB [ \-kill


@@ -16,17 +18,15 @@ prompter \- prompting editor front-end for nmh
 .RB [ \-rapid " | " \-norapid ]
 .RB [ \-doteof " | " \-nodoteof ]
 .I file
 .RB [ \-rapid " | " \-norapid ]
 .RB [ \-doteof " | " \-nodoteof ]
 .I file

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

 .ad
 .SH DESCRIPTION
 .ad
 .SH DESCRIPTION

-.B Prompter
-is an editor front\-end for
+.B prompter
+is an editor front-end for

 .B nmh
 .B nmh

-which allows rapid
-composition of messages.  This program is not normally invoked directly by
-users but takes the place of an editor and acts as an editor front\-end.
-It operates on an RFC\-822 style message draft skeleton specified by
+which allows rapid composition of messages.
+This program is not normally invoked directly by users but takes
+the place of an editor and acts as an editor front-end.
+It operates on an RFC 822-style message draft skeleton specified by

 .IR file ,
 normally provided by the
 .B nmh
 .IR file ,
 normally provided by the
 .B nmh


@@ -37,19 +37,21 @@ commands
 or
 .BR repl .
 .PP
 or
 .BR repl .
 .PP

-.B Prompter
+.B prompter

 is particularly useful when composing messages over slow
 network or modem lines.  It is an
 is particularly useful when composing messages over slow
 network or modem lines.  It is an

-.B nmh program in that it can have
-its own profile entry with switches, but it is not invoked directly by
-the user.  The commands
+.B nmh
+program in that it can have its own profile entry with switches,
+but it is not invoked directly by the user.
+The commands

 .BR comp ,
 .BR dist ,
 .BR forw ,
 and
 .B repl
 invoke
 .BR comp ,
 .BR dist ,
 .BR forw ,
 and
 .B repl
 invoke

-.B prompter as an editor, either when invoked with
+.B prompter
+as an editor, either when invoked with

 .B \-editor
 .IR prompter ,
 or by the profile entry \*(lqEditor:\ prompter\*(rq,
 .B \-editor
 .IR prompter ,
 or by the profile entry \*(lqEditor:\ prompter\*(rq,


@@ -59,19 +61,20 @@ or when given the command
 at the \*(lqWhat now?\*(rq prompt.
 .PP
 For each empty component
 at the \*(lqWhat now?\*(rq prompt.
 .PP
 For each empty component

-.B prompter finds in the draft, the user
-is prompted for a response; A <RETURN> will cause the whole component
-to be left out.  Otherwise, a `\\' preceding a <RETURN> will continue
-the response on the next line, allowing for multiline components.
+.B prompter
+finds in the draft, the user is prompted for a response;
+A <RETURN> will cause the whole component to be left out.
+Otherwise, a `\\' preceding a <RETURN> will continue the
+response on the next line, allowing for multiline components.

 Continuation lines
 Continuation lines

-.B must
+.I must

 begin with a space or tab.
 .PP
 begin with a space or tab.
 .PP

-Each non\-empty component is copied to the draft and displayed on the
+Each non-empty component is copied to the draft and displayed on the

 terminal.
 .PP
 The start of the message body is denoted by a blank line or a line
 terminal.
 .PP
 The start of the message body is denoted by a blank line or a line

-of dashes.  If the body is non\-empty, the prompt, which isn't written
+of dashes.  If the body is non-empty, the prompt, which isn't written

 to the file, is
 .PP
 .RS 5
 to the file, is
 .PP
 .RS 5


@@ -86,29 +89,29 @@ was given)
 --------Enter initial text
 .RE
 .PP
 --------Enter initial text
 .RE
 .PP

-Message\-body typing is terminated with an end\-of\-file (usually
-CTRL\-D).  With the
+Message-body typing is terminated with an end-of-file (usually
+CTRL-D).  With the

 .B \-doteof
 .B \-doteof

-switch, a period on a line all by itself
-also signifies end\-of\-file.  At this point control is returned to
-the calling program, where the user is asked \*(lqWhat now?\*(rq.
+switch, a period on a line all by itself also signifies end-of-file.
+At this point control is returned to the calling program,
+where the user is asked \*(lqWhat now?\*(rq.

 See
 See

-.B whatnow (1)
+.IR whatnow (1)

 for the valid options to this query.
 .PP
 By using the
 .B \-prepend
 for the valid options to this query.
 .PP
 By using the
 .B \-prepend

-switch, the user can add type\-in to the
-beginning of the message body and have the rest of the body follow.
+switch, the user can add type-in to the beginning of the message body
+and have the rest of the body follow.

 This is useful for the
 .B forw
 command.
 .PP
 By using the
 .B \-rapid
 This is useful for the
 .B forw
 command.
 .PP
 By using the
 .B \-rapid

-switch, if the draft already contains text in
-the message\-body, it is not displayed on the user's terminal.  This is
-useful for low\-speed terminals.
+switch, if the draft already contains text in the message-body, it is
+not displayed on the user's terminal.  This is useful for low-speed
+terminals.

 .PP
 The line editing characters for kill and erase may be specified by the
 user via the arguments
 .PP
 The line editing characters for kill and erase may be specified by the
 user via the arguments


@@ -122,30 +125,29 @@ where
 may be a character; or `\\nnn', where \*(lqnnn\*(rq is the octal value for
 the character.
 .PP
 may be a character; or `\\nnn', where \*(lqnnn\*(rq is the octal value for
 the character.
 .PP

-An interrupt (usually CTRL\-C) during component typing will abort
+An interrupt (usually CTRL-C) during component typing will abort

 .B prompter
 and the
 .B nmh
 .B prompter
 and the
 .B nmh

-command that invoked it.  An interrupt
-during message\-body typing is equivalent to CTRL\-D, for historical
-reasons.  This means that
+command that invoked it.  An interrupt during message-body typing is
+equivalent to CTRL-D, for historical reasons.
+This means that

 .B prompter
 should finish up and exit.
 .PP
 .B prompter
 should finish up and exit.
 .PP

-The first non\-flag argument to
-.B prompter is taken as the name of
-the draft file, and subsequent non\-flag arguments are ignored.
-.\" (\fIRepl\fR invokes editors with two file arguments:
-.\" the draft file name and the replied\-to message file name.)
-
+The first non-flag argument to
+.B prompter
+is taken as the name of the draft file, and subsequent non-flag
+arguments are ignored.
+.\" (\fIrepl\fR invokes editors with two file arguments:
+.\" the draft file name and the replied-to message file name.)

 .SH FILES
 .fc ^ ~
 .nf
 .SH FILES
 .fc ^ ~
 .nf

-.ta \w'%etcdir%/ExtraBigFileName  'u
-^$HOME/\&.mh\(ruprofile~^The user profile
+.ta \w'%nmhetcdir%/ExtraBigFileName  'u
+^$HOME/.mh_profile~^The user profile

 ^/tmp/prompter*~^Temporary copy of message
 .fi
 ^/tmp/prompter*~^Temporary copy of message
 .fi

-

 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf


@@ -154,20 +156,20 @@ the draft file, and subsequent non\-flag arguments are ignored.
 prompter\-next:        To name the editor to be used on exit from .B prompter
 ^Msg\-Protect:~^To set mode when creating a new draft
 .fi
 prompter\-next:        To name the editor to be used on exit from .B prompter
 ^Msg\-Protect:~^To set mode when creating a new draft
 .fi

-

 .SH "SEE ALSO"
 .SH "SEE ALSO"

-comp(1), dist(1), forw(1), repl(1), whatnow(1)
-
+.IR comp (1),
+.IR dist (1),
+.IR forw (1),
+.IR repl (1),
+.IR whatnow (1)

 .SH DEFAULTS
 .nf
 .RB ` \-prepend '
 .RB ` \-norapid '
 .RB ` \-nodoteof '
 .fi
 .SH DEFAULTS
 .nf
 .RB ` \-prepend '
 .RB ` \-norapid '
 .RB ` \-nodoteof '
 .fi

-

 .SH CONTEXT
 None
 .SH CONTEXT
 None

-

 .SH "HELPFUL HINTS"
 The
 .B \-rapid
 .SH "HELPFUL HINTS"
 The
 .B \-rapid


@@ -180,16 +182,16 @@ is useful with
 .BR \-use .
 .PP
 The user may wish to link
 .BR \-use .
 .PP
 The user may wish to link

-.B prompter under several names (e.g.,
-\*(lqrapid\*(rq) and give appropriate switches in the profile entries
-under these names (e.g., \*(lqrapid: -rapid\*(rq).  This facilitates
+.B prompter
+under several names (e.g., \*(lqrapid\*(rq) and give appropriate
+switches in the profile entries under these names
+(e.g., \*(lqrapid: -rapid\*(rq).  This facilitates

 invoking prompter differently for different
 .B nmh
 commands (e.g.,
 \*(lqforw: -editor rapid\*(rq).
 invoking prompter differently for different
 .B nmh
 commands (e.g.,
 \*(lqforw: -editor rapid\*(rq).

-

 .SH BUGS
 .SH BUGS

-.B Prompter
+.B prompter

 uses
 uses

-.BR stdio (3),
+.IR stdio (3),

 so it will lose if you edit files with nulls in them.
 so it will lose if you edit files with nulls in them.