Added test of -nosequence to test-pick.
[mmh] / docs / historical / mh-6.8.5 / doc / forw.me
1 .\"     This file is automatically generated.  Do not edit!
2 .\" @(#)$Id: forw.rf,v 1.11 1992/10/16 21:36:02 jromine Exp $
3 .SC FORW 1
4 .NA
5 forw \- forward messages
6 .SY
7 forw
8 \%[+folder] \%[msgs]
9 \%[\-annotate] \%[\-noannotate]
10 \%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
11 \%[\-editor\ editor] \%[\-noedit]
12 \%[\-filter\ filterfile]
13 \%[\-form\ formfile]
14 \%[\-format] \%[\-noformat]
15 \%[\-inplace] \%[\-noinplace]
16 \%[\-mime] \%[\-nomime]
17 \%[\-whatnowproc\ program] \%[\-nowhatnowproc]
18 \%[\-help]
19
20 .ti .5i
21 forw
22 \%[+folder] \%[msgs]
23 \%[\-digest\ list] \%[\-issue\ number] \%[\-volume\ number]
24 \%[other\ switches\ for\ \fIforw\fR]
25 \%[\-help]
26 .DE
27 \fIForw\fR may be used to prepare a message containing other
28 messages.
29 It constructs the new message from the components file
30 or `\-form\ formfile' (see \fIcomp\fR\0), with a body composed of the
31 message(s) to be forwarded.
32 An editor is invoked as in \fIcomp\fR,
33 and after editing is complete, the user is prompted before the message
34 is sent.
35
36 The default message form contains the following elements:
37
38 .nf
39 .in +.5i
40 .ne 10
41 .eo
42 .so /opt/mh-6.8.5/lib/forwcomps
43 .ec
44 .in -.5i
45 .fi
46
47 If the file named \*(lqforwcomps\*(rq exists in the user's MH directory,
48 it will be used instead of this form.
49 In either case, the file specified by `\-form\ formfile' will be
50 used if given.
51
52 If the draft already exists,
53 \fIforw\fR will ask you as to the disposition of the draft.
54 A reply of \fBquit\fR will abort \fIforw\fR, leaving the draft intact;
55 \fBreplace\fR will replace the existing draft with a blank skeleton;
56 and \fBlist\fR will display the draft.
57
58 If the `\-annotate' switch is given, each message being
59 forwarded will be annotated with the lines
60
61      Forwarded:\ date
62      Forwarded:\ addrs
63
64 where each address list contains as many lines as required.
65 This annotation
66 will be done only if the message is sent directly from \fIforw\fR.
67 If the message is not sent immediately from \fIforw\fR,
68 \*(lqcomp\ \-use\*(rq may be used to re\-edit and send the constructed message,
69 but
70 the annotations won't take place.
71 The '\-inplace' switch causes annotation to
72 be done in place in order to preserve links to the annotated message.
73
74 See \fIcomp\fR\0(1) for a description of the `\-editor' and `\-noedit'
75 switches.
76
77 Although \fIforw\fR uses the `\-form\ formfile' switch to direct it how to
78 construct the beginning of the draft, the `\-filter\ filterfile',
79 `\-format', and `\-noformat'
80 switches direct \fIforw\fR as to how each forwarded message should be
81 formatted in the body of the draft.
82 If `\-noformat' is specified,
83 then each forwarded message is output exactly as it appears.
84 If `\-format' or `\-filter\ filterfile' is specified,
85 then each forwarded message is filtered (re\-formatted) prior to being
86 output to the body of the draft.
87 The filter file for \fIforw\fR should be a standard form file for
88 \fImhl\fR,
89 as \fIforw\fR will invoke \fImhl\fR to format the forwarded messages.
90 The default message filter (what you get with `\-format') is:
91
92 .nf
93 .in +.5i
94 .ne 10
95 .eo
96 .so /opt/mh-6.8.5/lib/mhl.forward
97 .ec
98 .in -.5i
99 .fi
100
101 If the file named \*(lqmhl.forward\*(rq exists in the user's MH directory,
102 it will be used instead of this form.
103 In either case, the file specified by `\-filter\ filterfile' will be
104 used if given.
105 To summarize:
106 `\-noformat' will reproduce each forwarded message exactly,
107 `\-format' will use \fImhl\fR and a default filterfile, \*(lqmhl.forward\*(rq,
108 to format each forwarded message, and
109 `\-filter\ filterfile' will use the named filterfile to format each
110 forwarded message with \fImhl\fR.
111
112 Each forwarded message is separated with an encapsulation delimiter 
113 and
114 dashes in the first column of the forwarded messages will be prepended
115 with `\-\ ' so that
116 when received, the message is suitable for bursting by \fIburst\fR\0(1).
117 This follows the Internet RFC\-934 guidelines.
118
119 For users of \fIprompter\fR\0(1), by specifying prompter's `-prepend'
120 switch in the \&.mh\(ruprofile file, any commentary text is entered before
121 the forwarded messages.  (A major win!)
122
123 To use the MIME rules for encapsulation,
124 specify the `\-mime' switch.
125 This directs \fIforw\fR to generate an \fImhn\fR composition file.
126 Note that MH will not invoke \fImhn\fR automatically,
127 unless you  add this line to your \&.mh\(ruprofile file:
128 .sp
129 .in +.5i
130 automhnproc: mhn
131 .in -.5i
132 .sp
133 Otherwise,
134 you must specifically give the command
135 .sp
136 .in +.5i
137 What now? edit mhn
138 .in -.5i
139 .sp
140 prior to sending the draft.
141
142 To automate this somewhat,
143 create a link to \fIprompter\fR called \fIrapid\fR
144 and put these lines in your \&.mh\(ruprofile file:
145 .sp
146 .in +.5i
147 .nf
148 forw: -editor rapid -mime
149 rapid: -rapid
150 rapid-next: mhn
151 .fi
152 .in -.5i
153 .sp
154 Then,
155 you can simply do:
156 .sp
157 .in +.5i
158 .nf
159 \fIforw msgs\fR
160 To: \fImailbox\fR
161 cc:
162 Subject: \fIwhatever\fR
163
164 --------Enter initial text
165
166 \fIblah, blah, blah.\fR
167 <CTRL-D>
168 --------
169
170 What now? \fIedit\fR
171 What now? \fIsend\fR
172 ...
173 .fi
174 .in -.5i
175 .sp
176 The \fIedit\fR command invokes \fImhn\fR automatically.
177
178 The `\-draftfolder\ +folder' and `\-draftmessage\ msg' switches invoke the
179 \fIMH\fR draft folder facility.
180 This is an advanced (and highly useful) feature.
181 Consult the \fBAdvanced Features\fR section of the \fIMH\fR manual for more
182 information.
183
184 Upon exiting from the editor,
185 \fIforw\fR will invoke the \fIwhatnow\fR program.
186 See \fIwhatnow\fR\0(1) for a discussion of available options.
187 The invocation of this program can be inhibited by using the `\-nowhatnowproc'
188 switch.
189 (In truth of fact,
190 it is the \fIwhatnow\fR program which starts the initial edit.
191 Hence, `\-nowhatnowproc' will prevent any edit from occurring.)
192
193 The `\-digest\ list', `\-issue\ number', and `\-volume\ number' switches
194 implement a digest facility for \fIMH\fR.  Specifying these switches
195 enables and/or overloads the following escapes:
196 .sp 1
197 .nf
198 .ta \w'Component  'u +\w'Escape  'u +\w'Returns  'u
199 \fIType\fR      \fIEscape\fR    \fIReturns\fR   \fIDescription\fR
200 \fIcomponent\fR \fIdigest\fR    string  Argument to `\-digest'
201 \fIfunction\fR  \fIcur\fR       integer Argument to `\-volume'
202 \fIfunction\fR  \fImsg\fR       integer Argument to `\-issue'
203 .re
204 .fi
205
206 Consult the \fBAdvanced Features\fR section of 
207 the \fIMH\fR User's Manual for more information on making digests.
208 .Fi
209 ^/opt/mh-6.8.5/lib/forwcomps~^The message skeleton
210 ^or <mh\-dir>/forwcomps~^Rather than the standard skeleton
211 ^/opt/mh-6.8.5/lib/digestcomps~^The message skeleton if `\-digest' is given
212 ^or <mh\-dir>/digestcomps~^Rather than the standard skeleton
213 ^/opt/mh-6.8.5/lib/mhl.forward~^The message filter
214 ^or <mh\-dir>/mhl.forward~^Rather than the standard filter
215 ^$HOME/\&.mh\(ruprofile~^The user profile
216 ^<mh\-dir>/draft~^The draft file
217 .Pr
218 ^Path:~^To determine the user's MH directory
219 .Ps
220 ^Current\-Folder:~^To find the default current folder
221 .Ps
222 ^Draft\-Folder:~^To find the default draft\-folder
223 .Ps
224 ^Editor:~^To override the default editor
225 .Ps
226 ^Msg\-Protect:~^To set mode when creating a new message (draft)
227 .Ps
228 ^fileproc:~^Program to refile the message
229 .Ps
230 ^mhlproc:~^Program to filter messages being forwarded
231 .Ps
232 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
233 .Sa
234 \fIProposed Standard for Message Encapsulation\fR (aka RFC\-934),
235 .br
236 comp(1), dist(1), repl(1), send(1), whatnow(1), mh\-format(5)
237 .De
238 `+folder' defaults to the current folder
239 `msgs' defaults to cur
240 .Ds
241 `\-noannotate'
242 .Ds
243 `\-nodraftfolder'
244 .Ds
245 `\-noformat'
246 .Ds
247 `\-noinplace'
248 .Ds
249 `\-nomime'
250 .Co
251 If a folder is given, it will become the current folder.
252 The first message forwarded will become the current message.
253 .Bu
254 If \fIwhatnowproc\fR is \fIwhatnow\fR,
255 then \fIforw\fR uses a built\-in \fIwhatnow\fR,
256 it does not actually run the \fIwhatnow\fR program.
257 Hence, if you define your own \fIwhatnowproc\fR,
258 don't call it \fIwhatnow\fR since \fIforw\fR won't run it.
259
260 When \fIforw\fR is told to annotate the messages it forwards,
261 it doesn't actually annotate them until the draft is successfully sent.
262 If from the \fIwhatnowproc\fR,
263 you \fIpush\fR instead of \fIsend\fR,
264 it's possible to confuse \fIforw\fR by re\-ordering the file
265 (e.g., by using `folder\0\-pack') before the message is successfully sent.
266 \fIDist\fR and \fIrepl\fR don't have this problem.
267
268 To avoid prepending the leading dash characters in forwarded messages,
269 there is a `\-nodashmunging' option.  See the \*(lqHidden Features\*(rq
270 section of the \fIMH Administrator's Guide\fR for more details.
271 .En