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 nmh message system
   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 nmh
  37 `msgs' convention to the
  38 .B send
  39 command..
  40 If no `msgs' are given, it defaults to `c'.
  41 .PP
  42 .RS
  43 .nf
  44 send first
  45 .fi
  46 .RE
  47 .PP
  48 To make all this a bit more clear, here are some examples:
  49 .RE
  50 .PP
  51 Any of the commands
  52 .PP
  53 .RS 5
  54 .nf
  55 comp
  56 dist
  57 forw
  58 repl
  59 .fi
  60 .RE
  61 .PP
  62 constructs the message draft in the draft folder using the `b'
  63 message number.  Furthermore, they each define `c' in this folder to
  64 be that message draft.  If the user were to use the
  65 .B quit
  66 option at `What now?' level, then later on, if no other draft composition
  67 was done, the draft could be sent with simply
  68 .PP
  69 .RS 5
  70 .nf
  71 send
  72 .fi
  73 .RE
  74 .PP
  75 Or, if more editing was required, the draft could be edited with
  76 .PP
  77 .RS 5
  78 .nf
  79 comp -use
  80 .fi
  81 .RE
  82 .PP
  83 Instead, if other drafts had been composed in the meantime, so that this
  84 message draft was no longer known as `c' in the `draft' folder, then
  85 the user could
  86 .B scan
  87 the folder to see which message draft in the
  88 folder should be used for editing or sending.  Clever users could even
  89 employ a back-quoted
  90 .B pick
  91 to do the work:
  92 .PP
  93 .RS 5
  94 .nf
  95 comp -use `pick +drafts -to nmh-workers`
  96 .fi
  97 .RE
  98 .PP
  99 or
 100 .PP
 101 .RS 5
 102 .nf
 103 send `pick +drafts -to nmh-workers`
 104 .fi
 105 .RE
 106 .PP
 107 Note that in the
 108 .B comp
 109 example, the output from
 110 .B pick
 111 must resolve to a single message draft (it makes no sense to talk about
 112 composing two or more drafts with one invocation of
 113 .BR comp ).
 114 In contrast, in the
 115 .B send
 116 example, as many message drafts as desired can appear, since
 117 .B send
 118 doesn't mind sending more than one draft at a time.
 119 .PP
 120 It is important to realize that
 121 .B nmh
 122 treats the draft folder like a standard
 123 .B nmh
 124 folder in nearly all respects.  There is one exception:
 125 Although conceptually
 126 .B send
 127 deletes the `msgs' named in the draft folder, it does not call
 128 .I delete\-prog
 129 to perform the deletion.
 130 .SH CONTEXT
 131 None