8 date 92.10.16.21.36.30; author jromine; state Exp;
13 date 92.05.12.22.23.34; author jromine; state Exp;
18 date 90.12.18.15.44.22; author mh; state Exp;
23 date 90.04.05.15.09.20; author sources; state Exp;
28 date 90.03.22.11.31.55; author sources; state Exp;
33 date 90.03.20.19.42.38; author sources; state Exp;
38 date 90.03.20.17.36.53; author sources; state Exp;
43 date 90.03.15.15.17.33; author sources; state Exp;
48 date 90.03.15.15.14.55; author sources; state Exp;
63 .\" @@(#)$Id: whatnow.rf,v 1.8 1992/05/12 22:23:34 jromine Exp jromine $
66 whatnow \- prompting front-end for send
69 \%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
70 \%[\-editor\ editor] \%[\-noedit]
75 \fIWhatnow\fR is the default program that queries the user about the
76 disposition of a composed draft.
77 It is normally invoked by one of
78 \fIcomp\fR, \fIdist\fR, \fIforw\fR, or \fIrepl\fR
79 after the initial edit.
82 the editor is started on the draft
83 (unless `\-noedit' is given, in which case the initial edit is suppressed).
84 Then, \fIwhatnow\fR repetitively
85 prompts the user with \*(lqWhat now?\*(rq and awaits a response.
86 The valid responses are:
90 .ta \w'\fBrefile +folder\fR 'u
91 ^\fBdisplay\fR~^to list the message being distributed/replied\-to on
93 ^\fBedit\fR~^to re\-edit using the same editor that was used on the
94 ^~^preceding round unless a profile entry
95 ^~^\*(lq<lasteditor>\-next: <editor>\*(rq names an alternate editor
96 ^\fBedit <editor>\fR~^to invoke <editor> for further editing
97 ^\fBlist\fR~^to list the draft on the terminal
98 ^\fBpush\fR~^to send the message in the background
99 ^\fBquit\fR~^to terminate the session and preserve the draft
100 ^\fBquit \-delete\fR~^to terminate, then delete the draft
101 ^\fBrefile +folder\fR~^to refile the draft into the given folder
102 ^\fBsend\fR~^to send the message
103 ^\fBsend \-watch\fR~^to cause the delivery process to be monitored
104 ^\fBwhom\fR~^to list the addresses that the message will go to
105 ^\fBwhom \-check\fR~^to list the addresses and verify that they are
106 ^~^acceptable to the transport service
110 For the \fBedit\fR response,
111 any valid switch to the editor is valid.
113 for the \fBsend\fR and \fBwhom\fR responses,
114 any valid switch to \fIsend\fR\0(1) and \fIwhom\fR\0(1) commands,
117 For the \fBpush\fR response,
118 any valid switch to \fIsend\fR\0(1) is valid
119 (as this merely invokes \fIsend\fR with the `\-push' option).
120 For the \fIrefile\fR response,
121 any valid switch to the \fIfileproc\fR is valid.
122 For the \fBdisplay\fR and \fBlist\fR responses,
123 any valid argument to the \fIlproc\fR is valid.
124 If any non\-switch arguments are present,
125 then the pathname of the draft will be excluded from the argument list
126 given to the \fIlproc\fR
127 (this is useful for listing another \fIMH\fR message).
129 See \fImh\-profile\fR\0(5) for further information
130 about how editors are used by MH.
131 It also discusses how complex envariables can be used to direct
132 \fIwhatnow\fR's actions.
134 The `\-prompt\ string' switch sets the prompting string for \fIwhatnow\fR.
136 The `\-draftfolder\ +folder' and `\-draftmessage\ msg' switches invoke the
137 \fIMH\fR draft folder facility.
138 This is an advanced (and highly useful) feature.
139 Consult the \fBAdvanced Features\fR section of the \fIMH\fR manual for more
142 ^$HOME/\&.mh\(ruprofile~^The user profile
143 ^<mh\-dir>/draft~^The draft file
145 ^Path:~^To determine the user's MH directory
147 ^Draft\-Folder:~^To find the default draft\-folder
149 ^Editor:~^To override the default editor
151 ^<lasteditor>\-next:~^To name an editor to be used after exit from <lasteditor>
154 ^automhnproc:~^Program to automatically run prior to sending
155 ^~^if the draft is an \fImhn\fR composition file
158 ^fileproc:~^Program to refile the message
160 ^lproc:~^Program to list the contents of a message
162 ^sendproc:~^Program to use to send the message
164 ^whomproc:~^Program to determine who a message would go to
168 `\-prompt\ \*(lqWhat\ Now?\ \*(rq'
172 The argument to the `\-prompt' switch must be interpreted as a single token
173 by the shell that invokes \fIwhatnow\fR.
175 one must usually place the argument to this switch inside double\-quotes.
177 If the initial edit fails, \fIwhatnow\fR deletes your draft (by renaming
178 it with a leading comma); failure of a later edit preverves the draft.
180 If \fIwhatnowproc\fR is \fIwhatnow\fR,
181 then \fIcomp\fR, \fIdist\fP, \fIforw\fP, and \fIrepl\fP use
182 a built\-in \fIwhatnow\fR,
183 and do not actually run the \fIwhatnow\fR program.
184 Hence, if you define your own \fIwhatnowproc\fR,
185 don't call it \fIwhatnow\fR since it won't be run.
187 If \fIsendproc\fR is \fIsend\fR,
188 then \fIwhatnow\fR uses a built\-in \fIsend\fR,
189 it does not actually run the \fIsend\fR program.
190 Hence, if you define your own \fIsendproc\fR,
191 don't call it \fIsend\fR since \fIwhatnow\fR won't run it.
198 @fixup for nroff problems
203 .\" @@(#)$Id: whatnow.rf,v 1.7 1990/12/18 15:44:22 mh Exp jromine $
210 @comp, repl, etc. use built-in whatnow.
216 .\" @@(#)$Id: whatnow.rf,v 1.6 90/04/05 15:09:20 sources Exp Locker: mh $
219 whatnow \- prompting front\-end for send
233 The valid responses are
240 @put things back, do .NA stuff another way
254 .TH WHATNOW 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
264 @fixup for makewhatis
269 .TH WHATNOW 1 [mh.6] MH
275 @document deleting initial draft -- should be fixed