4 .TH COMP %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
6 comp \- compose a message
15 .RB [ \-use " | " \-nouse ]
22 .RB [ \-nodraftfolder ]
40 .RB [ \-nowhatnowproc ]
46 is used to create a new message to be mailed. It copies a
47 message form to the draft being composed and then invokes an editor on
50 is given, in which case the initial edit is suppressed).
52 The default message template \*(lqcomponents\*(rq will direct
54 to construct the messgage draft as follows:
58 From: {from switch} or <Local-Mailbox> or <username@hostname>
59 To: {to switch} or blank
60 cc: {cc switch} or blank
61 Fcc: {fcc switch} or +outbox
62 Subject: {subject switch} or blank
68 .RI \*(lq components \*(rq
69 exists in the user's nmh directory,
70 it will be used instead of this form. You may specify an alternate
71 forms file with the switch
77 using the contents of an existing message
78 as the form. If you supply either a
83 message will be used as the message form. You may not supply both a
91 dashes or a blank line must be left between the header and the body of
92 the message for the message to be identified properly when it is sent
100 to continue editing an already
101 started message. That is, if a
108 is terminated without sending the draft, the draft can
116 switch says to use the named file as the message draft.
118 Forms that are selected via the
120 switch are processed via the mh template system; see
122 for details. Drafts constructed from another mssage or with the
126 switchs will NOT be processed with
129 In addition to the standard
135 escapes are either new or have an alternate meaning:
139 .ta \w'Escape 'u +\w'Returns 'u
140 .I Escape Returns Description
141 fcc string Any folders specified with `\-fcc\ folder'
142 from string Any addresses specified with `\-from\ address'
143 to string Any addresses specified with `\-to\ address'
144 cc string Any addresses specified with `\-cc\ address'
145 subject string Any text specified with `\-subject\ text'
149 By default the \*(lqTo:\*(rq and \*(lqcc:\*(rq fields are empty. You may
150 add addresses to these fields with the
156 switches. You may give these switches multiple times to add multiple
159 By default the \*(lqFrom:\*(rq field has either the value of the
161 profile entry or a system default email address. This default can be
162 overridden by using the
167 Any text you give to the
169 switch will be placed in the \*(lqSubject:\*(rq field in the draft.
171 If the draft already exists,
173 will ask you as to the disposition
174 of the draft. A reply of
178 leaving the draft intact;
180 will replace the existing draft with
181 the appropriate form;
183 will display the draft;
185 will use the draft for further composition; and
188 will file the draft in the given folder, and give you a new draft with the
189 appropriate form. (The
203 draft folder facility. This is an advanced (and highly
204 useful) feature. Consult the
206 man page for more information.
211 switch indicates the editor to use for the
212 initial edit. Upon exiting from the editor,
219 available options. The invocation of this program can be inhibited
222 switch. (In truth of fact, it is
225 program which starts the initial edit. Hence,
227 will prevent any edit from occurring.)
232 .ta \w'%etcdir%/ExtraBigFileName 'u
233 ^%etcdir%/components~^The standard message skeleton
234 ^or <mh\-dir>/components~^Rather than the standard skeleton
235 ^$HOME/\&.mh\(ruprofile~^The user profile
236 ^<mh\-dir>/draft~^The draft file
239 .SH "PROFILE COMPONENTS"
243 .ta \w'ExtraBigProfileName 'u
244 ^Path:~^To determine the user's nmh directory
245 ^Draft\-Folder:~^To find the default draft\-folder
246 ^Editor:~^To override the default editor
247 ^Msg\-Protect:~^To set mode when creating a new message (draft)
248 ^fileproc:~^Program to refile the message
249 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
253 dist(1), forw(1), repl(1), send(1), whatnow(1), mh-profile(5)
257 .RB ` +folder "' defaults to the current folder"
258 .RB ` msg "' defaults to the current message"
259 .RB ` \-nodraftfolder '
275 it does not actually run the
278 Hence, if you define your own