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