1 .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.
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, the message being resent
167 is available through a link named \*(lq@\*(rq (assuming the default
169 In addition, the actual pathname of the message is
170 stored in the environment variable
173 the folder containing the message is stored in the environment variable
175 The creation of the \*(lq@\*(rq file and associated environment variables
176 can be controlled via the
190 draft folder facility. This is an advanced (and highly
191 useful) feature. Consult the
193 man page for more information.
195 Upon exiting from the editor,
201 for a discussion of available options. The invocation of this
202 program can be inhibited by using the
204 switch. (In truth of fact, it is the
206 program which starts the initial edit. Hence,
208 will prevent any edit from occurring.)
212 .ta \w'%etcdir%/ExtraBigFileName 'u
213 ^%etcdir%/distcomps~^The standard message skeleton
214 ^or <mh\-dir>/distcomps~^Rather than the standard skeleton
215 ^$HOME/\&.mh\(ruprofile~^The user profile
216 ^<mh\-dir>/draft~^The draft file
218 .SH "PROFILE COMPONENTS"
222 .ta \w'ExtraBigProfileName 'u
223 ^Path:~^To determine the user's nmh directory
224 ^Current\-Folder:~^To find the default current folder
225 ^Draft\-Folder:~^To find the default draft\-folder
226 ^Editor:~^To override the default editor
227 ^fileproc:~^Program to refile the message
228 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
239 .RB ` +folder "' defaults to the current folder"
240 .RB ` msg "' defaults to cur"
242 .RB ` \-nodraftfolder '
247 If a folder is given, it will become the current folder. The message
248 distributed will become the current message.
251 originally used headers of the form
252 .RI \*(lq Distribute\-xxx: \*(rq
254 .RI \*(lq Resent\-xxx: \*(rq.
255 In order to conform with the ARPA Internet standard, RFC\-822, the
256 .RI \*(lq Resent\-xxx: \*(rq
260 .RI \*(lq Distribute\-xxx: \*(rq
261 type headers and automatically convert them to
262 .RI \*(lq Resent\-xxx: \*(rq.
265 does not rigorously check the message being distributed
266 for adherence to the transport standard, but
272 program will balk (and rightly so) at poorly formatted messages, and
274 won't correct things for you.
284 it does not actually run the
287 Hence, if you define your own
295 If your current working directory is not writable, the link named
296 \*(lq@\*(rq is not available.