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
 .\"
 .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
 .SH SYNOPSIS
 .HP 5
 .na
 .B rcvpack
-.I file
+.RI [ file ]
 .RB [ \-version ]
 .RB [ \-help ]
 .ad
 .SH DESCRIPTION
 The
 .B rcvpack
 .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
 .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.).
 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
 .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 ^ ~
 
 .SH FILES
 .fc ^ ~
@@ -40,7 +39,15 @@ shell scripts.
 .fi
 
 .SH "SEE ALSO"
 .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.
 
 .SH BUGS
 Only two return codes are meaningful, others should be.