1 .TH COMP %manext1% "May 21, 2012" "%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 message 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
124 for details. Drafts constructed from another message or with the
128 switchs will NOT be processed with
131 In addition to the standard
136 escapes are either new or have an alternate meaning:
140 .ta \w'Escape 'u +\w'Returns 'u
141 .I "Escape Returns Description"
142 fcc string Any folders specified with `\-fcc\ folder'
143 from string Any addresses specified with `\-from\ address'
144 to string Any addresses specified with `\-to\ address'
145 cc string Any addresses specified with `\-cc\ address'
146 subject string Any text specified with `\-subject\ text'
150 By default the \*(lqTo:\*(rq and \*(lqcc:\*(rq fields are empty. You may
151 add addresses to these fields with the
157 switches. You may give these switches multiple times to add multiple
160 By default the \*(lqFrom:\*(rq field has either the value of the
162 profile entry or a system default email address. This default can be
163 overridden by using the
166 switch. The default mailbox in the \*(lqFcc:\*(rq field is
168 This can be overridden by the
172 Any text you give to the
174 switch will be placed in the \*(lqSubject:\*(rq field in the draft.
176 If the draft already exists,
178 will ask you as to the disposition
179 of the draft. A reply of
183 leaving the draft intact;
185 will replace the existing draft with
186 the appropriate form;
188 will display the draft;
190 will use the draft for further composition; and
193 will file the draft in the given folder, and give you a new draft with the
194 appropriate form. (The
208 draft folder facility. This is an advanced (and highly
209 useful) feature. Consult the
211 man page for more information.
216 switch indicates the editor to use for the
217 initial edit. Upon exiting from the editor,
224 available options. The invocation of this program can be inhibited
227 switch. (In truth of fact, it is
230 program which starts the initial edit. Hence,
232 will prevent any edit from occurring.)
236 .ta \w'%etcdir%/ExtraBigFileName 'u
237 ^%etcdir%/components~^The standard message skeleton
238 ^or <mh\-dir>/components~^Rather than the standard skeleton
239 ^$HOME/\&.mh\(ruprofile~^The user profile
240 ^<mh\-dir>/draft~^The draft file
242 .SH "PROFILE COMPONENTS"
246 .ta \w'ExtraBigProfileName 'u
247 ^Path:~^To determine the user's nmh directory
248 ^Draft\-Folder:~^To find the default draft\-folder
249 ^Editor:~^To override the default editor
250 ^Msg\-Protect:~^To set mode when creating a new message (draft)
251 ^fileproc:~^Program to refile the message
252 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
263 .RB ` +folder "' defaults to the current folder"
264 .RB ` msg "' defaults to the current message"
265 .RB ` \-nodraftfolder '
279 it does not actually run the
282 Hence, if you define your own