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 ]
45 It prepares the specified message
46 for redistribution to addresses that (presumably) are not on the original
49 The default message form contains the following elements:
53 Resent-From: {from switch} or <Local-Mailbox> or <username@hostname>
54 Resent-To: {to switch} or blank
55 Resent-cc: {cc switch} or blank
56 Resent-fcc: {fcc switch} or blank
61 .RI \*(lq distcomps \*(rq
62 exists in the user's nmh directory, it
63 will be used instead of this default form. You may specify an alternate
64 forms file with the switch
67 Forms are processed via the
71 for details. Components from the redistributed message are available
72 as standard component escapes in the forms file.
74 In addition to the standard
76 escapes, the following
78 escapes are also supported:
82 .ta \w'Escape 'u +\w'Returns 'u
83 .I Escape Returns Description
84 fcc string Any folders specified with `\-fcc\ folder'
85 nmh\-from string Addresses specified with `\-from\ address'
86 nmh\-to string Addresses specified with `\-to\ address'
87 nmh\-cc string Addresses specified with `\-cc\ address'
93 man page for descriptions of the
101 If the draft already exists,
103 will ask you as to the disposition of the draft. A reply of
107 leaving the draft intact;
109 will replace the existing draft with a blank skeleton; and
111 will display the draft.
113 Only those addresses in
114 .RI \*(lq Resent\-To: \*(rq,
115 .RI \*(lq Resent\-cc: \*(rq,
117 .RI \*(lq Resent\-Bcc: \*(rq
118 will be sent. Also, a
119 .RI \*(lq "Resent\-Fcc: folder" \*(rq
124 the draft should contain only
125 .RI \*(lq Resent\-xxx: \*(rq
126 fields and no body. The headers and the body of
127 the original message are copied to the draft when the message is sent.
128 Use care in constructing the headers for the redistribution.
132 switch is given, the message being distributed will
133 be annotated with the lines:
138 where each address list contains as many lines as required. This
139 annotation will be done only if the message is sent directly from
141 If the message is not sent immediately from
145 may be used to re\-edit and send the constructed
146 message, but the annotations won't take place. Normally annotations are
147 done inplace in order to preserve any links to the message. You may use
150 switch to change this.
154 for a description of the
158 switches. Note that while in the editor, the message being resent
159 is available through a link named \*(lq@\*(rq (assuming the default
161 In addition, the actual pathname of the message is
162 stored in the environment variable
165 the folder containing the message is stored in the environment variable
176 draft folder facility. This is an advanced (and highly
177 useful) feature. Consult the
179 man page for more information.
181 Upon exiting from the editor,
187 for a discussion of available options. The invocation of this
188 program can be inhibited by using the
190 switch. (In truth of fact, it is the
192 program which starts the initial edit. Hence,
194 will prevent any edit from occurring.)
199 .ta \w'%etcdir%/ExtraBigFileName 'u
200 ^%etcdir%/distcomps~^The standard message skeleton
201 ^or <mh\-dir>/distcomps~^Rather than the standard skeleton
202 ^$HOME/\&.mh\(ruprofile~^The user profile
203 ^<mh\-dir>/draft~^The draft file
206 .SH "PROFILE COMPONENTS"
210 .ta \w'ExtraBigProfileName 'u
211 ^Path:~^To determine the user's nmh directory
212 ^Current\-Folder:~^To find the default current folder
213 ^Draft\-Folder:~^To find the default draft\-folder
214 ^Editor:~^To override the default editor
215 ^fileproc:~^Program to refile the message
216 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
220 comp(1), forw(1), repl(1), send(1), whatnow(1)
224 .RB ` +folder "' defaults to the current folder"
225 .RB ` msg "' defaults to cur"
227 .RB ` \-nodraftfolder '
232 If a folder is given, it will become the current folder. The message
233 distributed will become the current message.
237 originally used headers of the form
238 .RI \*(lq Distribute\-xxx: \*(rq
240 .RI \*(lq Resent\-xxx: \*(rq.
241 In order to conform with the ARPA Internet standard, RFC\-822, the
242 .RI \*(lq Resent\-xxx: \*(rq
246 .RI \*(lq Distribute\-xxx: \*(rq
247 type headers and automatically convert them to
248 .RI \*(lq Resent\-xxx: \*(rq.
252 does not rigorously check the message being distributed
253 for adherence to the transport standard, but
259 program will balk (and rightly so) at poorly formatted messages, and
261 won't correct things for you.
271 it does not actually run the
274 Hence, if you define your own
282 If your current working directory is not writable, the link named
283 \*(lq@\*(rq is not available.