add my whatnow replacement whatnow2
[mmh] / man / whatnow2.man1
diff --git a/man/whatnow2.man1 b/man/whatnow2.man1
new file mode 100644 (file)
index 0000000..a9e1a84
--- /dev/null
@@ -0,0 +1,134 @@
+.\"
+.\" %nmhwarning%
+.\"
+.TH WHATNOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.SH NAME
+whatnow \- front-end for handling drafts
+.SH SYNOPSIS
+.HP 5
+.na
+.B whatnow
+.RI [ command
+.RB | \-Version ]
+.RB | \-help ]
+.ad
+.SH DESCRIPTION
+.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
+.B mmh
+commands
+.BR comp ,
+.BR dist ,
+.BR forw ,
+or
+.B repl
+after the initial edit.
+.PP
+When started, the editor is started on the draft. Then,
+.B whatnow
+can called with one of the commands.
+.PP
+.RS 5
+.TP \w'refilezzzzfolderz'u
+.B edit
+re\-edit using the same editor that was used on the
+preceding round unless a profile entry
+`<lasteditor>\-next: <editor>' names an alternate editor
+.TP \w'refilezzzzfolderz'u
+.B edit <editor>
+invoke <editor> for further editing
+.TP \w'refilezzzzfolderz'u
+.B list
+list the draft on the terminal
+.TP \w'refilezzzzfolderz'u
+.B display
+list the message being distributed/replied\-to on the terminal
+.TP \w'refilezzzzfolderz'u
+.B whom
+list the recipients of the message
+.TP \w'refilezzzzfolderz'u
+.B send
+send the message
+.TP \w'refilezzzzfolderz'u
+.B refile +folder
+refile the draft into the given folder
+.TP \w'refilezzzzfolderz'u
+.B delete
+delete the draft and exit
+.TP \w'refilezzzzfolderz'u
+.B attach files
+add the named files to the draft as MIME attachments
+.TP \w'refilezzzzfolderz'u
+.B alist
+list the MIME attachments
+.TP \w'refilezzzzfolderz'u
+.B detach numbers
+remove MIME attachments by number
+.RE
+.PP
+When entering your response, you need only type enough characters
+to uniquely identify the response.
+.PP
+For the
+.B edit
+response, any valid switch to the editor is valid.
+.PP
+For the
+.B send
+response, any valid switch to
+.BR send (1)
+is valid.
+.PP
+For the
+.B refile
+response, any valid switch to
+.B refile
+is valid.
+.PP
+See
+.BR mh\-profile (5)
+for further information about how editors
+are used by
+.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
+Consult the
+.BR mh-draft (7)
+man page for more
+information.
+
+.SH FILES
+.fc ^ ~
+.nf
+.ta \w'%etcdir%/ExtraBigFileName  'u
+^$HOME/.mmh/profile~^The user profile
+^+drafts~^The draft folder
+.fi
+
+.SH "PROFILE COMPONENTS"
+.fc ^ ~
+.nf
+.ta 2.4i
+.ta \w'ExtraBigProfileName  'u
+^Path:~^To determine the user's mail storage
+^Draft\-Folder:~^To set the default draft\-folder
+^Editor:~^To override the default editor
+^<lasteditor>\-next:~^To name an editor to be used after exit
+^~^from <lasteditor>
+^listproc:~^Program to list the contents of a message
+.fi
+
+.SH "SEE ALSO"
+send(1)
+
+.SH CONTEXT
+None