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 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 If
  87 .B \-use
  88 is given,
  89 .I msg
  90 is located within the draft folder.
  91 A
  92 .I +folder
  93 argument is not allowed together with
  94 .BR \-use .
  95 .PP
  96 If the draft already exists,
  97 .B comp
  98 will ask you as to the disposition
  99 of the draft.  A reply of
 100 .B quit
 101 will abort
 102 .BR comp ,
 103 leaving the draft intact;
 104 .B replace
 105 will replace the existing draft with
 106 the appropriate form;
 107 .B list
 108 will display the draft;
 109 .B use
 110 will use the draft for further composition; and
 111 .B refile
 112 .I +folder
 113 will file the draft in the given folder, and give you a new draft with the
 114 appropriate form.  (The
 115 .I +folder
 116 argument to
 117 .B refile
 118 is required.)
 119 .PP
 120 Consult the
 121 .BR mh-draft (7)
 122 man page for more information.
 123 .PP
 124 The
 125 .B \-editor
 126 .I editor
 127 switch indicates the editor to use for the
 128 initial edit.  Upon exiting from the editor,
 129 .B comp
 130 will invoke the
 131 .B whatnow
 132 program.  See
 133 .BR whatnow (1)
 134 for a discussion of
 135 available options.  The invocation of this program can be inhibited
 136 by using the
 137 .B \-nowhatnowproc
 138 switch.  (In truth of fact, it is
 139 the
 140 .I whatnow
 141 program which starts the initial edit.  Hence,
 142 .B \-nowhatnowproc
 143 will prevent any edit from occurring.)
 144
 145 .SH FILES
 146 .fc ^ ~
 147 .nf
 148 .ta \w'%etcdir%/ExtraBigFileName  'u
 149 ^%etcdir%/components~^The standard message skeleton
 150 ^or $HOME/.mmh/components~^Rather than the standard skeleton
 151 ^$HOME/.mmh/profile~^The user profile
 152 ^+drafts~^The draft folder
 153 .fi
 154
 155 .SH "PROFILE COMPONENTS"
 156 .fc ^ ~
 157 .nf
 158 .ta 2.4i
 159 .ta \w'ExtraBigProfileName  'u
 160 ^Path:~^To determine the user's mail storage
 161 ^Draft\-Folder:~^To set the default draft folder
 162 ^Editor:~^To override the default editor
 163 ^Msg\-Protect:~^To set mode when creating a new message (draft)
 164 ^fileproc:~^Program to refile the message
 165 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
 166 .fi
 167
 168 .SH "SEE ALSO"
 169 dist(1), forw(1), repl(1), send(1), whatnow(1), mh-profile(5)
 170
 171 .SH DEFAULTS
 172 .nf
 173 .RB ` +folder "' defaults to the current folder"
 174 .RB ` msg "' defaults to the current message"
 175 .RB ` \-nouse '
 176 .fi
 177
 178 .SH CONTEXT
 179 None
 180
 181 .SH BUGS
 182 None