git.marmaro.de Git - mmh/blob - man/packf.man1

   1 .\"
   2 .\" %nmhwarning%
   3 .\"
   4 .TH PACKF %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
   5 .SH NAME
   6 packf \- pack messages in nmh folder into a single file
   7 .SH SYNOPSIS
   8 .HP 5
   9 .na
  10 .B packf
  11 .RI [ +folder ]
  12 .RI [ msgs ]
  13 .RB [ \-file
  14 .IR name ]
  15 .RB [ \-version ]
  16 .RB [ \-help ]
  17 .ad
  18 .SH DESCRIPTION
  19 .B Packf
  20 will pack copies of messages from a folder, into a single
  21 file.
  22 The messages are separated using mbox (uucp) style delimiters.
  23 This is the format used by most mail clients (elm, mailx, etc.).
  24 .PP
  25 You may specify the name of the file in which to use with the
  26 .B \-file
  27 .I name
  28 switch.  If you do not specify the name of the file, it
  29 will default to
  30 .RI \*(lq msgbox \*(rq.
  31 .PP
  32 If the given file name points to an existing file, then the specified
  33 messages will be appended to the end of the file, otherwise the file
  34 will be created and the messages appended.
  35 .PP
  36 .B packf
  37 makes an mbox-style delimiter by examining the first line
  38 of the message.  If the first line is a \*(lqReturn-Path\*(rq
  39 field, its address and the current date and time are used.  Otherwise,
  40 if the first line has an \*(lqX-Envelope-From\*(rq field, its
  41 contents (which should already be in the correct format) are used.
  42 Otherwise, a dummy address and the current date and time are used.
  43 .PP
  44 Messages that are packed by
  45 .B packf
  46 can be unpacked using
  47 .BR inc .
  48
  49 .SH FILES
  50 .fc ^ ~
  51 .nf
  52 .ta \w'%etcdir%/ExtraBigFileName  'u
  53 ^$HOME/.mmh/profile~^The user profile
  54 .fi
  55
  56 .SH "PROFILE COMPONENTS"
  57 .fc ^ ~
  58 .nf
  59 .ta 2.4i
  60 .ta \w'ExtraBigProfileName  'u
  61 ^Path:~^To determine the user's mail storage
  62 ^Current\-Folder:~^To find the default current folder
  63 ^Msg\-Protect:~^To set mode when creating a new `file'
  64 .fi
  65
  66 .SH "SEE ALSO"
  67 inc(1)
  68
  69 .SH DEFAULTS
  70 .nf
  71 .RB ` +folder "' defaults to the current folder"
  72 .RB ` msgs "' defaults to all"
  73 .RB ` "\-file ./msgbox" '
  74 .fi
  75
  76 .SH CONTEXT
  77 If a folder is given, it will become the current folder.  The first
  78 message packed will become the current message.