]> diplodocus.org Git - nmh/blobdiff - man/burst.man
Added note that suffixes were removed from filenames of temporary files.
[nmh] / man / burst.man
index 9ebe01cb73cbdca97ba632046f9055b212293a07..3f14bdc47ffb97c26d99d69ca36eb1dd999e2c52 100644 (file)
@@ -1,20 +1,23 @@
+.TH BURST %manext1% "January 1, 2001" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
 .\" %nmhwarning%
-.\" $Id$
 .\"
 .\"
-.TH BURST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 burst \- explode digests into messages
 .SH SYNOPSIS
 .HP 5
 .SH NAME
 burst \- explode digests into messages
 .SH SYNOPSIS
 .HP 5
+.na
 .B burst
 .RI [ +folder ]
 .RI [ msgs ]
 .RB [ \-inplace " | " \-noinplace ]
 .B burst
 .RI [ +folder ]
 .RI [ msgs ]
 .RB [ \-inplace " | " \-noinplace ]
+.RB [ \-mime " | " \-nomime ]
+.RB [ \-automime ]
 .RB [ \-quiet " | " \-noquiet ]
 .RB [ \-verbose " | " \-noverbose ]
 .RB [ \-version ]
 .RB [ \-help ]
 .RB [ \-quiet " | " \-noquiet ]
 .RB [ \-verbose " | " \-noverbose ]
 .RB [ \-version ]
 .RB [ \-help ]
+.ad
 .SH DESCRIPTION
 .B Burst
 considers the specified messages in the named folder to be
 .SH DESCRIPTION
 .B Burst
 considers the specified messages in the named folder to be
@@ -35,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
 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
 The
 .B \-quiet
 switch directs
@@ -57,34 +74,47 @@ former two were generated by
 .B forw
 or
 .BR send .
 .B forw
 or
 .BR send .
-
 .SH FILES
 .SH FILES
-.fc ^ ~
-.nf
-.ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
-^$HOME/\&.mh\(ruprofile~^The user profile
-
+.TP 20
+$HOME/.mh\-profile
+The user's profile.
 .SH "PROFILE COMPONENTS"
 .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
-
+.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"
 .SH "SEE ALSO"
-inc(1), msh(1), pack(1),
-.IR "Proposed Standard for Message Encapsulation" " (RFC\-934)"
-
-.SH "DEFAULTS"
-.nf
-.RB ` +folder "' defaults to the current folder"
-.RB ` msgs "' defaults to cur"
-.RB ` \-noinplace '
-.RB ` \-noquiet '
-.RB ` \-noverbose '
-
+.IR inc (1),
+.IR msh (1),
+.IR pack (1)
+.PP
+.I
+Proposed Standard for Message Encapsulation
+(RFC 934)
+.SH DEFAULTS
+.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
 .SH CONTEXT
 If a folder is given, it will become the current folder.  If
 .B \-inplace
@@ -100,7 +130,6 @@ is given, then the first message extracted from the
 first digest burst becomes the current message.  This leaves the context
 in a similar, but not identical, state to the context achieved when using
 .BR \-inplace .
 first digest burst becomes the current message.  This leaves the context
 in a similar, but not identical, state to the context achieved when using
 .BR \-inplace .
-
 .SH BUGS
 The
 .B burst
 .SH BUGS
 The
 .B burst