Provided by: nmh_1.3-1_i386 bug

NAME

       comp - compose a message

SYNOPSIS

       comp [+folder] [msgs] [-form formfile] [-use | -nouse] [-file file]
            [-draftfolder +folder] [-draftmessage msg] [-nodraftfolder]
            [-editor editor] [-noedit] [-whatnowproc program] [-nowhatnowproc]
            [-version] [-help]

DESCRIPTION

       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 -noedit is given, in  which  case  the  initial  edit  is
       suppressed).

       The default message form contains the following elements:

            To:
            cc:
            Fcc: +outbox
            Subject:
            --------

       If  a  file  named  “components” exists in the user’s nmh directory, it
       will be used instead of this form.  You may specify an alternate  forms
       file with the switch -form formfile.

       You  may  also  start comp using the contents of an existing message as
       the form.  If you supply either a +folder or msg argument, that message
       will  be  used  as  the  message form.  You may not supply both a -form
       formfile and a +folder or msg argument.  The line of 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 send(1)).

       The switch -use directs comp to continue  editing  an  already  started
       message.   That  is,  if  a comp (or dist, repl, or forw) is terminated
       without sending the draft, the draft can  be  edited  again  via  “comp
       -use”.

       The  -file file switch says to use the named file as the message draft.

       If the draft already exists, comp will ask you as to the disposition of
       the  draft.  A reply of quit will abort comp, leaving the draft intact;
       replace will replace the existing draft with the appropriate form; list
       will display the draft; use will use the draft for further composition;
       and refile +folder will file the draft in the given  folder,  and  give
       you  a  new  draft with the appropriate form.  (The +folder argument to
       refile is required.)

       The -draftfolder +folder and -draftmessage msg switches invoke the  nmh
       draft  folder  facility.   This  is  an  advanced  (and  highly useful)
       feature.  Consult the mh-draft(5) man page for more information.

       The -editor editor switch indicates the editor to use for  the  initial
       edit.   Upon  exiting  from  the  editor,  comp will invoke the whatnow
       program.  See whatnow(1) for a discussion of  available  options.   The
       invocation of this program can be inhibited by using the -nowhatnowproc
       switch.  (In truth of fact, it is the whatnow program which starts  the
       initial  edit.   Hence,  -nowhatnowproc  will  prevent  any  edit  from
       occurring.)

FILES

       /etc/nmh/components        The standard message skeleton
       or <mh-dir>/components     Rather than the standard skeleton
       $HOME/.mh_profile          The user profile
       <mh-dir>/draft             The draft file

PROFILE COMPONENTS

       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 “What now?” questions

SEE ALSO

       dist(1), forw(1), repl(1), send(1), whatnow(1), mh-profile(5)

DEFAULTS

+folder’ defaults to the current folder
       ‘msg’ defaults to the current message
       ‘-nodraftfolder’
       ‘-nouse

CONTEXT

       None

BUGS

       If whatnowproc is whatnow, then comp uses a built-in whatnow,  it  does
       not  actually  run  the whatnow program.  Hence, if you define your own
       whatnowproc, don’t call it whatnow since comp won’t run it.