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

   1 .\"     @(MHWARNING)
   2 .\" @(#)$Id: whatnow.rf,v 1.9 1992/10/16 21:36:30 jromine Exp $
   3 .SC WHATNOW 1
   4 .NA
   5 whatnow \- prompting front-end for send
   6 .SY
   7 whatnow
   8 \%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
   9 \%[\-editor\ editor] \%[\-noedit]
  10 \%[\-prompt\ string]
  11 \%[file]
  12 \%[\-help]
  13 .DE
  14 \fIWhatnow\fR is the default program that queries the user about the
  15 disposition of a composed draft.
  16 It is normally invoked by one of
  17 \fIcomp\fR, \fIdist\fR, \fIforw\fR, or \fIrepl\fR
  18 after the initial edit.
  19
  20 When started,
  21 the editor is started on the draft
  22 (unless `\-noedit' is given, in which case the initial edit is suppressed).
  23 Then, \fIwhatnow\fR repetitively
  24 prompts the user with \*(lqWhat now?\*(rq and awaits a response.
  25 The valid responses are:
  26
  27 .nf
  28 .in .5i
  29 .ta \w'\fBrefile +folder\fR  'u
  30 ^\fBdisplay\fR~^to list the message being distributed/replied\-to on
  31 ^~^the terminal
  32 ^\fBedit\fR~^to re\-edit using the same editor that was used on the
  33 ^~^preceding round unless a profile entry
  34 ^~^\*(lq<lasteditor>\-next: <editor>\*(rq names an alternate editor
  35 ^\fBedit <editor>\fR~^to invoke <editor> for further editing
  36 ^\fBlist\fR~^to list the draft on the terminal
  37 ^\fBpush\fR~^to send the message in the background
  38 ^\fBquit\fR~^to terminate the session and preserve the draft
  39 ^\fBquit \-delete\fR~^to terminate, then delete the draft
  40 ^\fBrefile +folder\fR~^to refile the draft into the given folder
  41 ^\fBsend\fR~^to send the message
  42 ^\fBsend \-watch\fR~^to cause the delivery process to be monitored
  43 ^\fBwhom\fR~^to list the addresses that the message will go to
  44 ^\fBwhom \-check\fR~^to list the addresses and verify that they are
  45 ^~^acceptable to the transport service
  46 .fi
  47 .re
  48
  49 For the \fBedit\fR response,
  50 any valid switch to the editor is valid.
  51 Similarly,
  52 for the \fBsend\fR and \fBwhom\fR responses,
  53 any valid switch to \fIsend\fR\0(1) and \fIwhom\fR\0(1) commands,
  54 respectively,
  55 are valid.
  56 For the \fBpush\fR response,
  57 any valid switch to \fIsend\fR\0(1) is valid
  58 (as this merely invokes \fIsend\fR with the `\-push' option).
  59 For the \fIrefile\fR response,
  60 any valid switch to the \fIfileproc\fR is valid.
  61 For the \fBdisplay\fR and \fBlist\fR responses,
  62 any valid argument to the \fIlproc\fR is valid.
  63 If any non\-switch arguments are present,
  64 then the pathname of the draft will be excluded from the argument list
  65 given to the \fIlproc\fR
  66 (this is useful for listing another \fIMH\fR message).
  67
  68 See \fImh\-profile\fR\0(5) for further information
  69 about how editors are used by MH.
  70 It also discusses how complex envariables can be used to direct
  71 \fIwhatnow\fR's actions.
  72
  73 The `\-prompt\ string' switch sets the prompting string for \fIwhatnow\fR.
  74
  75 The `\-draftfolder\ +folder' and `\-draftmessage\ msg' switches invoke the
  76 \fIMH\fR draft folder facility.
  77 This is an advanced (and highly useful) feature.
  78 Consult the \fBAdvanced Features\fR section of the \fIMH\fR manual for more
  79 information.
  80 .Fi
  81 ^$HOME/\&.mh\(ruprofile~^The user profile
  82 ^<mh\-dir>/draft~^The draft file
  83 .Pr
  84 ^Path:~^To determine the user's MH directory
  85 .Ps
  86 ^Draft\-Folder:~^To find the default draft\-folder
  87 .Ps
  88 ^Editor:~^To override the default editor
  89 .Ps
  90 ^<lasteditor>\-next:~^To name an editor to be used after exit from <lasteditor>
  91 .Ps
  92 @BEGIN: MIME
  93 ^automhnproc:~^Program to automatically run prior to sending
  94 ^~^if the draft is an \fImhn\fR composition file
  95 .Ps
  96 @END: MIME
  97 ^fileproc:~^Program to refile the message
  98 .Ps
  99 ^lproc:~^Program to list the contents of a message
 100 .Ps
 101 ^sendproc:~^Program to use to send the message
 102 .Ps
 103 ^whomproc:~^Program to determine who a message would go to
 104 .Sa
 105 send(1), whom(1)
 106 .De
 107 `\-prompt\ \*(lqWhat\ Now?\ \*(rq'
 108 .Co
 109 None
 110 .Bu
 111 The argument to the `\-prompt' switch must be interpreted as a single token
 112 by the shell that invokes \fIwhatnow\fR.
 113 Therefore,
 114 one must usually place the argument to this switch inside double\-quotes.
 115
 116 If the initial edit fails, \fIwhatnow\fR deletes your draft (by renaming
 117 it with a leading comma); failure of a later edit preverves the draft.
 118
 119 If \fIwhatnowproc\fR is \fIwhatnow\fR,
 120 then \fIcomp\fR, \fIdist\fP, \fIforw\fP, and \fIrepl\fP use
 121 a built\-in \fIwhatnow\fR,
 122 and do not actually run the \fIwhatnow\fR program.
 123 Hence, if you define your own \fIwhatnowproc\fR,
 124 don't call it \fIwhatnow\fR since it won't be run.
 125
 126 If \fIsendproc\fR is \fIsend\fR,
 127 then \fIwhatnow\fR uses a built\-in \fIsend\fR,
 128 it does not actually run the \fIsend\fR program.
 129 Hence, if you define your own \fIsendproc\fR,
 130 don't call it \fIsend\fR since \fIwhatnow\fR won't run it.
 131 .En