X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fwhatnow.man1;h=c11da838510e87589a34a5c87fc1f2aeb5b62fc2;hp=d1c5846a330455ad9cac3bd043a348c168882bab;hb=32b2354dbaf4bf934936eb5b102a4a3d2fdd209a;hpb=5aaedc4256d58afe2481d667afdcb5162a914ba9 diff --git a/man/whatnow.man1 b/man/whatnow.man1 index d1c5846..c11da83 100644 --- 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 ] -.RB [ \-noedit ] .RB [ \-prompt .IR string ] .RI [ file ] -.RB [ \-version ] +.RB [ \-Version ] .RB [ \-help ] -.RB [ \-attach -.IR header-field-name ] .ad .SH DESCRIPTION .B Whatnow @@ -33,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: @@ -53,14 +51,6 @@ invoke for further editing .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 @@ -74,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 @@ -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 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 @@ -114,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 @@ -157,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 @@ -186,13 +151,7 @@ information. ^Editor:~^To override the default editor ^\-next:~^To name an editor to be used after exit ^~^from -^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" @@ -205,66 +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 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.