X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fburst.man1;h=aba045768ccc100ebaccffe4089b7617f55a1f81;hp=5569f750474930dac19950feda85e4b5cd94cc71;hb=68a686adeb39223a5e1ad35e4a24890ec053679d;hpb=9413eae50c4f1843dc7cab43dc11fe79fd28b744 diff --git a/man/burst.man1 b/man/burst.man1 index 5569f75..aba0457 100644 --- a/man/burst.man1 +++ b/man/burst.man1 @@ -10,8 +10,6 @@ burst \- explode digests into messages .B burst .RI [ +folder ] .RI [ msgs ] -.RB [ \-inplace " | " \-noinplace ] -.RB [ \-quiet " | " \-noquiet ] .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 -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.