indentation fix in uip/pick.c
[mmh] / 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.