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 mmh 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 line:
75 This annotation will be done only if the message is sent directly from
77 If the message is not sent immediately from
81 may be used to re\-edit and send the constructed
82 message, but the annotations won't take place. Normally annotations are
83 done inplace in order to preserve any links to the message. You may use
86 switch to change this.
90 for a description of the
94 switches. Note that while in the editor, the message being resent
95 is available through a link named \*(lq@\*(rq (assuming the default
97 In addition, the actual pathname of the message is
98 stored in the environment variable
101 the folder containing the message is stored in the environment variable
106 man page for more information.
108 Upon exiting from the editor,
114 for a discussion of available options. The invocation of this
115 program can be inhibited by using the
117 switch. (In truth of fact, it is the
119 program which starts the initial edit. Hence,
121 will prevent any edit from occurring.)
126 .ta \w'%etcdir%/ExtraBigFileName 'u
127 ^%etcdir%/distcomps~^The standard message skeleton
128 ^or $HOME/.mmh/distcomps~^Rather than the standard skeleton
129 ^$HOME/.mmh/profile~^The user profile
130 ^+drafts~^The draft folder
133 .SH "PROFILE COMPONENTS"
137 .ta \w'ExtraBigProfileName 'u
138 ^Path:~^To determine the user's mail storage
139 ^Current\-Folder:~^To find the default current folder
140 ^Draft\-Folder:~^To set the default draft\-folder
141 ^Editor:~^To override the default editor
142 ^fileproc:~^Program to refile the message
143 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
147 comp(1), forw(1), repl(1), send(1), whatnow(1)
151 .RB ` +folder "' defaults to the current folder"
152 .RB ` msg "' defaults to cur"
158 If a folder is given, it will become the current folder. The message
159 distributed will become the current message.
163 originally used headers of the form
164 .RI \*(lq Distribute\-xxx: \*(rq
166 .RI \*(lq Resent\-xxx: \*(rq.
167 In order to conform with the ARPA Internet standard, RFC\-822, the
168 .RI \*(lq Resent\-xxx: \*(rq
172 .RI \*(lq Distribute\-xxx: \*(rq
173 type headers and automatically convert them to
174 .RI \*(lq Resent\-xxx: \*(rq.
178 does not rigorously check the message being distributed
179 for adherence to the transport standard, but
185 program will balk (and rightly so) at poorly formatted messages, and
187 won't correct things for you.
197 it does not actually run the
200 Hence, if you define your own
208 If your current working directory is not writable, the link named
209 \*(lq@\*(rq is not available.