5 .TH DIST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
7 dist \- redistribute a message to additional addresses
15 .RB [ \-annotate " | " \-noannotate ]
16 .RB [ \-inplace " | " \-noinplace ]
21 .RB [ \-nodraftfolder ]
27 .RB [ \-nowhatnowproc ]
34 It prepares the specified message
35 for redistribution to addresses that (presumably) are not on the original
38 The default message form contains the following elements:
47 .RI \*(lq distcomps \*(rq
48 exists in the user's nmh directory, it
49 will be used instead of this default form. You may specify an alternate
50 forms file with the switch
53 The form used will be prepended to the message being resent.
55 If the draft already exists,
57 will ask you as to the disposition of the draft. A reply of
61 leaving the draft intact;
63 will replace the existing draft with a blank skeleton; and
65 will display the draft.
67 Only those addresses in
68 .RI \*(lq Resent\-To: \*(rq,
69 .RI \*(lq Resent\-cc: \*(rq,
71 .RI \*(lq Resent\-Bcc: \*(rq
73 .RI \*(lq "Resent\-Fcc: folder" \*(rq
78 the draft should contain only
79 .RI \*(lq Resent\-xxx: \*(rq
80 fields and no body. The headers and the body of
81 the original message are copied to the draft when the message is sent.
82 Use care in constructing the headers for the redistribution.
86 switch is given, the message being distributed will
87 be annotated with the lines:
92 where each address list contains as many lines as required. This
93 annotation will be done only if the message is sent directly from
95 If the message is not sent immediately from
99 may be used to re\-edit and send the constructed
100 message, but the annotations won't take place. Normally annotations are
101 done inplace in order to preserve any links to the message. You may use
104 switch to change this.
108 for a description of the
112 switches. Note that while in the editor, the message being resent
113 is available through a link named \*(lq@\*(rq (assuming the default
115 In addition, the actual pathname of the message is
116 stored in the environment variable
119 the folder containing the message is stored in the environment variable
130 draft folder facility. This is an advanced (and highly
131 useful) feature. Consult the
133 man page for more information.
135 Upon exiting from the editor,
141 for a discussion of available options. The invocation of this
142 program can be inhibited by using the
144 switch. (In truth of fact, it is the
146 program which starts the initial edit. Hence,
148 will prevent any edit from occurring.)
153 .ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
154 ^%etcdir%/distcomps~^The standard message skeleton
155 ^or <mh\-dir>/distcomps~^Rather than the standard skeleton
156 ^$HOME/\&.mh\(ruprofile~^The user profile
157 ^<mh\-dir>/draft~^The draft file
159 .SH "PROFILE COMPONENTS"
163 .ta \w'ExtraBigProfileName 'u
164 ^Path:~^To determine the user's nmh directory
165 ^Current\-Folder:~^To find the default current folder
166 ^Draft\-Folder:~^To find the default draft\-folder
167 ^Editor:~^To override the default editor
168 ^fileproc:~^Program to refile the message
169 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
172 comp(1), forw(1), repl(1), send(1), whatnow(1)
175 .RB ` +folder "' defaults to the current folder"
176 .RB ` msg "' defaults to cur"
178 .RB ` \-nodraftfolder '
182 If a folder is given, it will become the current folder. The message
183 distributed will become the current message.
187 originally used headers of the form
188 .RI \*(lq Distribute\-xxx: \*(rq
190 .RI \*(lq Resent\-xxx: \*(rq.
191 In order to conform with the ARPA Internet standard, RFC\-822, the
192 .RI \*(lq Resent\-xxx: \*(rq
196 .RI \*(lq Distribute\-xxx: \*(rq
197 type headers and automatically convert them to
198 .RI \*(lq Resent\-xxx: \*(rq.
202 does not rigorously check the message being distributed
203 for adherence to the transport standard, but
209 program will balk (and rightly so) at poorly formatted messages, and
211 won't correct things for you.
221 it does not actually run the
224 Hence, if you define your own
232 If your current working directory is not writable, the link named
233 \*(lq@\*(rq is not available.