check for (un)selection befor (un)set
[mmh] / 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