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

   1 .TH DIST 1 RAND
   2 .SH NAME
   3 dist \- redistribute a message to additional addresses
   4 .SH SYNOPSIS
   5 \fBdist\ \fR
   6 \%[\fB+folder\fR]
   7 \%[msg]
   8 \%[\fB\-form\fR\ formfile]
   9 \%[\fB\-editor\fR\ editor]
  10 \%[\fB\-annotate\fR]
  11 \%[\fB\-noannotate\fR]
  12 \%[\fB\-inplace\fR]
  13 \%[\fB\-noinplace\fR]
  14 \%[\fB\-help\fR]
  15 .SH DESCRIPTION
  16 \fIDist\fR is similar to \fIforw\fR.
  17 It prepares the specified
  18 message for redistribution to addresses that (presumably) are
  19 not on the original address list.
  20 The file ``distcomps'' in the
  21 user's MH directory, or a standard form, or the file specified by
  22 `\-form formfile' will be used as the blank components file to
  23 be prepended to the message being distributed.
  24 The standard form
  25 has the components ``Distribute-to:'' and ``Distribute-cc:''.
  26 When
  27 the message is sent, ``Distribution-Date:\ date'',
  28 ``Distribution-From:\ name'', and
  29 ``Distribution-Id:\ id'' (if `\-msgid' is
  30 specified to \fIsend(1)\fR;) will be prepended to the outgoing message.
  31 Only those addresses in ``Distribute-To'', ``Distribute-cc'', and
  32 ``Distribute-Bcc'' will be sent.
  33 Also, a ``Distribute-Fcc:\ folder''
  34 will be honored (see \fIsend(1)\fR).
  35
  36 \fISend\fR recognizes a message as a redistribution message by the
  37 existence of the field ``Distribute-To:'', so don't try to
  38 redistribute a message with only a ``Distribute-cc:''.
  39
  40 If the `\-annotate' switch is given, each message being
  41 distributed will be annotated with the lines:
  42
  43      Distributed:\ <<date>>
  44      Distributed:\ Distribute-to: names
  45
  46 where each ``to'' list contains as many lines as required.
  47 This annotation
  48 will be done only if the message is sent directly from \fIdist\fR.
  49 If the
  50 message is not sent immediately from \fIdist\fR (i.e., if it is sent later
  51 via \fIsend\fR),
  52 ``comp \-use'' may be used to re-edit and send the constructed message, but
  53 the annotations won't take place.
  54 The '\-inplace' switch causes annotation to
  55 be done in place in order to preserve links to the annotated message.
  56
  57 See \fIcomp(1)\fR for a description of the `\-editor' switch and for options
  58 upon exiting from the editor.
  59 See \fImh-profile(5)\fR for further information
  60 about the how editors are used by MH.
  61 .SH FILES
  62 .ta 2.4i
  63 /etc/mh/components      The message skeleton
  64 .br
  65 or <mh-dir>/components  Rather than the standard skeleton
  66 .br
  67 $HOME/.mh\(ruprofile    The user profile
  68 .br
  69 <mh-dir>/draft  The default message file
  70 .br
  71 /usr/ucb/send   To send the composed message
  72 .SH PROFILE COMPONENTS
  73 Path:   To determine the user's MH directory
  74 .br
  75 Editor: To override the use of /bin/ned as the default editor
  76 .br
  77 <lasteditor>\-next:     To name an editor to be used
  78                         after exit from <lasteditor>
  79 .br
  80 sendproc:               Program to use for Send
  81 .SH SEE ALSO
  82 comp(1), deliver(8)
  83 .SH DEFAULTS
  84 `+folder' defaults to the current folder
  85 .br
  86 `msg' defaults to cur
  87 .br
  88 `\-editor' defaults to /bin/ned
  89 .br
  90 `\-noannotate'
  91 .br
  92 `\-noinplace'
  93 .SH CONTEXT
  94 If a +folder is specified, it will become the current
  95 folder, and the current message will be set to the message
  96 being redistr