git.marmaro.de Git - mmh/blob - docs/historical/mh-6.8.5/conf/doc/RCS/whatnow.rf,v

   1 head    1.9;
   2 access;
   3 symbols;
   4 locks; strict;
   5
   6
   7 1.9
   8 date    92.10.16.21.36.30;      author jromine; state Exp;
   9 branches;
  10 next    1.8;
  11
  12 1.8
  13 date    92.05.12.22.23.34;      author jromine; state Exp;
  14 branches;
  15 next    1.7;
  16
  17 1.7
  18 date    90.12.18.15.44.22;      author mh;      state Exp;
  19 branches;
  20 next    1.6;
  21
  22 1.6
  23 date    90.04.05.15.09.20;      author sources; state Exp;
  24 branches;
  25 next    1.5;
  26
  27 1.5
  28 date    90.03.22.11.31.55;      author sources; state Exp;
  29 branches;
  30 next    1.4;
  31
  32 1.4
  33 date    90.03.20.19.42.38;      author sources; state Exp;
  34 branches;
  35 next    1.3;
  36
  37 1.3
  38 date    90.03.20.17.36.53;      author sources; state Exp;
  39 branches;
  40 next    1.2;
  41
  42 1.2
  43 date    90.03.15.15.17.33;      author sources; state Exp;
  44 branches;
  45 next    1.1;
  46
  47 1.1
  48 date    90.03.15.15.14.55;      author sources; state Exp;
  49 branches;
  50 next    ;
  51
  52
  53 desc
  54 @@
  55
  56
  57 1.9
  58 log
  59 @MIME changes
  60 @
  61 text
  62 @.\"    @@(MHWARNING)
  63 .\" @@(#)$Id: whatnow.rf,v 1.8 1992/05/12 22:23:34 jromine Exp jromine $
  64 .SC WHATNOW 1
  65 .NA
  66 whatnow \- prompting front-end for send
  67 .SY
  68 whatnow
  69 \%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
  70 \%[\-editor\ editor] \%[\-noedit]
  71 \%[\-prompt\ string]
  72 \%[file]
  73 \%[\-help]
  74 .DE
  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.
  80
  81 When started,
  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:
  87
  88 .nf
  89 .in .5i
  90 .ta \w'\fBrefile +folder\fR  'u
  91 ^\fBdisplay\fR~^to list the message being distributed/replied\-to on
  92 ^~^the terminal
  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
 107 .fi
 108 .re
 109
 110 For the \fBedit\fR response,
 111 any valid switch to the editor is valid.
 112 Similarly,
 113 for the \fBsend\fR and \fBwhom\fR responses,
 114 any valid switch to \fIsend\fR\0(1) and \fIwhom\fR\0(1) commands,
 115 respectively,
 116 are valid.
 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).
 128
 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.
 133
 134 The `\-prompt\ string' switch sets the prompting string for \fIwhatnow\fR.
 135
 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
 140 information.
 141 .Fi
 142 ^$HOME/\&.mh\(ruprofile~^The user profile
 143 ^<mh\-dir>/draft~^The draft file
 144 .Pr
 145 ^Path:~^To determine the user's MH directory
 146 .Ps
 147 ^Draft\-Folder:~^To find the default draft\-folder
 148 .Ps
 149 ^Editor:~^To override the default editor
 150 .Ps
 151 ^<lasteditor>\-next:~^To name an editor to be used after exit from <lasteditor>
 152 .Ps
 153 @@BEGIN: MIME
 154 ^automhnproc:~^Program to automatically run prior to sending
 155 ^~^if the draft is an \fImhn\fR composition file
 156 .Ps
 157 @@END: MIME
 158 ^fileproc:~^Program to refile the message
 159 .Ps
 160 ^lproc:~^Program to list the contents of a message
 161 .Ps
 162 ^sendproc:~^Program to use to send the message
 163 .Ps
 164 ^whomproc:~^Program to determine who a message would go to
 165 .Sa
 166 send(1), whom(1)
 167 .De
 168 `\-prompt\ \*(lqWhat\ Now?\ \*(rq'
 169 .Co
 170 None
 171 .Bu
 172 The argument to the `\-prompt' switch must be interpreted as a single token
 173 by the shell that invokes \fIwhatnow\fR.
 174 Therefore,
 175 one must usually place the argument to this switch inside double\-quotes.
 176
 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.
 179
 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.
 186
 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.
 192 .En
 193 @
 194
 195
 196 1.8
 197 log
 198 @fixup for nroff problems
 199 @
 200 text
 201 @d2 1
 202 a2 1
 203 .\" @@(#)$Id: whatnow.rf,v 1.7 1990/12/18 15:44:22 mh Exp jromine $
 204 d92 5
 205 @
 206
 207
 208 1.7
 209 log
 210 @comp, repl, etc. use built-in whatnow.
 211 jlr
 212 @
 213 text
 214 @d2 1
 215 a2 1
 216 .\" @@(#)$Id: whatnow.rf,v 1.6 90/04/05 15:09:20 sources Exp Locker: mh $
 217 d5 1
 218 a5 1
 219 whatnow \- prompting front\-end for send
 220 @
 221
 222
 223 1.6
 224 log
 225 @add ID
 226 @
 227 text
 228 @d2 1
 229 a2 1
 230 .\" @@(#)$Id:$
 231 d25 2
 232 a26 1
 233 The valid responses are
 234 d113 7
 235 @
 236
 237
 238 1.5
 239 log
 240 @put things back, do .NA stuff another way
 241 @
 242 text
 243 @d2 1
 244 @
 245
 246
 247 1.4
 248 log
 249 @typo
 250 @
 251 text
 252 @d2 2
 253 a3 2
 254 .TH WHATNOW 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
 255 .SH .NA
 256 d5 1
 257 a5 1
 258 .SH .SY
 259 @
 260
 261
 262 1.3
 263 log
 264 @fixup for makewhatis
 265 @
 266 text
 267 @d2 1
 268 a2 1
 269 .TH WHATNOW 1 [mh.6] MH
 270 @
 271
 272
 273 1.2
 274 log
 275 @document deleting initial draft -- should be fixed
 276 @
 277 text
 278 @d2 2
 279 a3 2
 280 .SC WHATNOW 1
 281 .NA
 282 d5 1
 283 a5 1
 284 .SY
 285 @
 286
 287
 288 1.1
 289 log
 290 @Initial revision
 291 @
 292 text
 293 @d109 3
 294 @