+.TH COMP %manext1% "May 21, 2012" "%nmhversion%"
.\"
.\" %nmhwarning%
.\"
-.TH COMP %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
comp \- compose a message
.SH SYNOPSIS
.na
.B comp
.RI [ +folder ]
-.RI [ msgs ]
+.RI [ msg ]
.RB [ \-form
.IR formfile ]
.RB [ \-use " | " \-nouse ]
.IR address ]
.RB [ \-fcc
.IR +folder ]
+.RB [ \-subject
+.IR text ]
.RB [ \-whatnowproc
.IR program ]
.RB [ \-nowhatnowproc ]
+.RB [ \-build ]
.RB [ \-version ]
.RB [ \-help ]
.ad
.PP
The default message template \*(lqcomponents\*(rq will direct
.B comp
-to construct the messgage draft as follows:
+to construct the message draft as follows:
.PP
.RS 5
.nf
To: {to switch} or blank
cc: {cc switch} or blank
Fcc: {fcc switch} or +outbox
-Subject:
+Subject: {subject switch} or blank
--------
.fi
.RE
dashes or a blank line must be left between the header and the body of
the message for the message to be identified properly when it is sent
(see
-.BR send (1)).
+.IR send (1)).
.PP
The switch
.B \-use
.PP
Forms that are selected via the
.B \-form
-switch are processed via the mh template system; see
-.BR mh\-format (5)
-for details. Drafts constructed from another mssage or with the
+switch are processed via the
+.B nmh
+template system; see
+.IR mh\-format (5)
+for details. Drafts constructed from another message or with the
.B \-use
or
.B \-file
switchs will NOT be processed with
-.BR mh\-format (5).
+.IR mh\-format (5).
.PP
In addition to the standard
-.BR mh\-format (5)
+.IR mh\-format (5)
escapes,
-.B comp
the following
.I component
escapes are either new or have an alternate meaning:
.RS 5
.nf
.ta \w'Escape 'u +\w'Returns 'u
-.I Escape Returns Description
+.I "Escape Returns Description"
fcc string Any folders specified with `\-fcc\ folder'
from string Any addresses specified with `\-from\ address'
to string Any addresses specified with `\-to\ address'
cc string Any addresses specified with `\-cc\ address'
+subject string Any text specified with `\-subject\ text'
.fi
.RE
.PP
overridden by using the
.B \-from
.I address
+switch. The default mailbox in the \*(lqFcc:\*(rq field is
+.IR +outbox .
+This can be overridden by the
+.B \-fcc
switch.
.PP
+Any text you give to the
+.B \-subject
+switch will be placed in the \*(lqSubject:\*(rq field in the draft.
+.PP
If the draft already exists,
.B comp
will ask you as to the disposition
.B nmh
draft folder facility. This is an advanced (and highly
useful) feature. Consult the
-.BR mh-draft (5)
+.IR mh-draft (5)
man page for more information.
.PP
The
will invoke the
.B whatnow
program. See
-.BR whatnow (1)
+.IR whatnow (1)
for a discussion of
available options. The invocation of this program can be inhibited
by using the
program which starts the initial edit. Hence,
.B \-nowhatnowproc
will prevent any edit from occurring.)
-
+.PP
+The
+.B \-build
+switch is intended to be used by the Emacs mh-e interface to
+.BR nmh .
+It implies
+.BR \-nowhatnowproc .
+It causes a file <mh\-dir>/draft to be created, containing the draft message that
+would normally be presented to the user for editing.
+No mail is actually sent.
.SH FILES
-.fc ^ ~
-.nf
-.ta \w'%etcdir%/ExtraBigFileName 'u
-^%etcdir%/components~^The standard message skeleton
-^or <mh\-dir>/components~^Rather than the standard skeleton
-^$HOME/\&.mh\(ruprofile~^The user profile
-^<mh\-dir>/draft~^The draft file
-.fi
-
+.PD 0
+.TP 20
+%nmhetcdir%/components
+The standard message skeleton.
+.TP
+<mh\-dir>/components
+An alternative to the standard skeleton.
+.TP
+$HOME/.mh_profile
+The user's profile.
+.PD
.SH "PROFILE COMPONENTS"
-.fc ^ ~
-.nf
-.ta 2.4i
-.ta \w'ExtraBigProfileName 'u
-^Path:~^To determine the user's nmh directory
-^Draft\-Folder:~^To find the default draft\-folder
-^Editor:~^To override the default editor
-^Msg\-Protect:~^To set mode when creating a new message (draft)
-^fileproc:~^Program to refile the message
-^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
-.fi
-
+.PD 0
+.TP 20
+Path:
+To determine the user's nmh directory.
+.TP
+Draft\-Folder:
+To find the default draft\-folder.
+.TP
+Editor:
+To override the default editor.
+.TP
+Msg\-Protect:
+To set mode when creating a new message (draft).
+.TP
+fileproc:
+Program to refile the message.
+.TP
+whatnowproc:
+Program to ask the \*(lqWhat now?\*(rq questions
+.PD
.SH "SEE ALSO"
-dist(1), forw(1), repl(1), send(1), whatnow(1), mh-profile(5)
-
+.IR dist (1),
+.IR forw (1),
+.IR repl (1),
+.IR send (1),
+.IR whatnow (1),
+.IR mh-profile (5)
.SH DEFAULTS
-.nf
-.RB ` +folder "' defaults to the current folder"
-.RB ` msg "' defaults to the current message"
-.RB ` \-nodraftfolder '
-.RB ` \-nouse '
-.fi
-
+.PD 0
+.TP 20
++folder
+The current folder.
+.TP
+msg
+The current message.
+.TP
+\-nodraftfolder
+.TP
+\-nouse
+.PD
.SH CONTEXT
None
-
.SH BUGS
If
.I whatnowproc
projects / nmh / blobdiff