X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fwhatnow.man1;h=d0fea84e63591d45ca524ec7d5bca2f95ede3ce6;hp=057c2174da74159b03a1483b4fc967b057ea0051;hb=18591f8e001ecedbee48a51c1d1f08ebaa1c15c8;hpb=8ff284ff9167eff8f5349481529332d59ed913b1 diff --git a/man/whatnow.man1 b/man/whatnow.man1 index 057c217..d0fea84 100644 --- a/man/whatnow.man1 +++ b/man/whatnow.man1 @@ -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 @@ -22,7 +21,7 @@ whatnow \- prompting front-end for sending messages 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 nmh +.B mmh commands .BR comp , .BR dist , @@ -31,11 +30,12 @@ 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 +repetitively prompts the user with `What now?' and awaits a response. The valid responses are: .PP .RS 5 @@ -43,47 +43,32 @@ and awaits a response. The valid responses are: .B edit re\-edit using the same editor that was used on the preceding round unless a profile entry -\*(lq\-next: \*(rq names an alternate editor +`\-next: ' names an alternate editor .TP \w'refilezzzzfolderz'u .B edit invoke for further editing .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) +.B list +list the draft on the terminal .TP \w'refilezzzzfolderz'u .B display -list the message being distributed/replied\-to -on the terminal +list the message being distributed/replied\-to on the terminal .TP \w'refilezzzzfolderz'u -.B list -list the draft on the terminal +.B whom +list the recipients of the message .TP \w'refilezzzzfolderz'u .B send send the message .TP \w'refilezzzzfolderz'u -.B send \-watch -send the message and monitor the delivery process +.B refile +folder +refile the draft into the given folder .TP \w'refilezzzzfolderz'u -.B push -send the message in the background +.B delete +delete 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 cd directory use the directory when interpreting attachment file names .TP \w'refilezzzzfolderz'u @@ -96,11 +81,11 @@ 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 +.B detach numbers +remove MIME attachments by number .RE .PP When entering your response, you need only type enough characters @@ -112,49 +97,30 @@ 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 are used by -.BR nmh . +.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 The .B \-prompt .I string @@ -184,13 +150,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" @@ -198,71 +158,8 @@ send(1) .SH DEFAULTS .nf -.RB ` \-prompt "' defaults to \*(lqWhat\ Now?\ \*(rq" +.RB ` \-prompt "' defaults to `What\ Now?\ '" .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. -.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.