![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to forw.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 forw.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 FORW 1
3: .NA
4: forw \- forward messages
5: .SY
6: forw
7: \%[+folder] \%[msgs]
8: \%[\-annotate] \%[\-noannotate]
9: \%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
10: \%[\-editor\ editor] \%[\-noedit]
11: \%[\-filter\ filterfile]
12: \%[\-form\ formfile]
13: \%[\-format] \%[\-noformat]
14: \%[\-inplace] \%[\-noinplace]
15: \%[\-whatnowproc\ program] \%[\-nowhatnowproc]
16: \%[\-help]
17:
18: .ti .5i
19: forw
20: \%[+folder] \%[msgs]
21: \%[\-digest\ list] \%[\-issue\ number] \%[\-volume\ number]
22: \%[other\ switches\ for\ \fIforw\fR]
23: \%[\-help]
24: .DE
25: \fIForw\fR may be used to prepare a message containing other
26: messages.
27: It constructs the new message from the components file
28: or `\-form\ formfile' (see \fIcomp\fR\0), with a body composed of the
29: message(s) to be forwarded.
30: An editor is invoked as in \fIcomp\fR,
31: and after editing is complete, the user is prompted before the message
32: is sent.
33:
34: The default message form contains the following elements:
35:
36: .nf
37: .in +.5i
38: .ne 10
39: .\".eo
40: .so /usr/new/lib/mh/forwcomps
41: .\".ec
42: .in -.5i
43: .fi
44:
45: If the file named \*(lqforwcomps\*(rq exists in the user's MH directory,
46: it will be used instead of this form.
47: In either case, the file specified by `\-form\ formfile' will be
48: used if given.
49:
50: If the draft already exists,
51: \fIforw\fR will ask you as to the disposition of the draft.
52: A reply of \fBquit\fR will abort \fIforw\fR, leaving the draft intact;
53: \fBreplace\fR will replace the existing draft with a blank skeleton;
54: and \fBlist\fR will display the draft.
55:
56: If the `\-annotate' switch is given, each message being
57: forwarded will be annotated with the lines
58:
59: Forwarded:\ date
60: Forwarded:\ addrs
61:
62: where each address list contains as many lines as required.
63: This annotation
64: will be done only if the message is sent directly from \fIforw\fR.
65: If the message is not sent immediately from \fIforw\fR,
66: \*(lqcomp\ \-use\*(rq may be used to re\-edit and send the constructed message,
67: but
68: 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:
75: Although \fIforw\fR uses the `\-form\ formfile' switch to direct it how to
76: construct the beginning of the draft, the `\-filter\ filterfile',
77: `\-format', and `\-noformat'
78: switches direct \fIforw\fR as to how each forwarded message should be
79: formatted in the body of the draft.
80: If `\-noformat' is specified,
81: then each forwarded message is output exactly as it appears.
82: If `\-format' or `\-filter\ filterfile' is specified,
83: then each forwarded message is filtered (re\-formatted) prior to being
84: output to the body of the draft.
85: The filter file for \fIforw\fR should be a standard form file for
86: \fImhl\fR,
87: as \fIforw\fR will invoke \fImhl\fR to format the forwarded messages.
88: The default message filter (what you get with `\-format') is:
89:
90: .nf
91: .in +.5i
92: .ne 10
93: .\".eo
94: .\".so /usr/new/lib/mh/mhl.forward
95: width=80,overflowtext=,overflowoffset=10
96: leftadjust,compress,compwidth=9
97: From:
98: Date:formatfield="%<(nodate{text})%{text}%|%(putstr(tws{text}))%>"
99: To:
100: cc:
101: Subject:
102: .fl
103: :
104: body:nocomponent,overflowoffset=0,noleftadjust,nocompress
105: .\".ec
106: .in -.5i
107: .fi
108:
109: If the file named \*(lqmhl.forward\*(rq exists in the user's MH directory,
110: it will be used instead of this form.
111: In either case, the file specified by `\-filter\ filterfile' will be
112: used if given.
113: To summarize:
114: `\-noformat' will reproduce each forwarded message exactly,
115: `\-format' will use \fImhl\fR and a default filterfile, \*(lqmhl.forward\*(rq,
116: to format each forwarded message, and
117: `\-filter\ filterfile' will use the named filterfile to format each
118: forwarded message with \fImhl\fR.
119:
120: Each forwarded message is separated with an encapsulation delimiter so that
121: when received, the message is suitable for bursting by \fIburst\fR\0(1).
122:
123: For users of \fIprompter\fR\0(1), by specifying prompter's `-prepend'
124: switch in the \&.mh\(ruprofile file, any commentary text is entered before
125: the forwarded messages. (A major win!)
126:
127: The `\-draftfolder\ +folder' and `\-draftmessage\ msg' switches invoke the
128: \fIMH\fR draft folder facility.
129: This is an advanced (and highly useful) feature.
130: Consult the \fBAdvanced Features\fR section of the \fIMH\fR manual for more
131: information.
132:
133: Upon exiting from the editor,
134: \fIforw\fR will invoke the \fIwhatnow\fR program.
135: See \fIwhatnow\fR\0(1) for a discussion of available options.
136: The invocation of this program can be inhibited by using the `\-nowhatnowproc'
137: switch.
138: (In truth of fact,
139: it is the \fIwhatnow\fR program which starts the initial edit.
140: Hence, `\-nowhatnowproc' will prevent any edit from occurring.)
141:
142: The `\-digest\ list', `\-issue\ number', and `\-volume\ number' switches
143: implement a digest facility for \fIMH\fR.
144: See the \fIMH\fR user's manual for more information.
145: .Fi
146: ^/usr/new/lib/mh/forwcomps~^The message skeleton
147: ^or <mh\-dir>/forwcomps~^Rather than the standard skeleton
148: ^/usr/new/lib/mh/digestcomps~^The message skeleton if `\-digest' is given
149: ^or <mh\-dir>/digestcomps~^Rather than the standard skeleton
150: ^/usr/new/lib/mh/mhl.forward~^The message filter
151: ^or <mh\-dir>/mhl.forward~^Rather than the standard filter
152: ^$HOME/\&.mh\(ruprofile~^The user profile
153: ^<mh\-dir>/draft~^The draft file
154: .Pr
155: ^Path:~^To determine the user's MH directory
156: .Ps
157: ^Current\-Folder:~^To find the default current folder
158: .Ps
159: ^Draft\-Folder:~^To find the default draft\-folder
160: .Ps
161: ^Editor:~^To override the default editor
162: .Ps
163: ^Msg\-Protect:~^To set mode when creating a new message (draft)
164: .Ps
165: ^fileproc:~^Program to refile the message
166: .Ps
167: ^mhlproc:~^Program to filter messages being forwarded
168: .Ps
169: ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
170: .Sa
171: \fIProposed Standard for Message Encapsulation\fR (aka RFC\-934),
172: .br
173: comp(1), dist(1), repl(1), send(1), whatnow(1)
174: .De
175: `+folder' defaults to the current folder
176: `msgs' defaults to cur
177: .Ds
178: `\-noannotate'
179: .Ds
180: `\-nodraftfolder'
181: .Ds
182: `\-noformat'
183: .Ds
184: `\-noinplace'
185: .Co
186: If a folder is given, it will become the current folder.
187: The first message forwarded will become the current message.
188: .Bu
189: If \fIwhatnowproc\fR is \fIwhatnow\fR,
190: then \fIforw\fR uses a built\-in \fIwhatnow\fR,
191: it does not actually run the \fIwhatnow\fR program.
192: Hence, if you define your own \fIwhatnowproc\fR,
193: don't call it \fIwhatnow\fR since \fIforw\fR won't run it.
194:
195: When \fIforw\fR is told to annotate the messages it forwards,
196: it doesn't actually annotate them until the draft is successfully sent.
197: If from the \fIwhatnowproc\fR,
198: you \fIpush\fR instead of \fIsend\fR,
199: it's possible to confuse \fIforw\fR by re\-ordering the file
200: (e.g., by using `folder\0\-pack') before the message is successfully sent.
201: \fIDist\fR and \fIrepl\fR don't have this problem.
202: .En
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.