Factor trim format function out
[mmh] / man / packf.man1
1 .\"
2 .\" %nmhwarning%
3 .\"
4 .TH PACKF %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
5 .SH NAME
6 packf \- pack messages in mh folder into a single mbox file
7 .SH SYNOPSIS
8 .HP 5
9 .na
10 .B packf
11 .RI [ +folder ]
12 .RI [ msgs ]
13 .RB [ \-Version ]
14 .RB [ \-help ]
15 .ad
16 .SH DESCRIPTION
17 .B Packf
18 will pack copies of messages from a folder, into mbox format and
19 print it to the standard output.
20 .PP
21 .B packf
22 makes an mbox-style delimiter by examining the first line
23 of the message.  If the first line is a `Return-Path'
24 field, its address and the current date and time are used.  Otherwise,
25 if the first line has an `X-Envelope-From' field, its
26 contents (which should already be in the correct format) are used.
27 Otherwise, a dummy address and the current date and time are used.
28 .PP
29 Messages that are packed by
30 .B packf
31 can be unpacked using
32 .BR inc .
33
34 .SH FILES
35 .fc ^ ~
36 .nf
37 .ta \w'%etcdir%/ExtraBigFileName  'u
38 ^$HOME/.mmh/profile~^The user profile
39 .fi
40
41 .SH "PROFILE COMPONENTS"
42 .fc ^ ~
43 .nf
44 .ta 2.4i
45 .ta \w'ExtraBigProfileName  'u
46 ^Path:~^To determine the user's mail storage
47 ^Current\-Folder:~^To find the default current folder
48 .fi
49
50 .SH "SEE ALSO"
51 inc(1)
52
53 .SH DEFAULTS
54 .nf
55 .RB ` +folder "' defaults to the current folder"
56 .RB ` msgs "' defaults to all"
57 .fi
58
59 .SH CONTEXT
60 If a folder is given, it will become the current folder.  The first
61 message packed will become the current message.