Renamed -version switch to -Version to remove the conflict with -verbose.

[mmh] / man / whatnow.man1

diff --git a/man/whatnow.man1 b/man/whatnow.man1
index d1c5846..c11da83 100644 (file)
--- a/man/whatnow.man1
+++ b/man/whatnow.man1
@@ -10,14 +10,11 @@ whatnow \- prompting front-end for sending messages
 .B whatnow
 .RB [ \-editor
 .IR editor ]
 .B whatnow
 .RB [ \-editor
 .IR editor ]

-.RB [ \-noedit ]

 .RB [ \-prompt
 .IR string ]
 .RI [ file ]
 .RB [ \-prompt
 .IR string ]
 .RI [ file ]

-.RB [ \-version ]
+.RB [ \-Version ]

 .RB [ \-help ]
 .RB [ \-help ]

-.RB [ \-attach
-.IR header-field-name ]

 .ad
 .SH DESCRIPTION
 .B Whatnow
 .ad
 .SH DESCRIPTION
 .B Whatnow

@@ -33,9 +30,10 @@ or
 .B repl
 after the initial edit.
 .PP
 .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:
 .B whatnow
 repetitively prompts the user with \*(lqWhat now?\*(rq
 and awaits a response.  The valid responses are:

@@ -53,14 +51,6 @@ invoke <editor> for further editing
 .B refile +folder
 refile the draft into the given folder
 .TP \w'refilezzzzfolderz'u
 .B refile +folder
 refile the draft into the given folder
 .TP \w'refilezzzzfolderz'u

-.B mime
-process the draft as MIME composition file using
-the
-.I buildmimeproc
-command
-.RB ( mhbuild
-by default)
-.TP \w'refilezzzzfolderz'u

 .B display
 list the message being distributed/replied\-to
 on the terminal
 .B display
 list the message being distributed/replied\-to
 on the terminal

@@ -74,15 +64,9 @@ send the message
 .B send \-watch
 send the message and monitor the delivery process
 .TP \w'refilezzzzfolderz'u
 .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
 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
 .B delete
 delete the draft and exit
 .TP \w'refilezzzzfolderz'u

@@ -98,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 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
 .TP \w'refilezzzzfolderz'u
 .B detach [-n] files-or-numbers
 remove MIME attachments, either by file name or by number with -n

@@ -114,39 +98,16 @@ response, any valid switch to the editor is valid.
 .PP
 For the
 .B send
 .PP
 For the
 .B send

-and
-.B push
-responses, any valid switch to
+response, any valid switch to

 .BR send (1)
 .BR send (1)

-is valid (as
-.B push
-merely invokes
-.B send
-with the
-.B \-push
-option).
+is valid.

 .PP
 For the
 .B refile
 .PP
 For the
 .B refile

-response, any valid switch to the
-.I fileproc
+response, any valid switch to
+.B refile

 is valid.
 .PP
 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
 See
 .BR mh\-profile (5)
 for further information about how editors

@@ -157,6 +118,10 @@ used to direct
 .BR whatnow 's
 actions in complex ways.
 .PP
 .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
 The
 .B \-prompt
 .I string

@@ -186,13 +151,7 @@ information.
 ^Editor:~^To override the default editor
 ^<lasteditor>\-next:~^To name an editor to be used after exit
 ^~^from <lasteditor>
 ^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
+^listproc:~^Program to list the contents of a message

 .fi
 
 .SH "SEE ALSO"
 .fi
 
 .SH "SEE ALSO"

@@ -205,66 +164,3 @@ send(1)
 
 .SH CONTEXT
 None
 
 .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 the
-.I buildmimeproc
-fails (returns a nonzero status),
-.B whatnow
-simply prints a \*(lqWhat now?\*(rq prompt.
-.B whatnow
-depends on the
-.I buildmimeproc
-to tell the user that something went wrong.
-.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.