If rcvpack missed file argument, it prints to stdout; Removed unused code.
[mmh] / man / rcvpack.man1
index 366b0d5..290f5cc 100644 (file)
@@ -3,35 +3,34 @@
 .\"
 .TH RCVPACK %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
-rcvpack \- append message to file
+rcvpack \- append message to mbox file
 .SH SYNOPSIS
 .HP 5
 .na
 .B rcvpack
-.I file
+.RI [ file ]
 .RB [ \-version ]
 .RB [ \-help ]
 .ad
 .SH DESCRIPTION
 The
 .B rcvpack
-program will append a copy of the message to the file
-listed on its command line.
+program will read a message on standard in, convert it and
+append it to the mbox file listed on the command line.
 .PP
-The messages are separated using mbox (uucp) style delimiters.
+The RFC 822 message is converted to the mbox format.
 This is the format used by most mail clients (elm, mailx, etc.).
+For the nitpickers: It's the mboxo format.
 .PP
 .B rcvpack
 will correctly lock and unlock the file to serialize
 access to the file, when running multiple copies of
 .B rcvpack .
 .PP
-In general, its use is obsoleted by the
-.B file
-action of
-.BR slocal ,
-although it might still have occasional uses in various
-shell scripts.
+If no
+.I file
+argument is given, the converted message is printed to standard out.
+No locking will be done in this case.
 
 .SH FILES
 .fc ^ ~
@@ -40,7 +39,15 @@ shell scripts.
 .fi
 
 .SH "SEE ALSO"
-rcvdist(1), rcvstore(1), slocal(1)
+rcvdist(1), rcvstore(1), slocal(1), packf(1)
+
+.SH HISTORY
+Some people say that this tool would be obsoleted by the
+.B file
+action of
+.BR slocal ,
+although it might still have occasional uses in various
+shell scripts.
 
 .SH BUGS
 Only two return codes are meaningful, others should be.