![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to dist.rf CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSD / contrib / mh / conf / doc|
Return to dist.rf CVS log | Up to [CSRG BSD Unix] / 43BSD / contrib / mh / conf / doc |
1.1 root 1: .\" @(MHWARNING)
2: .TH DIST 1 "April 22, 1986" MH [mh.6]
3: .UC 6
4: .SH NAME
5: dist \- redistribute a message to additional addresses
6: .SH SYNOPSIS
7: .in +.5i
8: .ti -.5i
9: dist
10: \%[+folder] \%[msg]
11: \%[\-annotate] \%[\-noannotate]
12: \%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
13: \%[\-editor\ editor] \%[\-noedit]
14: \%[\-form\ formfile]
15: \%[\-inplace] \%[\-noinplace]
16: \%[\-whatnowproc\ program] \%[\-nowhatnowproc]
17: \%[\-help]
18: .in -.5i
19: .SH DESCRIPTION
20: \fIDist\fR is similar to \fIforw\fR.
21: It prepares the specified
22: message for redistribution to addresses that (presumably) are
23: not on the original address list.
24:
25: The default message form contains the following elements:
26:
27: .nf
28: .in +.5i
29: .ne 10
30: .eo
31: .so @(MHETCPATH)/distcomps
32: .ec
33: .in -.5i
34: .fi
35:
36: If the file named \*(lqdistcomps\*(rq exists in the user's MH directory,
37: it will be used instead of this form.
38: In either case, the file specified by `\-form\ formfile' will be
39: used if given.
40: The form used will be prepended to the message being resent.
41:
42: If the draft already exists,
43: \fIdist\fR will ask you as to the disposition of the draft.
44: A reply of \fBquit\fR will abort \fIdist\fR, leaving the draft intact;
45: \fBreplace\fR will replace the existing draft with a blank skeleton;
46: and \fBlist\fR will display the draft.
47:
48: Only those addresses in \*(lqResent\-To:\*(rq, \*(lqResent\-cc:\*(rq, and
49: \*(lqResent\-Bcc:\*(rq will be sent.
50: Also, a \*(lqResent\-Fcc:\ folder\*(rq will be honored (see \fIsend\fR\0(1)).
51: Note that with \fIdist\fR, the draft should contain only
52: \*(lqResent\-xxx:\*(rq fields and no body.
53: The headers and the body of the original message are copied to the draft when
54: the message is sent.
55: Use care in constructing the headers for the redistribution.
56:
57: If the `\-annotate' switch is given, the message being
58: distributed will be annotated with the lines:
59:
60: Resent:\ date
61: Resent:\ addrs
62:
63: where each address list contains as many lines as required.
64: This annotation
65: will be done only if the message is sent directly from \fIdist\fR.
66: If the message is not sent immediately from \fIdist\fR,
67: \*(lqcomp \-use\*(rq may be used to re\-edit and send the constructed message,
68: but the annotations won't take place.
69: The '\-inplace' switch causes annotation to
70: be done in place in order to preserve links to the annotated message.
71:
72: See \fIcomp\fR\0(1) for a description of the `\-editor' and `\-noedit'
73: switches.
74: Note that while in the editor,
75: the message being resent is available through a link named \*(lq@\*(rq
76: (assuming the default \fIwhatnowproc\fR\0).
77: In addition, the actual pathname of the message is stored in the envariable
78: \fB$editalt\fR,
79: and the pathname of the folder containing the message is stored in the
80: envariable \fB$mhfolder\fR.
81:
82: The `\-draftfolder\ +folder' and `\-draftmessage\ msg' switches invoke the
83: \fIMH\fR draft folder facility.
84: This is an advanced (and highly useful) feature.
85: Consult the \fBAdvanced Features\fR section of the \fIMH\fR manual for more
86: information.
87:
88: Upon exiting from the editor,
89: \fIdist\fR will invoke the \fIwhatnow\fR program.
90: See \fIwhatnow\fR\0(1) for a discussion of available options.
91: The invocation of this program can be inhibited by using the `\-nowhatnowproc'
92: switch.
93: (In truth of fact,
94: it is the \fIwhatnow\fR program which starts the initial edit.
95: Hence, `\-nowhatnowproc' will prevent any edit from occurring.)
96: .Fi
97: ^@(MHETCPATH)/distcomps~^The message skeleton
98: ^or <mh\-dir>/distcomps~^Rather than the standard skeleton
99: ^$HOME/\&.mh\(ruprofile~^The user profile
100: ^<mh\-dir>/draft~^The draft file
101: .Pr
102: ^Path:~^To determine the user's MH directory
103: .Ps
104: ^Current\-Folder:~^To find the default current folder
105: .Ps
106: ^Draft\-Folder:~^To find the default draft\-folder
107: .Ps
108: ^Editor:~^To override the default editor
109: .Ps
110: ^fileproc:~^Program to refile the message
111: .Ps
112: ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
113: .Sa
114: comp(1), forw(1), repl(1), send(1), whatnow(1)
115: .De
116: `+folder' defaults to the current folder
117: .Ds
118: `msg' defaults to cur
119: .Ds
120: `\-noannotate'
121: .Ds
122: `\-nodraftfolder'
123: .Ds
124: `\-noinplace'
125: .Co
126: If a folder is given, it will become the current folder.
127: The message distributed will become the current message.
128: .Hi
129: \fIDist\fR originally used headers of the form \*(lqDistribute\-xxx:\*(rq
130: instead of \*(lqResent\-xxx:\*(rq. In order to conform with the
131: ARPA Internet standard, RFC\-822,
132: the \*(lqResent\-xxx:\*(rq form is now used.
133: \fIDist\fR will recognize \*(lqDistribute\-xxx:\*(rq type headers and
134: automatically convert them to \*(lqResent\-xxx:\*(rq.
135: .Bu
136: \fIDist\fR does not \fIrigorously\fR check the message being
137: distributed for adherence to the transport standard,
138: but \fIpost\fR called by \fIsend\fR does.
139: The \fIpost\fR program will balk (and rightly so) at poorly formatted messages,
140: and \fIdist\fR won't correct things for you.
141:
142: If \fIwhatnowproc\fR is \fIwhatnow\fR,
143: then \fIdist\fR uses a built\-in \fIwhatnow\fR,
144: it does not actually run the \fIwhatnow\fR program.
145: Hence, if you define your own \fIwhatnowproc\fR,
146: don't call it \fIwhatnow\fR since \fIdist\fR won't run it.
147:
148: If your current working directory is not writable,
149: the link named \*(lq@\*(rq is not available.
150: .En
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.