Rearranged whitespace (and comments) in all the code!
[mmh] / man / rcvpack.man
1 .\"
2 .\" %nmhwarning%
3 .\"
4 .TH RCVPACK %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
5 .SH NAME
6 rcvpack \- append message to file
7 .SH SYNOPSIS
8 .HP 5
9 .na
10 .B %libdir%/rcvpack
11 .I file
12 .RB [ \-mbox ]
13 .RB [ \-mmdf ]
14 .RB [ \-version ]
15 .RB [ \-help ]
16 .ad
17 .SH DESCRIPTION
18 The
19 .B rcvpack
20 program will append a copy of the message to the file
21 listed on its command line.
22 .PP
23 If the
24 .B \-mbox
25 switch is given (the default), then the messages are
26 separated using mbox (uucp) style delimiters.  This is the format used
27 by most mail clients (elm, mailx, etc.).
28 .PP
29 If the
30 .B \-mmdf
31 switch is given, then the messages are separated by
32 mmdf style delimiters.  Each message in the file is separated by four
33 CTRL\-A's and a newline.
34 .PP
35 .B rcvpack
36 will correctly lock and unlock the file to serialize
37 access to the file, when running multiple copies of
38 .B rcvpack .
39 .PP
40 In general, its use is obsoleted by the
41 .B file
42 action of
43 .BR slocal ,
44 although it might still have occasional uses in various
45 shell scripts.
46
47 .SH FILES
48 .fc ^ ~
49 .nf
50 .ta \w'%etcdir%/ExtraBigFileName  'u
51 ^%etcdir%/mts.conf~^nmh mts configuration file
52 .fi
53
54 .SH "SEE ALSO"
55 rcvdist(1), rcvstore(1), rcvtty(1), slocal(1)
56
57 .SH BUGS
58 Only two return codes are meaningful, others should be.