git.marmaro.de Git - mmh/blob - man/rcvdist.man1

   1 .\"
   2 .\" %nmhwarning%
   3 .\"
   4 .TH RCVDIST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
   5 .SH NAME
   6 rcvdist \- asynchronously redistribute new mail
   7 .SH SYNOPSIS
   8 .HP 5
   9 .na
  10 .B rcvdist
  11 .RB [ \-form
  12 .IR formfile ]
  13 [switches\ for
  14 .BR spost ]
  15 .IR RECIPIENT ...
  16 .RB [ \-Version ]
  17 .RB [ \-help ]
  18 .ad
  19 .SH DESCRIPTION
  20 The
  21 .B rcvdist
  22 program will accept a message on its standard input
  23 and resend a copy of this message to all of the addresses listed on its
  24 command line.
  25 .PP
  26 When a message is redistributed with the
  27 .B rcvdist
  28 command, the
  29 format of the Resent-xxx header fields is controlled by the forms files
  30 .RI ` rcvdistcomps '.
  31 If a file named
  32 .RI ` rcvdistcomps '
  33 exists in the user's mmh
  34 directory, it will be used instead of the default one.  You may specify
  35 an alternate forms file with the switch
  36 .B \-form
  37 .IR formfile .
  38 .PP
  39 The
  40 .RI ` rcvdistcomps '
  41 file uses the format string facility described in
  42 .BR mh\-format (5).
  43 In addition to the standard format escapes,
  44 .B rcvdist
  45 also recognizes the following additional
  46 .I component
  47 escape:
  48 .PP
  49 .RS 5
  50 .nf
  51 .ta \w'Dtimenow  'u +\w'Returns  'u
  52 .I "Escape      Returns Description
  53 addresses       string  the addresses to distribute to
  54 .fi
  55 .RE
  56 .PP
  57 .B rcvdist
  58 uses the program
  59 .B spost
  60 to do the actual
  61 delivery of the message.
  62
  63 .SH FILES
  64 .fc ^ ~
  65 .nf
  66 .ta \w'%etcdir%/ExtraBigFileName  'u
  67 ^%etcdir%/rcvdistcomps~^Default message skeleton
  68 ^or $HOME/.mmh/rcvdistcomps~^Rather than standard message skeleton
  69 .fi
  70
  71 .SH "SEE ALSO"
  72 rcvpack(1), rcvstore(1), mh\-format(5), slocal(1)
  73
  74 .SH BUGS
  75 Only two return codes are meaningful, others should be.