fix logic bug in pick GREPaction
[mmh] / man / rcvpack.man1
1 .\"
2 .\" %nmhwarning%
3 .\"
4 .TH RCVPACK %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
5 .SH NAME
6 rcvpack \- asynchronously append message to mbox file
7 .SH SYNOPSIS
8 .HP 5
9 .na
10 .B rcvpack
11 .RI [ file ]
12 .RB [ \-Version ]
13 .RB [ \-help ]
14 .ad
15 .SH DESCRIPTION
16 The
17 .B rcvpack
18 program will read a message on standard in, convert it and
19 append it to the mbox file listed on the command line.
20 .PP
21 The RFC 822 message is converted to the mbox format.
22 This is the format used by most mail clients (elm, mailx, etc.).
23 For the nitpickers: It's the mboxo format.
24 .PP
25 .B rcvpack
26 will correctly lock and unlock the file to serialize
27 access to the file, when running multiple copies of
28 .B rcvpack .
29 .PP
30 If no
31 .I file
32 argument is given, the converted message is printed to standard out.
33 No locking will be done in this case.
34
35 .SH FILES
36 .fc ^ ~
37 .nf
38 .ta \w'%etcdir%/ExtraBigFileName  'u
39 .fi
40
41 .SH "SEE ALSO"
42 rcvdist(1), rcvstore(1), slocal(1), packf(1)
43
44 .SH HISTORY
45 Some people say that this tool would be obsoleted by the
46 .B file
47 action of
48 .BR slocal ,
49 although it might still have occasional uses in various
50 shell scripts.
51
52 .SH BUGS
53 Only two return codes are meaningful, others should be.