git.marmaro.de Git - mmh/blob - docs/historical/mh-6.8.5/doc/send.me

   1 .\"     This file is automatically generated.  Do not edit!
   2 .\" @(#)$Id: send.rf,v 1.12 1992/12/04 17:30:23 jromine Exp $
   3 .SC SEND 1
   4 .NA
   5 send \- send a message
   6 .SY
   7 send
   8 \%[\-alias\ aliasfile]
   9 \%[\-draft]
  10 \%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
  11 \%[\-filter\ filterfile] \%[\-nofilter]
  12 \%[\-format] \%[\-noformat]
  13 \%[\-forward] \%[\-noforward]
  14 \%[\-mime] \%[\-nomime]
  15 \%[\-msgid] \%[\-nomsgid]
  16 \%[\-push] \%[\-nopush]
  17 \%[\-split\ seconds]
  18 \%[\-verbose] \%[\-noverbose]
  19 \%[\-watch] \%[\-nowatch]
  20 \%[\-width\ columns]
  21 \%[file\ ...]
  22 \%[\-help]
  23 .DE
  24 \fISend\fR will cause each of the specified files to
  25 be delivered (via \fIpost\fR\0(8)) to each of the destinations
  26 in the \*(lqTo:\*(rq, \*(lqcc:\*(rq, \*(lqBcc:\*(rq, and \*(lqFcc:\*(rq
  27 fields of the message.
  28 If \fIsend\fR is re\-distributing a message, as invoked from \fIdist\fR,
  29 then the corresponding \*(lqResent\-xxx\*(rq fields are examined
  30 instead.
  31
  32 If `\-push' is specified,
  33 \fIsend\fR will detach itself from the user's terminal and perform its
  34 actions in the background.
  35 If \fIpush\fR\0'd and the draft can't be sent,
  36 then the `\-forward' switch says that draft should be forwarded with
  37 the failure notice sent to the user.
  38 This differs from putting \fIsend\fR in the background because the output is
  39 trapped and analyzed by \fIMH\fR.
  40
  41 If `\-verbose' is specified, \fIsend\fR will indicate the interactions
  42 occurring with the transport system, prior to actual delivery.
  43 If `\-watch' is specified \fIsend\fR will monitor the delivery of local and
  44 network mail.  Hence, by specifying both switches, a large detail of
  45 information can be gathered about each step of the message's entry into the
  46 transport system.
  47
  48 The `\-draftfolder\ +folder' and `\-draftmessage\ msg' switches invoke the
  49 \fIMH\fR draft folder facility.
  50 This is an advanced (and highly useful) feature.
  51 Consult the \fBAdvanced Features\fR section of the \fIMH\fR manual for more
  52 information.
  53
  54 If `\-split' is specified,
  55 \fIsend\fR will split the draft into one or more partial messages
  56 prior to sending.
  57 This makes use of the multi-media content feature in MH.
  58 Note however that if \fIsend\fR is invoked under \fIdist\fR\0(1),
  59 then this switch is ignored\0--\0it makes no sense to redistribute a
  60 message in this fashion.
  61 Sometimes you want \fIsend\fR to pause after posting a partial message.
  62 This is usually the case when you are running \fIsendmail\fR and
  63 expect to generate a lot of partial messages.
  64 The argument to `\-split' tells it how long to pause between postings.
  65
  66 \fISend\fR with no \fIfile\fR
  67 argument will query whether the draft is the intended file, whereas
  68 `\-draft' will suppress this question.
  69 Once the transport system has successfully accepted custody of the message,
  70 the file will be renamed
  71 with a leading comma, which allows it to be retrieved until the
  72 next draft message is sent.
  73 If there are errors in the
  74 formatting of the message, \fIsend\fR will abort with a (hopefully)
  75 helpful error message.
  76
  77 If a \*(lqBcc:\*(rq field is encountered,
  78 its addresses will be used for delivery,
  79 and the \*(lqBcc:\*(rq field will be removed from the message sent to sighted
  80 recipients.
  81 The blind recipients will receive an entirely new message with
  82 a minimal set of headers.
  83 Included in the body of the message will be a copy of the message sent to the
  84 sighted recipients.
  85 If `\-filter\ filterfile' is specified,
  86 then this copy is filtered (re\-formatted)
  87 prior to being sent to the blind recipients.
  88 Otherwise,
  89 to use the MIME rules for encapsulation,
  90 specify the `-mime' switch.
  91
  92 Prior to sending the message, the fields \*(lqFrom:\ user@local\*(rq, and
  93 \*(lqDate:\ now\*(rq will be appended to the headers in the message.
  94 If the envariable \fB$SIGNATURE\fR is set,
  95 then its value is used as your personal name when
  96 constructing the \*(lqFrom:\*(rq line of the message.
  97 If this envariable is not set,
  98 then \fIsend\fR will consult the profile entry \*(lqSignature\*(rq
  99 for this information.
 100 On hosts where \fIMH\fR was configured with the UCI option,
 101 if \fB$SIGNATURE\fR is not set and the \*(lqSignature\*(rq profile entry
 102 is not present,
 103 then the file \fB$HOME\fR/.signature is consulted.
 104 If `\-msgid' is
 105 specified, then a \*(lqMessage\-ID:\*(rq field will also be added to the
 106 message.
 107
 108 If \fIsend\fR is re\-distributing a message
 109 (when invoked by \fIdist\fR\0),
 110 then \*(lqResent\-\*(rq will be prepended to each of these fields:
 111 \*(lqFrom:\*(rq, \*(lqDate:\*(rq, and \*(lqMessage\-ID:\*(rq.
 112 If the message already contains a \*(lqFrom:\*(rq field, then a
 113 \*(lqSender: user@local\*(rq field will be added as well.
 114 (An already existing
 115 \*(lqSender:\*(rq field is an error!)
 116
 117 By using the `\-format' switch,
 118 each of the entries in
 119 the \*(lqTo:\*(rq and \*(lqcc:\*(rq fields will be replaced
 120 with \*(lqstandard\*(rq format entries.
 121 This standard format is designed to be usable by all
 122 of the message handlers on the various systems around the
 123 Internet.
 124 If `\-noformat' is given,
 125 then headers are output exactly as they appear in the message draft.
 126
 127 If an \*(lqFcc:\ folder\*(rq is encountered, the message will be copied
 128 to the specified folder for the sender in the format in which it will appear
 129 to any non\-Bcc receivers of the message.
 130 That is, it will have the appended
 131 fields and field reformatting.
 132 The \*(lqFcc:\*(rq fields will be removed from all outgoing copies of the
 133 message.
 134
 135 By using the `\-width\ columns' switch, the user can direct \fIsend\fR as to
 136 how long it should make header lines containing addresses.
 137
 138 The files specified by the profile entry \*(lqAliasfile:\*(rq and any
 139 additional alias files given by the `\-alias aliasfile' switch will be read
 140 (more than one file, each  preceeded by `\-alias', can be named).
 141 See \fImh\-alias\fR\0(5) for more information.
 142 .Fi
 143 ^$HOME/\&.mh\(ruprofile~^The user profile
 144 .Pr
 145 ^Path:~^To determine the user's MH directory
 146 .Ps
 147 ^Draft\-Folder:~^To find the default draft\-folder
 148 .Ps
 149 ^Aliasfile:~^For a default alias file
 150 .Ps
 151 ^Signature:~^To determine the user's mail signature
 152 .Ps
 153 ^mailproc:~^Program to post failure notices
 154 .Ps
 155 ^postproc:~^Program to post the message
 156 .Sa
 157 comp(1), dist(1), forw(1), repl(1), mh\-alias(5), post(8)
 158 .De
 159 `file' defaults to <mh\-dir>/draft
 160 .Ds
 161 `\-alias /opt/mh-6.8.5/lib/MailAliases'
 162 .Ds
 163 `\-nodraftfolder'
 164 .Ds
 165 `\-nofilter'
 166 .Ds
 167 `\-format'
 168 .Ds
 169 `\-forward'
 170 .Ds
 171 `\-nomime'
 172 .Ds
 173 `\-nomsgid'
 174 .Ds
 175 `\-nopush'
 176 .Ds
 177 `\-noverbose'
 178 .Ds
 179 `\-nowatch'
 180 .Ds
 181 `\-width\ 72'
 182 .Co
 183 None
 184 .Bu
 185 Under some configurations, it is not possible to mointor the
 186 mail delivery transaction; `\-watch' is a no-op on those systems.
 187 .sp
 188 Using `\-split\00' doesn't work correctly.
 189 .En