diplodocus.org Git - nmh/blob - docs/historical/mh-jun-1982/man/comp.1

   1 .TH COMP 1 RAND
   2 .SH NAME
   3 comp \- compose a message
   4
   5 .SH SYNOPSIS
   6 .B comp
   7 \%[
   8 .B \-editor\ \fReditor] \%[
   9 .B \-form\ \fRformfile] \%[file] \%[
  10 .B \-use
  11 ] \%[
  12 .B \-nouse
  13 ] \%[
  14 .B \-help
  15 ]
  16
  17 .SH DESCRIPTION
  18 \fIComp\fP is used to create a new message to be mailed.
  19 If
  20 \fIfile\fP is not specified, the file named ``draft'' in the user's MH
  21 directory will be used.
  22 \fIComp\fR copies a message form to
  23 the file being composed and then invokes an editor on the
  24 file.
  25 The default editor is /bin/e, which may be overridden with
  26 the `\-editor' switch or with a profile entry ``Editor:''.
  27
  28 The default
  29 message form contains the following elements:
  30
  31      To:
  32      cc:
  33      Subject:
  34      ----------
  35
  36 If the file named ``components'' exists in the user's MH directory,
  37 it will be used instead of this form.
  38 If `\-form
  39 formfile' is specified, the specified formfile (from the MH
  40 directory) will be used as the skeleton.
  41 The line of dashes
  42 or a blank line must be left between the header and the
  43 body of the message for the message to be identified properly when it is
  44 sent (see \fIsend(1)\fR).
  45 The switch `\-use' directs \fIcomp\fR to
  46 continue editing an already started message.
  47 That is, if a
  48 \fIcomp\fR (or \fIdist\fR, \fIrepl\fR, or \fIforw\fR) is terminated without
  49 sending the message, the message can be edited again via
  50 ``comp \-use''.
  51
  52 If the specified file (or draft) already exists, \fIcomp\fR will ask
  53 if you want to delete it before continuing.
  54 A reply of \fBNo\fR will abort the
  55 \fIcomp\fR, \fByes\fR will replace the existing draft with a blank
  56 skeleton, \fBlist\fR will display the draft, and \fBuse\fR will use it
  57 for further composition.
  58
  59 Upon exiting from the editor, \fIcomp\fR will ask ``What now?''.
  60 The valid
  61 responses are \fBlist\fR, to list the draft on the terminal; \fBquit\fR, to
  62 terminate the session and preserve the draft; \fBquit delete\fR, to terminate,
  63 then delete the draft; \fBsend\fR, to send the message; \fBsend verbose\fR, to
  64 cause the delivery process to be monitored; \fBedit <editor>\fR, to invoke
  65 <editor> for further editing; and \fBedit\fR, to re-edit using the
  66 same editor that was used on the preceding round unless a profile
  67 entry ``<lasteditor>\-next: <editor>'' names an alternative editor.
  68
  69 See \fImh-profile(5)\fR for further information
  70 about the how editors are used by MH.
  71 .SH FILES
  72 .ta 2.4i
  73 /etc/mh/components              The message skeleton
  74 .br
  75 or <mh-dir>/components          Rather than the standard
  76 .br
  77 $HOME/\*.mh\(ruprofile          The user profile
  78 .br
  79 <mh-dir>/draft                  The default message file
  80 .br
  81 /usr/bin/send                   To send the composed message
  82 .SH PROFILE\ ELEMENTS
  83 Path:                   To determine the user's MH directory
  84 .br
  85 Editor:                 To override the default editor
  86 .br
  87 <lasteditor>\-next:     To name an editor to be used
  88                         after exit from <lasteditor>
  89 sendproc:       Program to use to send the message
  90 .SH SEE ALSO
  91 send(1), dist(1), repl(1)
  92 .SH DEFAULTS
  93 `file' defaults to draft
  94 .br
  95 `\-editor' defaults to /bin/e
  96 .br
  97 `\-nouse'
  98 .SH CONTEXT
  99 \fIComp\fR does not affect either the current folder or the current messa