context_foil.c: Move interface to own file.

[nmh] / man / comp.man

diff --git a/man/comp.man b/man/comp.man
index 387ec129e409ff2fbb10f03f81a427065a930a6e..0e9348ac05b3e78faf1dac9d8e2e528cf9d1a005 100644 (file)
--- a/man/comp.man
+++ b/man/comp.man
@@ -1,13 +1,15 @@
-.TH COMP %manext1% "May 21, 2012" "%nmhversion%"
-.\"
+.TH COMP %manext1% 2013-10-18 "%nmhversion%"
+.
 .\" %nmhwarning%
-.\"
+.
 .SH NAME
-comp \- compose a message
+comp \- compose an nmh message
 .SH SYNOPSIS
 .HP 5
 .na
-.B comp 
+.B comp
+.RB [ \-help ]
+.RB [ \-version ]
 .RI [ +folder ]
 .RI [ msg ]
 .RB [ \-form
@@ -38,11 +40,10 @@ comp \- compose a message
 .RB [ \-whatnowproc
 .IR program ]
 .RB [ \-nowhatnowproc ]
-.RB [ \-version ]
-.RB [ \-help ]
+.RB [ \-build ]
 .ad
 .SH DESCRIPTION
-.B Comp
+.B comp
 is used to create a new message to be mailed.  It copies a
 message form to the draft being composed and then invokes an editor on
 the draft (unless
@@ -119,13 +120,15 @@ Forms that are selected via the
 .B \-form
 switch are processed via the
 .B nmh
-template system; see 
+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
+switches will
+.I not
+be processed with
 .IR mh\-format (5).
 .PP
 In addition to the standard
@@ -206,9 +209,9 @@ and
 switches invoke the
 .B nmh
 draft folder facility.  This is an advanced (and highly
-useful) feature.  Consult the
+useful) feature.  Consult
 .IR mh-draft (5)
-man page for more information.
+for more information.
 .PP
 The
 .B \-editor
@@ -218,28 +221,37 @@ initial edit.  Upon exiting from the editor,
 .B comp
 will invoke the
 .B whatnow
-program.  See
+program (see
 .IR whatnow (1)
 for a discussion of
-available options.  The invocation of this program can be inhibited
+available options).  The invocation of this program can be inhibited
 by using the
 .B \-nowhatnowproc
-switch.  (In truth of fact, it is
-the
+switch.  (In fact, it is the
 .I whatnow
 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
 .PD 0
 .TP 20
-%etcdir%/components
-The standard message skeleton.
+%nmhetcdir%/components
+The default message skeleton.
 .TP
-<mh\-dir>/components
-An alternative to the standard skeleton.
+<mh-dir>/components
+The user's message skeleton.
 .TP
-$HOME/.mh\-profile
+$HOME/.mh_profile
 The user's profile.
 .PD
 .SH "PROFILE COMPONENTS"
@@ -249,7 +261,7 @@ Path:
 To determine the user's nmh directory.
 .TP
 Draft\-Folder:
-To find the default draft\-folder.
+To find the default draft-folder.
 .TP
 Editor:
 To override the default editor.
@@ -292,7 +304,7 @@ is
 .BR whatnow ,
 then
 .B comp
-uses a built\-in
+uses a built-in
 .BR whatnow ,
 it does not actually run the
 .B whatnow