1 .TH DIST %manext1% "June 18, 2012" "%nmhversion%"
6 dist \- redistribute a message to additional addresses
15 .RB [ \-annotate " | " \-noannotate ]
16 .RB [ \-inplace " | " \-noinplace ]
21 .RB [ \-nodraftfolder ]
37 .RB [ \-nowhatnowproc ]
47 It prepares the specified message
48 for redistribution to addresses that (presumably) are not on the original
51 The default message form contains the following elements:
55 Resent-From: {from switch} or <Local-Mailbox> or <username@hostname>
56 Resent-To: {to switch} or blank
57 Resent-cc: {cc switch} or blank
58 Resent-fcc: {fcc switch} or blank
63 .RI \*(lq distcomps \*(rq
64 exists in the user's nmh directory, it
65 will be used instead of this default form. You may specify an alternate
66 forms file with the switch
69 Forms are processed via the
73 for details. Components from the redistributed message are available
74 as standard component escapes in the forms file.
76 In addition to the standard
78 escapes, the following
80 escapes are also supported:
84 .ta \w'Escape 'u +\w'Returns 'u
85 .I "Escape Returns Description"
86 fcc string Any folders specified with `\-fcc\ folder'
87 nmh\-from string Addresses specified with `\-from\ address'
88 nmh\-to string Addresses specified with `\-to\ address'
89 nmh\-cc string Addresses specified with `\-cc\ address'
95 man page for descriptions of the
103 If the draft already exists,
105 will ask you as to the disposition of the draft. A reply of
109 leaving the draft intact;
111 will replace the existing draft with a blank skeleton; and
113 will display the draft.
115 Only those addresses in
116 .RI \*(lq Resent\-To: \*(rq,
117 .RI \*(lq Resent\-cc: \*(rq,
119 .RI \*(lq Resent\-Bcc: \*(rq
120 will be sent. Also, a
121 .RI \*(lq "Resent\-Fcc: folder" \*(rq
126 the draft should contain only
127 .RI \*(lq Resent\-xxx: \*(rq
128 fields and no body. The headers and the body of
129 the original message are copied to the draft when the message is sent.
130 Use care in constructing the headers for the redistribution.
132 Because the draft is minimal, the
134 editor is quite useful with
139 switch is given, the message being distributed will
140 be annotated with the lines:
146 where each address list contains as many lines as required. This
147 annotation will be done only if the message is sent directly from
149 If the message is not sent immediately from
153 may be used to re\-edit and send the constructed
154 message, but the annotations won't take place. Normally annotations are
155 done inplace in order to preserve any links to the message. You may use
158 switch to change this.
162 for a description of the
166 switches. Note that while in the editor, with
168 and if the current directory is writable, the message being resent
169 is available through a link named \*(lq@\*(rq (assuming the default
171 In addition, the actual pathname of the message is
172 stored in the environment variable
175 the folder containing the message is stored in the environment variable
177 The creation of the \*(lq@\*(rq file is controlled via the
191 draft folder facility. This is an advanced (and highly
192 useful) feature. Consult the
194 man page for more information.
196 Upon exiting from the editor,
202 for a discussion of available options. The invocation of this
203 program can be inhibited by using the
205 switch. (In truth of fact, it is the
207 program which starts the initial edit. Hence,
209 will prevent any edit from occurring.)
213 .ta \w'%etcdir%/ExtraBigFileName 'u
214 ^%etcdir%/distcomps~^The standard message skeleton
215 ^or <mh\-dir>/distcomps~^Rather than the standard skeleton
216 ^$HOME/\&.mh\(ruprofile~^The user profile
217 ^<mh\-dir>/draft~^The draft file
219 .SH "PROFILE COMPONENTS"
223 .ta \w'ExtraBigProfileName 'u
224 ^Path:~^To determine the user's nmh directory
225 ^Current\-Folder:~^To find the default current folder
226 ^Draft\-Folder:~^To find the default draft\-folder
227 ^Editor:~^To override the default editor
228 ^fileproc:~^Program to refile the message
229 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
240 .RB ` +folder "' defaults to the current folder"
241 .RB ` msg "' defaults to cur"
243 .RB ` \-nodraftfolder '
248 If a folder is given, it will become the current folder. The message
249 distributed will become the current message.
252 originally used headers of the form
253 .RI \*(lq Distribute\-xxx: \*(rq
255 .RI \*(lq Resent\-xxx: \*(rq.
256 In order to conform with the ARPA Internet standard, RFC\-822, the
257 .RI \*(lq Resent\-xxx: \*(rq
261 .RI \*(lq Distribute\-xxx: \*(rq
262 type headers and automatically convert them to
263 .RI \*(lq Resent\-xxx: \*(rq.
266 does not rigorously check the message being distributed
267 for adherence to the transport standard, but
273 program will balk (and rightly so) at poorly formatted messages, and
275 won't correct things for you.
285 it does not actually run the
288 Hence, if you define your own