burst: Fixed handling of trailing text; removed -inplace and -quiet.

[mmh] / man / burst.man1

diff --git a/man/burst.man1 b/man/burst.man1
index 5569f75..aba0457 100644 (file)
--- a/man/burst.man1
+++ b/man/burst.man1
@@ -10,8 +10,6 @@ burst \- explode digests into messages
 .B burst
 .RI [ +folder ]
 .RI [ msgs ]
 .B burst
 .RI [ +folder ]
 .RI [ msgs ]

-.RB [ \-inplace " | " \-noinplace ]
-.RB [ \-quiet " | " \-noquiet ]

 .RB [ \-verbose " | " \-noverbose ]
 .RB [ \-version ]
 .RB [ \-help ]
 .RB [ \-verbose " | " \-noverbose ]
 .RB [ \-version ]
 .RB [ \-help ]

@@ -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
 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
 .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
 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 ^ ~
 
 .SH FILES
 .fc ^ ~

@@ -77,7 +57,7 @@ or
 .fi
 
 .SH "SEE ALSO"
 .fi
 
 .SH "SEE ALSO"

-inc(1), pack(1),
+mhstore(1),

 .I "Proposed Standard for Message Encapsulation"
 (RFC\-934)
 
 .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"
 .nf
 .RB ` +folder "' defaults to the current folder"
 .RB ` msgs "' defaults to cur"

-.RB ` \-noinplace '
-.RB ` \-noquiet '

 .RB ` \-noverbose '
 .fi
 
 .SH CONTEXT
 .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
 
 .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
 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
 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.