4 .TH DIST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
6 dist \- redistribute a message to additional addresses
15 .RB [ \-annotate " | " \-noannotate ]
21 .RB [ \-nowhatnowproc ]
29 It prepares the specified message
30 for redistribution to addresses that (presumably) are not on the original
33 The default message form contains the following elements:
42 .RI \*(lq distcomps \*(rq
43 exists in the user's mmh directory, it
44 will be used instead of this default form. You may specify an alternate
45 forms file with the switch
48 The form used will be prepended to the message being resent.
50 Only those addresses in
51 .RI \*(lq Resent\-To: \*(rq,
52 .RI \*(lq Resent\-Cc: \*(rq,
54 .RI \*(lq Resent\-Bcc: \*(rq
56 .RI \*(lq "Resent\-Fcc: folder" \*(rq
61 the draft should contain only
62 .RI \*(lq Resent\-xxx: \*(rq
63 fields and no body. The headers and the body of
64 the original message are copied to the draft when the message is sent.
65 Use care in constructing the headers for the redistribution.
69 switch is given, the message being distributed will
70 be annotated with the line:
74 This annotation will be done only if the message is sent directly from
76 If the message is not sent immediately from
80 may be used to re\-edit and send the constructed
81 message, but the annotations won't take place. Annotations are always
82 done inplace in order to preserve any links to the message.
86 for a description of the
90 switches. Note that while in the editor, the message being resent
91 is available through a link named \*(lq@\*(rq (assuming the default
93 In addition, the actual pathname of the message is
94 stored in the environment variable
97 the folder containing the message is stored in the environment variable
102 man page for more information.
104 Upon exiting from the editor,
110 for a discussion of available options. The invocation of this
111 program can be inhibited by using the
113 switch. (In truth of fact, it is the
115 program which starts the initial edit. Hence,
117 will prevent any edit from occurring.)
122 .ta \w'%etcdir%/ExtraBigFileName 'u
123 ^%etcdir%/distcomps~^The standard message skeleton
124 ^or $HOME/.mmh/distcomps~^Rather than the standard skeleton
125 ^$HOME/.mmh/profile~^The user profile
126 ^+drafts~^The draft folder
129 .SH "PROFILE COMPONENTS"
133 .ta \w'ExtraBigProfileName 'u
134 ^Path:~^To determine the user's mail storage
135 ^Current\-Folder:~^To find the default current folder
136 ^Draft\-Folder:~^To set the default draft\-folder
137 ^Editor:~^To override the default editor
138 ^fileproc:~^Program to refile the message
139 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
143 comp(1), forw(1), repl(1), send(1), whatnow(1)
147 .RB ` +folder "' defaults to the current folder"
148 .RB ` msg "' defaults to cur"
153 If a folder is given, it will become the current folder. The message
154 distributed will become the current message.
158 originally used headers of the form
159 .RI \*(lq Distribute\-xxx: \*(rq
161 .RI \*(lq Resent\-xxx: \*(rq.
162 In order to conform with the ARPA Internet standard, RFC\-822, the
163 .RI \*(lq Resent\-xxx: \*(rq
167 .RI \*(lq Distribute\-xxx: \*(rq
168 type headers and automatically convert them to
169 .RI \*(lq Resent\-xxx: \*(rq.
173 does not rigorously check the message being distributed
174 for adherence to the transport standard, but
180 program will balk (and rightly so) at poorly formatted messages, and
182 won't correct things for you.
192 it does not actually run the
195 Hence, if you define your own
203 If your current working directory is not writable, the link named
204 \*(lq@\*(rq is not available.