diplodocus.org Git - nmh/blob - man/burst.man

   1 .TH BURST %manext1% "January 1, 2001" "%nmhversion%"
   2 .\"
   3 .\" %nmhwarning%
   4 .\"
   5 .SH NAME
   6 burst \- explode digests into messages
   7 .SH SYNOPSIS
   8 .HP 5
   9 .na
  10 .B burst
  11 .RI [ +folder ]
  12 .RI [ msgs ]
  13 .RB [ \-inplace " | " \-noinplace ]
  14 .RB [ \-mime " | " \-nomime ]
  15 .RB [ \-automime ]
  16 .RB [ \-quiet " | " \-noquiet ]
  17 .RB [ \-verbose " | " \-noverbose ]
  18 .RB [ \-version ]
  19 .RB [ \-help ]
  20 .ad
  21 .SH DESCRIPTION
  22 .B Burst
  23 considers the specified messages in the named folder to be
  24 Internet digests, and explodes them in that folder.
  25 .PP
  26 If
  27 .B \-inplace
  28 is given, each digest is replaced by the \*(lqtable
  29 of contents\*(rq for the digest (the original digest is removed).
  30 .B Burst
  31 then renumbers all of the messages following the digest in the
  32 folder to make room for each of the messages contained within the digest.
  33 These messages are placed immediately after the digest.
  34 .PP
  35 If
  36 .B \-noinplace
  37 is given, each digest is preserved, no table of contents
  38 is produced, and the messages contained within the digest are placed at
  39 the end of the folder.  Other messages are not tampered with in any way.
  40 .PP
  41 If
  42 .B \-automime
  43 is given,
  44 .B burst
  45 will try to determine if the message is formatted with MIME and contains MIME parts of
  46 type \*(lqmessage/rfc822\*(rq. If it does, it will burst the message using MIME
  47 formatting rules.  The
  48 .B \-mime
  49 switch can be used to enforce the use of MIME formatting. The
  50 .B \-nomime
  51 switch will force
  52 .B burst
  53 to use RFC 934 rules.
  54 .PP
  55 The
  56 .B \-quiet
  57 switch directs
  58 .B burst
  59 to be silent about reporting
  60 messages that are not in digest format.
  61 .PP
  62 The
  63 .B \-verbose
  64 switch directs
  65 .B burst
  66 to tell the user the general
  67 actions that it is taking to explode the digest.
  68 .PP
  69 It turns out that
  70 .B burst
  71 works equally well on forwarded messages
  72 and blind\-carbon\-copies as on Internet digests, provided that the
  73 former two were generated by
  74 .B forw
  75 or
  76 .BR send .
  77 .SH FILES
  78 .TP 20
  79 $HOME/.mh\-profile
  80 The user's profile.
  81 .SH "PROFILE COMPONENTS"
  82 .PD 0
  83 .TP 20
  84 Path:
  85 To determine the user's nmh directory.
  86 .TP
  87 Current\-Folder:
  88 To find the default current folder.
  89 .TP
  90 Msg\-Protect:
  91 To set mode when creating a new message.
  92 .PD
  93 .SH "SEE ALSO"
  94 .IR inc (1),
  95 .IR msh (1),
  96 .IR pack (1)
  97 .PP
  98 .I
  99 Proposed Standard for Message Encapsulation
 100 (RFC 934)
 101 .SH DEFAULTS
 102 .PD 0
 103 .TP 20
 104 +folder
 105 The current folder.
 106 .TP
 107 msgs
 108 The current message.
 109 .TP
 110 \-noinplace
 111 .TP
 112 \-automime
 113 .TP
 114 \-noquiet
 115 .TP
 116 \-noverbose
 117 .PD
 118 .SH CONTEXT
 119 If a folder is given, it will become the current folder.  If
 120 .B \-inplace
 121 is given, then the first message burst becomes the current message.
 122 This leaves the context ready for a
 123 .B show
 124 of the table of contents
 125 of the digest, and a
 126 .B next
 127 to see the first message of the digest. If
 128 .B \-noinplace
 129 is given, then the first message extracted from the
 130 first digest burst becomes the current message.  This leaves the context
 131 in a similar, but not identical, state to the context achieved when using
 132 .BR \-inplace .
 133 .SH BUGS
 134 The
 135 .B burst
 136 program enforces a limit on the number of messages which
 137 may be
 138 .B burst
 139 from a single message.  This number is on the order
 140 of 1000 messages.  There is usually no limit on the number of messages
 141 which may reside in the folder after the
 142 .BR burst ing.
 143 .PP
 144 Although
 145 .B burst
 146 uses a sophisticated algorithm to determine where
 147 one encapsulated message ends and another begins, not all digestifying
 148 programs use an encapsulation algorithm.  In degenerate cases, this
 149 usually results in
 150 .B burst
 151 finding an encapsulation boundary
 152 prematurely and splitting a single encapsulated message into two or
 153 more messages.  These erroneous digestifying programs should be fixed.
 154 .PP
 155 Furthermore, any text which appears after the last encapsulated message
 156 is not placed in a separate message by
 157 .BR burst .
 158 In the case of
 159 digestified messages, this text is usually an \*(lqEnd of digest\*(rq
 160 string.  As a result of this possibly un\-friendly behavior on the
 161 part of
 162 .BR burst ,
 163 note that when the
 164 .B \-inplace
 165 option is used,
 166 this trailing information is lost.  In practice, this is not a problem
 167 since correspondents usually place remarks in text prior to the first
 168 encapsulated message, and this information is not lost.