git.marmaro.de Git - mmh/blob - man/post.man

   1 .\"
   2 .\" %nmhwarning%
   3 .\" $Id$
   4 .\"
   5 .\" include the -mh macro file
   6 .so %etcdir%/tmac.h
   7 .\"
   8 .TH POST %manext8% MH.6.8 [%nmhversion%]
   9 .SH NAME
  10 post \- deliver a message
  11 .SH SYNOPSIS
  12 .in +.5i
  13 .ti -.5i
  14 %libdir%/post
  15 \%[\-alias\ aliasfile]
  16 .br
  17 \%[\-filter\ filterfile] \%[\-nofilter]
  18 \%[\-format] \%[\-noformat]
  19 .br
  20 \%[\-mime] \%[\-nomime]
  21 \%[\-msgid] \%[\-nomsgid]
  22 \%[\-verbose]
  23 .br
  24 \%[\-noverbose]
  25 \%[\-watch] \%[\-nowatch]
  26 \%[\-width\ columns]
  27 .br
  28 file
  29 \%[\-version]
  30 \%[\-help]
  31 .in -.5i
  32 .SH DESCRIPTION
  33 \fIPost\fR is the default program called by \fIsend\fR\0(1) to deliver
  34 the message in \fIfile\fR to local and remote users.  In fact, most of
  35 the features attributed to \fIsend\fR in its manual page are performed by
  36 \fIpost\fR, with \fIsend\fR acting as a relatively simple preprocessor.
  37 Thus, it is \fIpost\fR which parses the various header fields, appends
  38 From: and Date: lines, and interacts with the mail transport system.
  39 \fIPost\fR will not normally be called directly by the user.
  40
  41 \fIPost\fR searches the \*(lqTo:\*(rq, \*(lqcc:\*(rq, \*(lqBcc:\*(rq,
  42 \*(lqFcc:\*(rq, and \*(lqResent\-xxx:\*(rq header lines of the specified
  43 message for destination addresses, checks these addresses for validity,
  44 and formats them so as to conform to ARPAnet Internet Message Format
  45 protocol, unless the `\-noformat' flag is set.  This will normally cause
  46 \*(lq@\fIlocal\-site\fR\*(rq to be appended to each local destination
  47 address, as well as any local return addresses.  The `\-width\ columns'
  48 switch can be used to indicate the preferred length of the header
  49 components that contain addresses.
  50
  51 If a \*(lqBcc:\*(rq field is encountered, its addresses will be used for
  52 delivery, and the \*(lqBcc:\*(rq field will be removed from the message
  53 sent to sighted recipients.  The blind recipients will receive an entirely
  54 new message with a minimal set of headers.  Included in the body of the
  55 message will be a copy of the message sent to the sighted recipients.
  56 If `\-filter\ filterfile' is specified, then this copy is filtered
  57 (re\-formatted) by \fImhl\fR prior to being sent to the blind recipients.
  58 Alternately, if the `\-mime' switch is given, then \fIpost\fR will use
  59 the MIME rules for encapsulation.
  60
  61 The `\-alias\ aliasfile' switch can be used to specify a file that post
  62 should take aliases from.  More than one file can be specified, each
  63 being preceded with `\-alias'.  In any event, the primary alias file is
  64 read first.
  65
  66 The `\-msgid' switch indicates that a \*(lqMessage\-ID:\*(rq or
  67 \*(lqResent\-Message\-ID:\*(rq field should be added to the header.
  68
  69 The `\-verbose' switch indicates that the user should be informed of
  70 each step of the posting/filing process.
  71
  72 The `\-watch' switch indicates that the user would like to watch the
  73 transport system's handling of the message (e.g., local and \*(lqfast\*(rq
  74 delivery).
  75
  76 \fIPost\fR consults the environment variable \fB$SIGNATURE\fR to determine
  77 the sender's personal name in constructing the \*(lqFrom:\*(rq line of
  78 the message.
  79
  80 .Fi
  81 ^%etcdir%/mts.conf~^nmh mts configuration file
  82 ^%etcdir%/MailAliases~^global nmh alias file
  83 ^%bindir%/refile~^Program to process Fcc:s
  84 ^%libdir%/mhl~^Program to process Bcc:s
  85 .Pr
  86 \fIpost\fR does \fBNOT\fR consult the user's \&.mh\(ruprofile
  87 .Sa
  88 \fIStandard for the Format of ARPA Internet Text Messages\fR (RFC\-822),
  89 .br
  90 mhmail(1), send(1), mh\-mail(5), mh\-alias(5)
  91 .De
  92 `\-alias %etcdir%/MailAliases'
  93 .Ds
  94 `\-format'
  95 .Ds
  96 `\-nomime'
  97 .Ds
  98 `\-nomsgid'
  99 .Ds
 100 `\-noverbose'
 101 .Ds
 102 `\-nowatch'
 103 .Ds
 104 `\-width\ 72'
 105 .Ds
 106 `\-nofilter'
 107 .Co
 108 None
 109 .Bu
 110 \*(lqReply\-To:\*(rq fields are allowed to have groups in them according
 111 to the 822 specification, but \fIpost\fR won't let you use them.
 112 .En