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 ]
22 .RB [ \-nowhatnowproc ]
30 It prepares the specified message
31 for redistribution to addresses that (presumably) are not on the original
34 The default message form contains the following elements:
43 .RI \*(lq distcomps \*(rq
44 exists in the user's nmh directory, it
45 will be used instead of this default form. You may specify an alternate
46 forms file with the switch
49 The form used will be prepended to the message being resent.
51 Only those addresses in
52 .RI \*(lq Resent\-To: \*(rq,
53 .RI \*(lq Resent\-cc: \*(rq,
55 .RI \*(lq Resent\-Bcc: \*(rq
57 .RI \*(lq "Resent\-Fcc: folder" \*(rq
62 the draft should contain only
63 .RI \*(lq Resent\-xxx: \*(rq
64 fields and no body. The headers and the body of
65 the original message are copied to the draft when the message is sent.
66 Use care in constructing the headers for the redistribution.
70 switch is given, the message being distributed will
71 be annotated with the lines:
76 where each address list contains as many lines as required. This
77 annotation will be done only if the message is sent directly from
79 If the message is not sent immediately from
83 may be used to re\-edit and send the constructed
84 message, but the annotations won't take place. Normally annotations are
85 done inplace in order to preserve any links to the message. You may use
88 switch to change this.
92 for a description of the
96 switches. Note that while in the editor, the message being resent
97 is available through a link named \*(lq@\*(rq (assuming the default
99 In addition, the actual pathname of the message is
100 stored in the environment variable
103 the folder containing the message is stored in the environment variable
108 man page for more information.
110 Upon exiting from the editor,
116 for a discussion of available options. The invocation of this
117 program can be inhibited by using the
119 switch. (In truth of fact, it is the
121 program which starts the initial edit. Hence,
123 will prevent any edit from occurring.)
128 .ta \w'%etcdir%/ExtraBigFileName 'u
129 ^%etcdir%/distcomps~^The standard message skeleton
130 ^or <mh\-dir>/distcomps~^Rather than the standard skeleton
131 ^$HOME/\&.mh\(ruprofile~^The user profile
132 ^<mh\-dir>/drafts~^The draft folder
135 .SH "PROFILE COMPONENTS"
139 .ta \w'ExtraBigProfileName 'u
140 ^Path:~^To determine the user's nmh directory
141 ^Current\-Folder:~^To find the default current folder
142 ^Draft\-Folder:~^To set the default draft\-folder
143 ^Editor:~^To override the default editor
144 ^fileproc:~^Program to refile the message
145 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
149 comp(1), forw(1), repl(1), send(1), whatnow(1)
153 .RB ` +folder "' defaults to the current folder"
154 .RB ` msg "' defaults to cur"
160 If a folder is given, it will become the current folder. The message
161 distributed will become the current message.
165 originally used headers of the form
166 .RI \*(lq Distribute\-xxx: \*(rq
168 .RI \*(lq Resent\-xxx: \*(rq.
169 In order to conform with the ARPA Internet standard, RFC\-822, the
170 .RI \*(lq Resent\-xxx: \*(rq
174 .RI \*(lq Distribute\-xxx: \*(rq
175 type headers and automatically convert them to
176 .RI \*(lq Resent\-xxx: \*(rq.
180 does not rigorously check the message being distributed
181 for adherence to the transport standard, but
187 program will balk (and rightly so) at poorly formatted messages, and
189 won't correct things for you.
199 it does not actually run the
202 Hence, if you define your own
210 If your current working directory is not writable, the link named
211 \*(lq@\*(rq is not available.