Renamed -version switch to -Version to remove the conflict with -verbose.
[mmh] / man / whatnow.man1
index 764234b..c11da83 100644 (file)
@@ -10,11 +10,10 @@ whatnow \- prompting front-end for sending messages
 .B whatnow
 .RB [ \-editor
 .IR editor ]
-.RB [ \-noedit ]
 .RB [ \-prompt
 .IR string ]
 .RI [ file ]
-.RB [ \-version ]
+.RB [ \-Version ]
 .RB [ \-help ]
 .ad
 .SH DESCRIPTION
@@ -31,9 +30,10 @@ or
 .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
 and awaits a response.  The valid responses are:
@@ -64,15 +64,9 @@ send the message
 .B send \-watch
 send the message and monitor the delivery process
 .TP \w'refilezzzzfolderz'u
-.B push
-send the message in the background
-.TP \w'refilezzzzfolderz'u
 .B quit
 preserve the draft and exit
 .TP \w'refilezzzzfolderz'u
-.B quit \-delete
-delete the draft and exit
-.TP \w'refilezzzzfolderz'u
 .B delete
 delete the draft and exit
 .TP \w'refilezzzzfolderz'u
@@ -88,8 +82,8 @@ list files in the attachment working directory using the ls command
 .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
@@ -104,39 +98,16 @@ response, any valid switch to the editor is valid.
 .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
@@ -147,6 +118,10 @@ 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
@@ -176,9 +151,7 @@ information.
 ^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"
@@ -191,56 +164,3 @@ send(1)
 
 .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.
-.PP
-If
-.I whatnowproc
-is
-.BR whatnow ,
-then
-.BR comp ,
-.BR dist ,
-.BR forw ,
-and
-.B repl
-use a built\-in
-.BR whatnow ,
-and do not actually run the
-.B whatnow
-program.  Hence, if you define your own
-.IR whatnowproc ,
-don't call it
-.B whatnow
-since it won't be run.
-.PP
-If
-.I sendproc
-is
-.BR send ,
-then
-.B whatnow
-uses a built\-in
-.BR send ,
-it does not actually run the
-.B send
-program.  Hence, if
-you define your own
-.IR sendproc ,
-don't call it
-.B send
-since
-.B whatnow
-won't run it.