X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/95e9c4e6befb17ca3e691c26f024fb55eeae5e31..94187a80bd60baab4b9c4b949ad820d730578123:/man/whatnow.man?ds=inline diff --git a/man/whatnow.man b/man/whatnow.man index b25f006c..5d6f0709 100644 --- a/man/whatnow.man +++ b/man/whatnow.man @@ -1,13 +1,15 @@ -.TH WHATNOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] -.\" +.TH WHATNOW %manext1% 2014-01-23 "%nmhversion%" +. .\" %nmhwarning% -.\" +. .SH NAME -whatnow \- prompting front-end for sending messages +whatnow \- prompting front-end for writing nmh messages .SH SYNOPSIS .HP 5 .na .B whatnow +.RB [ \-help ] +.RB [ \-version ] .RB [ \-draftfolder .IR +folder ] .RB [ \-draftmessage @@ -19,14 +21,9 @@ whatnow \- prompting front-end for sending messages .RB [ \-prompt .IR string ] .RI [ file ] -.RB [ \-version ] -.RB [ \-help ] -.RB [ \-attach -.IR header-field-name ] -.RB [ \-noattach ] .ad .SH DESCRIPTION -.B Whatnow +.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 @@ -49,14 +46,16 @@ and awaits a response. The valid responses are: .RS 5 .TP \w'refilezzzzfolderz'u .B edit -re\-edit using the same editor that was used on the +re-edit using the same editor that was used on the preceding round unless a profile entry \*(lq\-next: \*(rq names an alternate editor .TP \w'refilezzzzfolderz'u -.B edit -invoke for further editing +\fBedit\fP \fIeditor\fP +invoke +.I editor +for further editing .TP \w'refilezzzzfolderz'u -.B refile +folder +\fBrefile\fP \fI+folder\fP refile the draft into the given folder .TP \w'refilezzzzfolderz'u .B mime @@ -68,7 +67,7 @@ command by default) .TP \w'refilezzzzfolderz'u .B display -list the message being distributed/replied\-to +list the message being distributed/replied-to on the terminal .TP \w'refilezzzzfolderz'u .B list @@ -99,22 +98,27 @@ delete the draft and exit .B delete delete the draft and exit .TP \w'refilezzzzfolderz'u -.B cd directory -use the directory when interpreting attachment file names +\fBcd\fP \fIdirectory\fP +use +.I directory +when interpreting attachment file names .TP \w'refilezzzzfolderz'u .B pwd print the working directory for attachment files .TP \w'refilezzzzfolderz'u -.B ls [ls-options] +\fBls\fP [\fIls-options\fP\^] list files in the attachment working directory using the ls command .TP \w'refilezzzzfolderz'u -.B attach files -add the named files to the draft as MIME attachments +\fBattach [-v]\fP \fIfiles\fP +add the named files to the message as MIME attachments; -v displays +the mhbuild directive that +.IR send (1) +will use .TP \w'refilezzzzfolderz'u .B alist [-ln] list the MIME attachments, either short, long [-l] or numbered [-n] .TP \w'refilezzzzfolderz'u -.B detach [-n] files-or-numbers +\fBdetach [-n]\fP \fIfiles-or-numbers\fP remove MIME attachments, either by file name or by number with -n .RE .PP @@ -158,7 +162,7 @@ and responses, any valid argument to the .I lproc -is valid. If any non\-switch arguments are present, then +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 @@ -192,16 +196,28 @@ switches invoke the .B nmh draft folder facility. This is an advanced (and highly -useful) feature. Consult the +useful) feature. Consult .IR mh-draft (5) -man page for more +for more information. +.PP +If your +.B nmh +was configured with readline enabled, you'll be able to use filename +completion and other readline features at the prompt. These are +particularly useful with the +.BR cd , +.BR ls , +.BR attach , +and +.B detach +commands for managing MIME attachments. .SH FILES .fc ^ ~ .nf -.ta \w'%etcdir%/ExtraBigFileName 'u -^$HOME/\&.mh\(ruprofile~^The user profile -^/draft~^The draft file +.ta \w'%nmhetcdir%/ExtraBigFileName 'u +^$HOME/.mh_profile~^The user profile +^/draft~^The draft file .fi .SH "PROFILE COMPONENTS" .fc ^ ~ @@ -209,13 +225,10 @@ information. .ta 2.4i .ta \w'ExtraBigProfileName 'u ^Path:~^To determine the user's nmh directory -^Draft\-Folder:~^To find the default draft\-folder +^Draft\-Folder:~^To find the default draft-folder ^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 @@ -228,19 +241,8 @@ information. .SH DEFAULTS .nf .RB ` \-prompt "' defaults to \*(lqWhat\ Now?\ \*(rq" -.RB ` \-attach "' defaults to \*(lqNmh-Attachment\*(rq" .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 quotes. -.PP If the initial edit fails, .B whatnow deletes your draft (by renaming @@ -267,7 +269,7 @@ then .BR forw , and .B repl -use a built\-in +use a built-in .BR whatnow , and do not actually run the .B whatnow @@ -283,7 +285,7 @@ is .BR send , then .B whatnow -uses a built\-in +uses a built-in .BR send , it does not actually run the .B send