X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/e1b3eb2cfcc2823fb2bb429aa54d9d6c296fc16b..94187a80bd60baab4b9c4b949ad820d730578123:/man/whatnow.man diff --git a/man/whatnow.man b/man/whatnow.man index f7d7b37a..5d6f0709 100644 --- a/man/whatnow.man +++ b/man/whatnow.man @@ -1,13 +1,15 @@ -.\" +.TH WHATNOW %manext1% 2014-01-23 "%nmhversion%" +. .\" %nmhwarning% -.\" $Id$ -.\" -.TH WHATNOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] +. .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,10 +21,9 @@ whatnow \- prompting front-end for sending messages .RB [ \-prompt .IR string ] .RI [ file ] -.RB [ \-version ] -.RB [ \-help ] +.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 @@ -43,18 +44,20 @@ repetitively prompts the user with \*(lqWhat now?\*(rq and awaits a response. The valid responses are: .PP .RS 5 -.TP \w'refilezzfolderz'u +.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'refilezzfolderz'u -.B edit -invoke for further editing -.TP \w'refilezzfolderz'u -.B refile +folder +.TP \w'refilezzzzfolderz'u +\fBedit\fP \fIeditor\fP +invoke +.I editor +for further editing +.TP \w'refilezzzzfolderz'u +\fBrefile\fP \fI+folder\fP refile the draft into the given folder -.TP \w'refilezzfolderz'u +.TP \w'refilezzzzfolderz'u .B mime process the draft as MIME composition file using the @@ -62,38 +65,61 @@ the command .RB ( mhbuild by default) -.TP \w'refilezzfolderz'u +.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'refilezzfolderz'u +.TP \w'refilezzzzfolderz'u .B list list the draft on the terminal -.TP \w'refilezzfolderz'u +.TP \w'refilezzzzfolderz'u .B send send the message -.TP \w'refilezzfolderz'u +.TP \w'refilezzzzfolderz'u .B send \-watch send the message and monitor the delivery process -.TP \w'refilezzfolderz'u +.TP \w'refilezzzzfolderz'u .B push send the message in the background -.TP \w'refilezzfolderz'u +.TP \w'refilezzzzfolderz'u .B whom list the addresses that the message will go to -.TP \w'refilezzfolderz'u +.TP \w'refilezzzzfolderz'u .B whom \-check list the addresses and verify that they are acceptable to the transport service -.TP \w'refilezzfolderz'u +.TP \w'refilezzzzfolderz'u .B quit preserve the draft and exit -.TP \w'refilezzfolderz'u +.TP \w'refilezzzzfolderz'u .B quit \-delete delete the draft and exit -.TP \w'refilezzfolderz'u +.TP \w'refilezzzzfolderz'u .B delete delete the draft and exit +.TP \w'refilezzzzfolderz'u +\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 +\fBls\fP [\fIls-options\fP\^] +list files in the attachment working directory using the ls command +.TP \w'refilezzzzfolderz'u +\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 +\fBdetach [-n]\fP \fIfiles-or-numbers\fP +remove MIME attachments, either by file name or by number with -n .RE .PP When entering your response, you need only type enough characters @@ -108,7 +134,7 @@ For the and .B push responses, any valid switch to -.BR send (1) +.IR send (1) is valid (as .B push merely invokes @@ -120,7 +146,7 @@ option). For the .B whom response, any valid switch to -.BR whom (1) +.IR whom (1) is valid. .PP For the @@ -136,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 @@ -145,7 +171,7 @@ to the message). .PP See -.BR mh\-profile (5) +.IR mh\-profile (5) for further information about how editors are used by .BR nmh . @@ -170,63 +196,58 @@ switches invoke the .B nmh draft folder facility. This is an advanced (and highly -useful) feature. Consult the -.BR mh-draft (5) -man page for more +useful) feature. Consult +.IR mh-draft (5) +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'/usr/local/nmh/etc/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 ^ ~ .nf .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 ^sendproc:~^Program to use to send the message ^whomproc:~^Program to determine who a message would go to .fi - .SH "SEE ALSO" -send(1), whom(1) - +.IR send (1), +.IR whom (1) .SH DEFAULTS .nf .RB ` \-prompt "' defaults to \*(lqWhat\ Now?\ \*(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 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. +it with a site-dependent prefix (usually a comma); +failure of a later edit preserves the draft. .PP If the .I buildmimeproc @@ -248,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 @@ -264,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