]> diplodocus.org Git - nmh/blobdiff - man/burst.man
With EAI (mhbuild -headerencoding utf-8), force message header to
[nmh] / man / burst.man
index 4e2d0cc0daa2dda79a6e05cad974b5877f8671a5..678e5547f405d019425f7797daec8c6bdacb284d 100644 (file)
@@ -1,4 +1,4 @@
-.TH BURST %manext1% "January 1, 2001" "%nmhversion%"
+.TH BURST %manext1% "April 18, 2014" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -8,13 +8,15 @@ burst \- explode digests into messages
 .HP 5
 .na
 .B burst
+.RB [ \-help ]
+.RB [ \-version ]
 .RI [ +folder ]
 .RI [ msgs ]
 .RB [ \-inplace " | " \-noinplace ]
+.RB [ \-mime " | " \-nomime ]
+.RB [ \-automime ]
 .RB [ \-quiet " | " \-noquiet ]
 .RB [ \-verbose " | " \-noverbose ]
-.RB [ \-version ]
-.RB [ \-help ]
 .ad
 .SH DESCRIPTION
 .B Burst
@@ -36,6 +38,20 @@ is given, each digest is preserved, no table of contents
 is produced, and the messages contained within the digest are placed at
 the end of the folder.  Other messages are not tampered with in any way.
 .PP
+If
+.B \-automime
+is given,
+.B burst
+will try to determine if the message is formatted with MIME and contains MIME parts of
+type \*(lqmessage/rfc822\*(rq.  If it does, it will burst the message using MIME
+formatting rules.  The
+.B \-mime
+switch can be used to enforce the use of MIME formatting.  The
+.B \-nomime
+switch will force
+.B burst
+to use RFC 934 rules.
+.PP
 The
 .B \-quiet
 switch directs
@@ -59,36 +75,45 @@ former two were generated by
 or
 .BR send .
 .SH FILES
-.fc ^ ~
-.nf
-.ta \w'%etcdir%/ExtraBigFileName  'u
-^$HOME/\&.mh\(ruprofile~^The user profile
-.fi
+.TP 20
+$HOME/.mh_profile
+The user's profile.
 .SH "PROFILE COMPONENTS"
-.fc ^ ~
-.nf
-.ta 2.4i
-.ta \w'ExtraBigProfileName  'u
-^Path:~^To determine the user's nmh directory
-^Current\-Folder:~^To find the default current folder
-^Msg\-Protect:~^To set mode when creating a new message
-.fi
+.PD 0
+.TP 20
+Path:
+To determine the user's nmh directory.
+.TP
+Current\-Folder:
+To find the default current folder.
+.TP
+Msg\-Protect:
+To set mode when creating a new message.
+.PD
 .SH "SEE ALSO"
 .IR inc (1),
-.IR msh (1),
 .IR pack (1)
 .PP
 .I
 Proposed Standard for Message Encapsulation
-(RFC\-934)
+(RFC 934)
 .SH DEFAULTS
-.nf
-.RB ` +folder "' defaults to the current folder"
-.RB ` msgs "' defaults to cur"
-.RB ` \-noinplace '
-.RB ` \-noquiet '
-.RB ` \-noverbose '
-.fi
+.PD 0
+.TP 20
++folder
+The current folder.
+.TP
+msgs
+The current message.
+.TP
+\-noinplace
+.TP
+\-automime
+.TP
+\-noquiet
+.TP
+\-noverbose
+.PD
 .SH CONTEXT
 If a folder is given, it will become the current folder.  If
 .B \-inplace
@@ -98,7 +123,7 @@ This leaves the context ready for a
 of the table of contents
 of the digest, and a
 .B next
-to see the first message of the digest. If
+to see the first message of the digest.  If
 .B \-noinplace
 is given, then the first message extracted from the
 first digest burst becomes the current message.  This leaves the context