X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/e1b3eb2cfcc2823fb2bb429aa54d9d6c296fc16b..9f8418e870a70c264eda1598f2d470e5428c216d:/man/whatnow.man diff --git a/man/whatnow.man b/man/whatnow.man index f7d7b37a..b80031e8 100644 --- a/man/whatnow.man +++ b/man/whatnow.man @@ -1,13 +1,15 @@ +.TH WHATNOW %manext1% "January 17, 2014" "%nmhversion%" .\" .\" %nmhwarning% -.\" $Id$ .\" -.TH WHATNOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] .SH NAME whatnow \- prompting front-end for sending messages .SH SYNOPSIS .HP 5 +.na .B whatnow +.RB [ \-help ] +.RB [ \-version ] .RB [ \-draftfolder .IR +folder ] .RB [ \-draftmessage @@ -19,8 +21,7 @@ whatnow \- prompting front-end for sending messages .RB [ \-prompt .IR string ] .RI [ file ] -.RB [ \-version ] -.RB [ \-help ] +.ad .SH DESCRIPTION .B Whatnow is the default program that queries the user about @@ -43,18 +44,18 @@ 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 preceding round unless a profile entry \*(lq\-next: \*(rq names an alternate editor -.TP \w'refilezzfolderz'u +.TP \w'refilezzzzfolderz'u .B edit invoke for further editing -.TP \w'refilezzfolderz'u +.TP \w'refilezzzzfolderz'u .B refile +folder 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 +63,59 @@ the command .RB ( mhbuild by default) -.TP \w'refilezzfolderz'u +.TP \w'refilezzzzfolderz'u .B display 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 +.B cd directory +use the 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] +list files in the attachment working directory using the ls command +.TP \w'refilezzzzfolderz'u +.B attach [-v] files +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 +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 +130,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 +142,7 @@ option). For the .B whom response, any valid switch to -.BR whom (1) +.IR whom (1) is valid. .PP For the @@ -145,7 +167,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 . @@ -171,18 +193,28 @@ the .B nmh draft folder facility. This is an advanced (and highly useful) feature. Consult the -.BR mh-draft (5) +.IR mh-draft (5) man page 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 +.ta \w'%nmhetcdir%/ExtraBigFileName 'u ^$HOME/\&.mh\(ruprofile~^The user profile ^/draft~^The draft file .fi - .SH "PROFILE COMPONENTS" .fc ^ ~ .nf @@ -193,40 +225,25 @@ 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 ^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