-.\"
+.TH WHATNOW %manext1% 2014-01-23 "%nmhversion%"
+.
.\" %nmhwarning%
-.\"
-.TH WHATNOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.
.SH NAME
-whatnow \- prompting front-end for sending messages
+whatnow \- prompting front-end for writing nmh messages
.SH SYNOPSIS
.HP 5
.na
.B whatnow
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-draftfolder
.IR +folder ]
.RB [ \-draftmessage
.RB [ \-prompt
.IR string ]
.RI [ file ]
-.RB [ \-version ]
-.RB [ \-help ]
-.RB [ \-attach
-.IR header-field-name ]
.ad
.SH DESCRIPTION
-.B Whatnow
+.B whatnow
is the default program that queries the user about
the disposition of a composed draft. It is normally automatically
invoked by one of the
.RS 5
.TP \w'refilezzzzfolderz'u
.B edit
-re\-edit using the same editor that was used on the
+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
.TP \w'refilezzzzfolderz'u
-.B edit <editor>
-invoke <editor> for further editing
+\fBedit\fP \fIeditor\fP
+invoke
+.I editor
+for further editing
.TP \w'refilezzzzfolderz'u
-.B refile +folder
+\fBrefile\fP \fI+folder\fP
refile the draft into the given folder
.TP \w'refilezzzzfolderz'u
.B mime
by default)
.TP \w'refilezzzzfolderz'u
.B display
-list the message being distributed/replied\-to
+list the message being distributed/replied-to
on the terminal
.TP \w'refilezzzzfolderz'u
.B list
.B delete
delete the draft and exit
.TP \w'refilezzzzfolderz'u
-.B cd directory
-use the directory when interpreting attachment file names
+\fBcd\fP \fIdirectory\fP
+use
+.I directory
+when interpreting attachment file names
.TP \w'refilezzzzfolderz'u
.B pwd
print the working directory for attachment files
.TP \w'refilezzzzfolderz'u
-.B ls [ls-options]
+\fBls\fP [\fIls-options\fP\^]
list files in the attachment working directory using the ls command
.TP \w'refilezzzzfolderz'u
-.B attach files
-add the named files to the draft as MIME attachments
+\fBattach [-v]\fP \fIfiles\fP
+add the named files to the message as MIME attachments; -v displays
+the mhbuild directive that
+.IR send (1)
+will use
.TP \w'refilezzzzfolderz'u
.B alist [-ln]
list the MIME attachments, either short, long [-l] or numbered [-n]
.TP \w'refilezzzzfolderz'u
-.B detach [-n] files-or-numbers
+\fBdetach [-n]\fP \fIfiles-or-numbers\fP
remove MIME attachments, either by file name or by number with -n
.RE
.PP
and
.B push
responses, any valid switch to
-.BR send (1)
+.IR send (1)
is valid (as
.B push
merely invokes
For the
.B whom
response, any valid switch to
-.BR whom (1)
+.IR whom (1)
is valid.
.PP
For the
responses, any valid argument to
the
.I lproc
-is valid. If any non\-switch arguments are present, then
+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
message).
.PP
See
-.BR mh\-profile (5)
+.IR mh\-profile (5)
for further information about how editors
are used by
.BR nmh .
the
.B nmh
draft folder facility. This is an advanced (and highly
-useful) feature. Consult the
-.BR mh-draft (5)
-man page for more
+useful) feature. Consult
+.IR mh-draft (5)
+for more
information.
-
+.PP
+If your
+.B nmh
+was configured with readline enabled, you'll be able to use filename
+completion and other readline features at the prompt. These are
+particularly useful with the
+.BR cd ,
+.BR ls ,
+.BR attach ,
+and
+.B detach
+commands for managing MIME attachments.
.SH FILES
.fc ^ ~
.nf
-.ta \w'%etcdir%/ExtraBigFileName 'u
-^$HOME/\&.mh\(ruprofile~^The user profile
-^<mh\-dir>/draft~^The draft file
+.ta \w'%nmhetcdir%/ExtraBigFileName 'u
+^$HOME/.mh_profile~^The user profile
+^<mh-dir>/draft~^The draft file
.fi
-
.SH "PROFILE COMPONENTS"
.fc ^ ~
.nf
.ta 2.4i
.ta \w'ExtraBigProfileName 'u
^Path:~^To determine the user's nmh directory
-^Draft\-Folder:~^To find the default draft\-folder
+^Draft\-Folder:~^To find the default draft-folder
^Editor:~^To override the default editor
^<lasteditor>\-next:~^To name an editor to be used after exit
^~^from <lasteditor>
-^automimeproc:~^If value is 1, and the draft is a MIME
-^~^composition file, then automatically call
-^~^buildmimeproc prior to sending.
^buildmimeproc:~^Program to translate MIME composition files
^fileproc:~^Program to refile the message
^lproc:~^Program to list the contents of a message
^sendproc:~^Program to use to send the message
^whomproc:~^Program to determine who a message would go to
.fi
-
.SH "SEE ALSO"
-send(1), whom(1)
-
+.IR send (1),
+.IR whom (1)
.SH DEFAULTS
.nf
.RB ` \-prompt "' defaults to \*(lqWhat\ Now?\ \*(rq"
.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.
+it with a site-dependent prefix (usually a comma);
+failure of a later edit preserves the draft.
.PP
If the
.I buildmimeproc
.BR forw ,
and
.B repl
-use a built\-in
+use a built-in
.BR whatnow ,
and do not actually run the
.B whatnow
.BR send ,
then
.B whatnow
-uses a built\-in
+uses a built-in
.BR send ,
it does not actually run the
.B send