diplodocus.org Git - nmh/blob - docs/historical/mh-nov-1983/man/comp.1

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