Factor trim format function out
[mmh] / man / packf.man1
index 79dccac..337c9a9 100644 (file)
@@ -3,41 +3,26 @@
 .\"
 .TH PACKF %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 .\"
 .TH PACKF %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
-packf \- pack messages in nmh folder into a single file
+packf \- pack messages in mh folder into a single mbox file
 .SH SYNOPSIS
 .HP 5
 .na
 .B packf
 .RI [ +folder ]
 .RI [ msgs ]
 .SH SYNOPSIS
 .HP 5
 .na
 .B packf
 .RI [ +folder ]
 .RI [ msgs ]
-.RB [ \-file
-.IR name ]
-.RB [ \-version ]
+.RB [ \-Version ]
 .RB [ \-help ]
 .ad
 .SH DESCRIPTION
 .B Packf
 .RB [ \-help ]
 .ad
 .SH DESCRIPTION
 .B Packf
-will pack copies of messages from a folder, into a single
-file.
-The messages are separated using mbox (uucp) style delimiters.
-This is the format used by most mail clients (elm, mailx, etc.).
-.PP
-You may specify the name of the file in which to use with the
-.B \-file
-.I name
-switch.  If you do not specify the name of the file, it
-will default to
-.RI \*(lq msgbox \*(rq.
-.PP
-If the given file name points to an existing file, then the specified
-messages will be appended to the end of the file, otherwise the file
-will be created and the messages appended.
+will pack copies of messages from a folder, into mbox format and
+print it to the standard output.
 .PP
 .B packf
 makes an mbox-style delimiter by examining the first line
 .PP
 .B packf
 makes an mbox-style delimiter by examining the first line
-of the message.  If the first line is a \*(lqReturn-Path\*(rq
+of the message.  If the first line is a `Return-Path'
 field, its address and the current date and time are used.  Otherwise,
 field, its address and the current date and time are used.  Otherwise,
-if the first line has an \*(lqX-Envelope-From\*(rq field, its
+if the first line has an `X-Envelope-From' field, its
 contents (which should already be in the correct format) are used.
 Otherwise, a dummy address and the current date and time are used.
 .PP
 contents (which should already be in the correct format) are used.
 Otherwise, a dummy address and the current date and time are used.
 .PP
@@ -60,7 +45,6 @@ can be unpacked using
 .ta \w'ExtraBigProfileName  'u
 ^Path:~^To determine the user's mail storage
 ^Current\-Folder:~^To find the default current folder
 .ta \w'ExtraBigProfileName  'u
 ^Path:~^To determine the user's mail storage
 ^Current\-Folder:~^To find the default current folder
-^Msg\-Protect:~^To set mode when creating a new `file'
 .fi
 
 .SH "SEE ALSO"
 .fi
 
 .SH "SEE ALSO"
@@ -70,7 +54,6 @@ inc(1)
 .nf
 .RB ` +folder "' defaults to the current folder"
 .RB ` msgs "' defaults to all"
 .nf
 .RB ` +folder "' defaults to the current folder"
 .RB ` msgs "' defaults to all"
-.RB ` "\-file ./msgbox" '
 .fi
 
 .SH CONTEXT
 .fi
 
 .SH CONTEXT