Renamed -version switch to -Version to remove the conflict with -verbose.

[mmh] / man / burst.man1

diff --git a/man/burst.man1 b/man/burst.man1
index 5569f75..36308a8 100644 (file)
--- a/man/burst.man1
+++ b/man/burst.man1
@@ -10,10 +10,8 @@ burst \- explode digests into messages
 .B burst
 .RI [ +folder ]
 .RI [ msgs ]
-.RB [ \-inplace " | " \-noinplace ]
-.RB [ \-quiet " | " \-noquiet ]
 .RB [ \-verbose " | " \-noverbose ]
-.RB [ \-version ]
+.RB [ \-Version ]
 .RB [ \-help ]
 .ad
 .SH DESCRIPTION
@@ -21,27 +19,9 @@ burst \- explode digests into messages
 considers the specified messages in the named folder to be
 Internet digests, and explodes them in that folder.
 .PP
-If
-.B \-inplace
-is given, each digest is replaced by the \*(lqtable
-of contents\*(rq for the digest (the original digest is removed).
-.B Burst
-then renumbers all of the messages following the digest in the
-folder to make room for each of the messages contained within the digest.
-These messages are placed immediately after the digest.
-.PP
-If
-.B \-noinplace
-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
-The
-.B \-quiet
-switch directs
-.B burst
-to be silent about reporting
-messages that are not in digest format.
+The messages contained within the digest are placed at the end of the folder.
+The digest is preserved.
+No other messages are tampered with in any way.
 .PP
 The
 .B \-verbose
@@ -53,11 +33,11 @@ actions that it is taking to explode the digest.
 It turns out that
 .B burst
 works equally well on forwarded messages
-and blind\-carbon\-copies as on Internet digests, provided that the
-former two were generated by
-.B forw
-or
-.BR send .
+and blind\-carbon\-copies as on Internet digests, provided that they
+use RFC 934 message encapsulation.
+.PP
+To extract messages encapsulated with MIME, use
+.BR mhstore (1).
 
 .SH FILES
 .fc ^ ~
@@ -77,7 +57,7 @@ or
 .fi
 
 .SH "SEE ALSO"
-inc(1), pack(1),
+mhstore(1),
 .I "Proposed Standard for Message Encapsulation"
 (RFC\-934)
 
@@ -85,26 +65,13 @@ inc(1), pack(1),
 .nf
 .RB ` +folder "' defaults to the current folder"
 .RB ` msgs "' defaults to cur"
-.RB ` \-noinplace '
-.RB ` \-noquiet '
 .RB ` \-noverbose '
 .fi
 
 .SH CONTEXT
-If a folder is given, it will become the current folder.  If
-.B \-inplace
-is given, then the first message burst becomes the current message.
-This leaves the context ready for a
-.B show
-of the table of contents
-of the digest, and a
-.B next
-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
-in a similar, but not identical, state to the context achieved when using
-.BR \-inplace .
+If a folder is given, it will become the current folder.
+The first message extracted from the
+first digest burst becomes the current message.
 
 .SH BUGS
 The
@@ -128,17 +95,9 @@ finding an encapsulation boundary
 prematurely and splitting a single encapsulated message into two or
 more messages.  These erroneous digestifying programs should be fixed.
 .PP
-Furthermore, any text which appears after the last encapsulated message
+Any text which appears after the last encapsulated message
 is not placed in a separate message by
 .BR burst .
 In the case of
 digestified messages, this text is usually an \*(lqEnd of digest\*(rq
-string.  As a result of this possibly un\-friendly behavior on the
-part of
-.BR burst ,
-note that when the
-.B \-inplace
-option is used,
-this trailing information is lost.  In practice, this is not a problem
-since correspondents usually place remarks in text prior to the first
-encapsulated message, and this information is not lost.
+string.