8 date 90.12.17.16.29.30; author mh; state Exp;
13 date 90.04.05.15.12.17; author sources; state Exp;
18 date 90.03.22.11.31.01; author sources; state Exp;
23 date 90.03.20.19.41.37; author sources; state Exp;
28 date 90.03.20.17.35.56; author sources; state Exp;
33 date 90.03.20.17.20.44; author sources; state Exp;
44 @document "-editor" better
49 .\" @@(#)$Id: comp.rf,v 1.5 90/04/05 15:12:17 sources Exp Locker: mh $
52 comp \- compose a message
56 \%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
57 \%[\-editor\ editor] \%[\-noedit]
61 \%[\-whatnowproc\ program] \%[\-nowhatnowproc]
64 \fIComp\fR is used to create a new message to be mailed.
65 It copies a message form to
66 the draft being composed and then invokes an editor on the draft
67 (unless `\-noedit' is given, in which case the initial edit is suppressed).
69 The default message form contains the following elements:
75 .so @@(MHETCPATH)/components
80 If the file named \*(lqcomponents\*(rq exists in the user's MH directory,
81 it will be used instead of this form.
82 The file specified by `\-form\ formfile' will be used if given.
83 You may also start \fIcomp\fR using the contents of an existing
85 If you supply either a `+folder' or `msg' argument, that message will be used
86 as the form. You may not supply both a `\-form\ formfile' and a `+folder' or
89 or a blank line must be left between the header and the
90 body of the message for the message to be identified properly when it is
91 sent (see \fIsend\fR\0(1)).
92 The switch `\-use' directs \fIcomp\fR to
93 continue editing an already started message.
95 \fIcomp\fR (or \fIdist\fR, \fIrepl\fR, or \fIforw\fR\0) is terminated without
96 sending the draft, the draft can be edited again via
97 \*(lqcomp\ \-use\*(rq.
99 If the draft already exists, \fIcomp\fR will ask
100 you as to the disposition of the draft.
101 A reply of \fBquit\fR will abort \fIcomp\fR, leaving the draft intact;
102 \fBreplace\fR will replace the existing draft with the appropriate form;
103 \fBlist\fR will display the draft;
104 \fBuse\fR will use the draft for further composition;
105 and \fBrefile\ +folder\fR will
106 file the draft in the given folder, and give you a new draft with the
108 (The `+folder' argument to \fBrefile\fR is required.)
110 The `\-draftfolder\ +folder' and `\-draftmessage\ msg' switches invoke the
111 \fIMH\fR draft folder facility.
112 This is an advanced (and highly useful) feature.
113 Consult the \fBAdvanced Features\fR section of the \fIMH\fR manual for more
116 The `\-file\ file' switch says to use the named file as the message draft.
118 The `\-editor\ editor' switch indicates the editor to
119 use for the initial edit.
120 Upon exiting from the editor,
121 \fIcomp\fR will invoke the \fIwhatnow\fR program.
122 See \fIwhatnow\fR\0(1) for a discussion of available options.
123 The invocation of this program can be inhibited by using the `\-nowhatnowproc'
126 it is the \fIwhatnow\fR program which starts the initial edit.
127 Hence, `\-nowhatnowproc' will prevent any edit from occurring.)
129 ^@@(MHETCPATH)/components~^The message skeleton
130 ^or <mh\-dir>/components~^Rather than the standard skeleton
131 ^$HOME/\&.mh\(ruprofile~^The user profile
132 ^<mh\-dir>/draft~^The draft file
134 ^Path:~^To determine the user's MH directory
136 ^Draft\-Folder:~^To find the default draft\-folder
138 ^Editor:~^To override the default editor
140 ^Msg\-Protect:~^To set mode when creating a new message (draft)
142 ^fileproc:~^Program to refile the message
144 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
146 dist(1), forw(1), repl(1), send(1), whatnow(1), mh-profile(5)
148 `+folder' defaults to the current folder
150 `msg' defaults to the current message
158 If \fIwhatnowproc\fR is \fIwhatnow\fR,
159 then \fIcomp\fR uses a built\-in \fIwhatnow\fR,
160 it does not actually run the \fIwhatnow\fR program.
161 Hence, if you define your own \fIwhatnowproc\fR,
162 don't call it \fIwhatnow\fR since \fIcomp\fR won't run it.
178 dist(1), forw(1), repl(1), send(1), whatnow(1)
184 @put things back, do .NA stuff another way
198 .TH COMP 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
208 @fixup for makewhatis