4 .TH DIST %manext1% "%nmhdate%" MH.6.8 [%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.
134 switch is given, the message being distributed will
135 be annotated with the lines:
140 where each address list contains as many lines as required. This
141 annotation will be done only if the message is sent directly from
143 If the message is not sent immediately from
147 may be used to re\-edit and send the constructed
148 message, but the annotations won't take place. Normally annotations are
149 done inplace in order to preserve any links to the message. You may use
152 switch to change this.
156 for a description of the
160 switches. Note that while in the editor, the message being resent
161 is available through a link named \*(lq@\*(rq (assuming the default
163 In addition, the actual pathname of the message is
164 stored in the environment variable
167 the folder containing the message is stored in the environment variable
169 The creation of the \*(lq@\*(rq file and associated environment variables
170 can be controlled via the
184 draft folder facility. This is an advanced (and highly
185 useful) feature. Consult the
187 man page for more information.
189 Upon exiting from the editor,
195 for a discussion of available options. The invocation of this
196 program can be inhibited by using the
198 switch. (In truth of fact, it is the
200 program which starts the initial edit. Hence,
202 will prevent any edit from occurring.)
207 .ta \w'%etcdir%/ExtraBigFileName 'u
208 ^%etcdir%/distcomps~^The standard message skeleton
209 ^or <mh\-dir>/distcomps~^Rather than the standard skeleton
210 ^$HOME/\&.mh\(ruprofile~^The user profile
211 ^<mh\-dir>/draft~^The draft file
214 .SH "PROFILE COMPONENTS"
218 .ta \w'ExtraBigProfileName 'u
219 ^Path:~^To determine the user's nmh directory
220 ^Current\-Folder:~^To find the default current folder
221 ^Draft\-Folder:~^To find the default draft\-folder
222 ^Editor:~^To override the default editor
223 ^fileproc:~^Program to refile the message
224 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
228 comp(1), forw(1), repl(1), send(1), whatnow(1)
232 .RB ` +folder "' defaults to the current folder"
233 .RB ` msg "' defaults to cur"
235 .RB ` \-nodraftfolder '
241 If a folder is given, it will become the current folder. The message
242 distributed will become the current message.
246 originally used headers of the form
247 .RI \*(lq Distribute\-xxx: \*(rq
249 .RI \*(lq Resent\-xxx: \*(rq.
250 In order to conform with the ARPA Internet standard, RFC\-822, the
251 .RI \*(lq Resent\-xxx: \*(rq
255 .RI \*(lq Distribute\-xxx: \*(rq
256 type headers and automatically convert them to
257 .RI \*(lq Resent\-xxx: \*(rq.
261 does not rigorously check the message being distributed
262 for adherence to the transport standard, but
268 program will balk (and rightly so) at poorly formatted messages, and
270 won't correct things for you.
280 it does not actually run the
283 Hence, if you define your own
291 If your current working directory is not writable, the link named
292 \*(lq@\*(rq is not available.