git.marmaro.de Git - mmh/blob - man/comp.man1

   1 .\"
   2 .\" %nmhwarning%
   3 .\"
   4 .TH COMP %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
   5 .SH NAME
   6 comp \- compose a message
   7 .SH SYNOPSIS
   8 .HP 5
   9 .na
  10 .B comp
  11 .RI [ +folder ]
  12 .RI [ msgs ]
  13 .RB [ \-form
  14 .IR formfile ]
  15 .RB [ \-use " | " \-nouse ]
  16 .RB [ \-editor
  17 .IR editor ]
  18 .RB [ \-noedit ]
  19 .RB [ \-whatnowproc
  20 .IR program ]
  21 .RB [ \-nowhatnowproc ]
  22 .RB [ \-version ]
  23 .RB [ \-help ]
  24 .ad
  25 .SH DESCRIPTION
  26 .B Comp
  27 is used to create a new message to be mailed.  It copies a
  28 message form to the draft being composed and then invokes an editor on
  29 the draft (unless
  30 .B \-noedit
  31 is given, in which case the initial edit is suppressed).
  32 .PP
  33 The default message form contains the following elements:
  34 .PP
  35 .RS 5
  36 .nf
  37 %components%
  38 .fi
  39 .RE
  40 .PP
  41 If a file named
  42 .RI \*(lq components \*(rq
  43 exists in the user's mmh directory,
  44 it will be used instead of this form.  You may specify an alternate
  45 forms file with the switch
  46 .B \-form
  47 .IR formfile .
  48 .PP
  49 You may also start
  50 .B comp
  51 using the contents of an existing message
  52 as the form.  If you supply either a
  53 .I +folder
  54 or
  55 .I msg
  56 argument, that
  57 message will be used as the message form.  You may not supply both a
  58 .B \-form
  59 .I formfile
  60 and a
  61 .I +folder
  62 or
  63 .I msg
  64 argument.  The line of
  65 dashes or a blank line must be left between the header and the body of
  66 the message for the message to be identified properly when it is sent
  67 (see
  68 .BR send (1)).
  69 .PP
  70 The switch
  71 .B \-use
  72 directs
  73 .B comp
  74 to continue editing an already
  75 started message.  That is, if a
  76 .B comp
  77 (or
  78 .BR dist ,
  79 .BR repl ,
  80 or
  81 .BR forw )
  82 is terminated without sending the draft, the draft can
  83 be edited again via
  84 .RB \*(lq comp
  85 .BR \-use \*(rq.
  86 .PP
  87 If the draft already exists,
  88 .B comp
  89 will ask you as to the disposition
  90 of the draft.  A reply of
  91 .B quit
  92 will abort
  93 .BR comp ,
  94 leaving the draft intact;
  95 .B replace
  96 will replace the existing draft with
  97 the appropriate form;
  98 .B list
  99 will display the draft;
 100 .B use
 101 will use the draft for further composition; and
 102 .B refile
 103 .I +folder
 104 will file the draft in the given folder, and give you a new draft with the
 105 appropriate form.  (The
 106 .I +folder
 107 argument to
 108 .B refile
 109 is required.)
 110 .PP
 111 Consult the
 112 .BR mh-draft (7)
 113 man page for more information.
 114 .PP
 115 The
 116 .B \-editor
 117 .I editor
 118 switch indicates the editor to use for the
 119 initial edit.  Upon exiting from the editor,
 120 .B comp
 121 will invoke the
 122 .B whatnow
 123 program.  See
 124 .BR whatnow (1)
 125 for a discussion of
 126 available options.  The invocation of this program can be inhibited
 127 by using the
 128 .B \-nowhatnowproc
 129 switch.  (In truth of fact, it is
 130 the
 131 .I whatnow
 132 program which starts the initial edit.  Hence,
 133 .B \-nowhatnowproc
 134 will prevent any edit from occurring.)
 135
 136 .SH FILES
 137 .fc ^ ~
 138 .nf
 139 .ta \w'%etcdir%/ExtraBigFileName  'u
 140 ^%etcdir%/components~^The standard message skeleton
 141 ^or $HOME/.mmh/components~^Rather than the standard skeleton
 142 ^$HOME/.mmh/profile~^The user profile
 143 ^+drafts~^The draft folder
 144 .fi
 145
 146 .SH "PROFILE COMPONENTS"
 147 .fc ^ ~
 148 .nf
 149 .ta 2.4i
 150 .ta \w'ExtraBigProfileName  'u
 151 ^Path:~^To determine the user's mail storage
 152 ^Draft\-Folder:~^To set the default draft folder
 153 ^Editor:~^To override the default editor
 154 ^Msg\-Protect:~^To set mode when creating a new message (draft)
 155 ^fileproc:~^Program to refile the message
 156 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
 157 .fi
 158
 159 .SH "SEE ALSO"
 160 dist(1), forw(1), repl(1), send(1), whatnow(1), mh-profile(5)
 161
 162 .SH DEFAULTS
 163 .nf
 164 .RB ` +folder "' defaults to the current folder"
 165 .RB ` msg "' defaults to the current message"
 166 .RB ` \-nouse '
 167 .fi
 168
 169 .SH CONTEXT
 170 None
 171
 172 .SH BUGS
 173 None