- remove some \- items; quite a few, actually
- put .B prompter on a line by itself, a number of times
- some formatting
The line:
prompter uses stdio(3), so it will lose if you edit files
with nulls in them.
does not appear to make a whole lot of sense.
diff --git a/man/prompter.man b/man/prompter.man
index 39e8c8d4..fc214e50 100644
--- a/man/prompter.man
+++ b/man/prompter.man
@@ -21,12 +21,12 @@ prompter \- prompting editor front-end for nmh
.ad
.SH DESCRIPTION
.B prompter
-is an editor front\-end for
+is an editor front-end for
.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
@@ -40,16 +40,18 @@ or
.B prompter
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
-.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,
@@ -59,19 +61,20 @@ or when given the command
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
.B must
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
-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
@@ -86,29 +89,29 @@ was given)
--------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
-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
.B whatnow (1)
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
-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
@@ -122,19 +125,20 @@ where
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
-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
-The first non\-flag argument to
-.B prompter is taken as the name of
-the draft file, and subsequent non\-flag arguments are ignored.
+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
@@ -178,9 +182,10 @@ is useful with
.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.,
_______________________________________________
Nmh-workers mailing list
Nmh-workers(_at_)nongnu(_dot_)org
https://lists.nongnu.org/mailman/listinfo/nmh-workers