git.marmaro.de Git - mmh/blob - man/mh-draft.man7

   1 .\"
   2 .\" %nmhwarning%
   3 .\"
   4 .TH MH-DRAFT %manext7% "%nmhdate%" MH.6.8 [%nmhversion%]
   5 .SH NAME
   6 mh-draft \- draft folder facility for mmh
   7 .SH DESCRIPTION
   8 There are a number of interesting advanced facilities for the composition of
   9 outgoing mail.
  10 .PP
  11 .SS "The Draft Folder"
  12 The
  13 .BR comp ,
  14 .BR dist ,
  15 .BR forw ,
  16 and
  17 .B repl
  18 commands allow you to manipulate various draft messages simultanely
  19 .PP
  20 Draft messages are created in the draft folder.
  21 (The
  22 .RI ` Draft\-Folder '
  23 profile entry may be used to change the default draft folder.
  24 .PP
  25 New drafts are created unless the user invokes
  26 .B comp
  27 with
  28 .BR \-use ,
  29 in which case the current draft is used.
  30 .PP
  31 The last draft message
  32 the user was composing is the current message in the draft folder.
  33 .PP
  34 The user can send off whatever drafts desired from the shell using the
  35 standard
  36 .B mmh
  37 `msgs' convention to the
  38 .B send
  39 command:
  40 .PP
  41 .RS
  42 .nf
  43 send f
  44 .fi
  45 .RE
  46 .PP
  47 If no `msgs' are given, the current message is used.
  48 .PP
  49 To make all this a bit more clear, here are some examples:
  50 .RE
  51 .PP
  52 Any of the commands
  53 .PP
  54 .RS 5
  55 .nf
  56 comp
  57 dist
  58 forw
  59 repl
  60 .fi
  61 .RE
  62 .PP
  63 constructs the message draft in the draft folder using the `b'
  64 message number.  Furthermore, they each define `c' in this folder to
  65 be that message draft.  If the user were to use the
  66 .B quit
  67 option at `What now?' level, then later on, if no other draft composition
  68 was done, the draft could be sent with simply
  69 .PP
  70 .RS 5
  71 .nf
  72 send
  73 .fi
  74 .RE
  75 .PP
  76 Or, if more editing was required, the draft could be edited with
  77 .PP
  78 .RS 5
  79 .nf
  80 comp \-use
  81 .fi
  82 .RE
  83 .PP
  84 Instead, if other drafts had been composed in the meantime, so that this
  85 message draft was no longer known as `c' in the `draft' folder, then
  86 the user could
  87 .B scan
  88 the folder to see which message draft in the
  89 folder should be used for editing or sending.  Clever users could even
  90 employ a back-quoted
  91 .B pick
  92 to do the work:
  93 .PP
  94 .RS 5
  95 .nf
  96 comp \-use `pick +drafts \-to nmh-workers`
  97 .fi
  98 .RE
  99 .PP
 100 or
 101 .PP
 102 .RS 5
 103 .nf
 104 send `pick +drafts \-to nmh-workers`
 105 .fi
 106 .RE
 107 .PP
 108 Note that in the
 109 .B comp
 110 example, the output from
 111 .B pick
 112 must resolve to a single message draft (it makes no sense to talk about
 113 composing two or more drafts with one invocation of
 114 .BR comp ).
 115 In contrast, in the
 116 .B send
 117 example, as many message drafts as desired can appear, since
 118 .B send
 119 doesn't mind sending more than one draft at a time.
 120 .PP
 121 It is important to realize that
 122 .B mmh
 123 treats the draft folder like a standard
 124 .B MH
 125 folder.
 126 .SH CONTEXT
 127 None