.B whatnow
.RB [ \-editor
.IR editor ]
-.RB [ \-noedit ]
.RB [ \-prompt
.IR string ]
.RI [ file ]
-.RB [ \-version ]
+.RB [ \-Version ]
.RB [ \-help ]
.ad
.SH DESCRIPTION
is the default program that queries the user about
the disposition of a composed draft. It is normally automatically
invoked by one of the
-.B nmh
+.B mmh
commands
.BR comp ,
.BR dist ,
.B repl
after the initial edit.
.PP
-When started, the editor is started on the draft (unless
-.B \-noedit
-is given, in which case the initial edit is suppressed). Then,
+When started, the editor is started on the draft (unless the
+.B \-editor
+switch with an empty string argument is given,
+in which case the initial edit is suppressed). Then,
.B whatnow
-repetitively prompts the user with \*(lqWhat now?\*(rq
+repetitively prompts the user with `What now?'
and awaits a response. The valid responses are:
.PP
.RS 5
.B edit
re\-edit using the same editor that was used on the
preceding round unless a profile entry
-\*(lq<lasteditor>\-next: <editor>\*(rq names an alternate editor
+`<lasteditor>\-next: <editor>' names an alternate editor
.TP \w'refilezzzzfolderz'u
.B edit <editor>
invoke <editor> for further editing
.TP \w'refilezzzzfolderz'u
-.B refile +folder
-refile the draft into the given folder
+.B list
+list the draft on the terminal
.TP \w'refilezzzzfolderz'u
.B display
-list the message being distributed/replied\-to
-on the terminal
+list the message being distributed/replied\-to on the terminal
.TP \w'refilezzzzfolderz'u
-.B list
-list the draft on the terminal
+.B whom
+list the recipients of the message
.TP \w'refilezzzzfolderz'u
.B send
send the message
.TP \w'refilezzzzfolderz'u
-.B send \-watch
-send the message and monitor the delivery process
+.B refile +folder
+refile the draft into the given folder
.TP \w'refilezzzzfolderz'u
-.B push
-send the message in the background
+.B delete
+delete the draft and exit
.TP \w'refilezzzzfolderz'u
.B quit
preserve the draft and exit
.TP \w'refilezzzzfolderz'u
-.B delete
-delete the draft and exit
-.TP \w'refilezzzzfolderz'u
.B cd directory
use the directory when interpreting attachment file names
.TP \w'refilezzzzfolderz'u
.B attach files
add the named files to the draft as MIME attachments
.TP \w'refilezzzzfolderz'u
-.B alist [-ln]
-list the MIME attachments, either short, long [-l] or numbered [-n]
+.B alist
+list the MIME attachments
.TP \w'refilezzzzfolderz'u
-.B detach [-n] files-or-numbers
-remove MIME attachments, either by file name or by number with -n
+.B detach numbers
+remove MIME attachments by number
.RE
.PP
When entering your response, you need only type enough characters
.PP
For the
.B send
-and
-.B push
-responses, any valid switch to
+response, any valid switch to
.BR send (1)
-is valid (as
-.B push
-merely invokes
-.B send
-with the
-.B \-push
-option).
+is valid.
.PP
For the
.B refile
-response, any valid switch to the
-.I fileproc
+response, any valid switch to
+.B refile
is valid.
.PP
-For the
-.B display
-and
-.B list
-responses, any valid argument to
-the
-.I lproc
-is valid. If any non\-switch arguments are present, then
-the pathname of the draft will be excluded from the argument list given
-to the
-.I lproc
-(this is useful for listing another
-.B nmh
-message).
-.PP
See
.BR mh\-profile (5)
for further information about how editors
are used by
-.BR nmh .
+.BR mmh .
It also discusses how environment variables can be
used to direct
.BR whatnow 's
actions in complex ways.
.PP
+If the initial edit fails, no new draft is created, but any
+existing re-used draft is preserved.
+Failures of later edits are ignored and another prompt is printed.
+.PP
The
.B \-prompt
.I string
^Editor:~^To override the default editor
^<lasteditor>\-next:~^To name an editor to be used after exit
^~^from <lasteditor>
-^fileproc:~^Program to refile the message
-^lproc:~^Program to list the contents of a message
-^sendproc:~^Program to use to send the message
+^listproc:~^Program to list the contents of a message
.fi
.SH "SEE ALSO"
.SH DEFAULTS
.nf
-.RB ` \-prompt "' defaults to \*(lqWhat\ Now?\ \*(rq"
+.RB ` \-prompt "' defaults to `What\ Now?\ '"
.fi
.SH CONTEXT
None
-
-.SH BUGS
-The argument to the
-.B \-prompt
-switch must be interpreted as a single
-token by the shell that invokes
-.BR whatnow .
-Therefore, one must
-usually place the argument to this switch inside double\-quotes.
-.PP
-If the initial edit fails,
-.B whatnow
-deletes your draft (by renaming
-it with a leading comma); failure of a later edit preserves the draft.
projects / mmh / blobdiff