Fix a memory leak in the "no imap" account prefs label.

[claws.git] / tools / cm-reparent.pl

diff --git a/tools/cm-reparent.pl b/tools/cm-reparent.pl
index 46e2cdb6a99ec72b88da782adbad87cc78d773f8..9a16da2e3b5c5b1149b9c2e6a5ed135b852383d4 100755 (executable)
--- a/tools/cm-reparent.pl
+++ b/tools/cm-reparent.pl
@@ -105,19 +105,46 @@ cm-reparent.pl - fix mail threading
 
 =head1 DESCRIPTION
 
-This script should be called from withing Claws-Mail as an action
+This script should be called from within Claws-Mail as an action
 
 Define an action as
 
   Menu name:  Reparent (fix threading)
   Command:    cm-reparent.pl %F
 
-Then select from the list-view all files that should be re-parented
+Then select from the message list all files that should be re-parented
 
 Then invoke the action
 
 All but the oldest of those mails will be modified (if needed) to
-reflect that the oldest mail is the parent of all other mails
+reflect that the oldest mail is the parent of all other mails by
+adding or altering the header lines C<In-Reply-To:> and C<References:>
+
+Given 4 files A, B, C, and D like
+
+ File         Message-Id    Date
+ A            123AC_12      2016-06-01 12:13:14
+ B            aFFde2993     2016-06-01 13:14:15
+ C            0000_1234     2016-06-02 10:18:04
+ D            foo_bar_12    2016-06-03 04:00:00
+
+The new tree will be like
+
+ A            123AC_12      2016-06-01 12:13:14
+ +- B         aFFde2993     2016-06-01 13:14:15
+ +- C         0000_1234     2016-06-02 10:18:04
+ +- D         foo_bar_12    2016-06-03 04:00:00
+
+and not like
+
+ A            123AC_12      2016-06-01 12:13:14
+ +- B         aFFde2993     2016-06-01 13:14:15
+    +- C      0000_1234     2016-06-02 10:18:04
+       +- D   foo_bar_12    2016-06-03 04:00:00
+
+Existing entries of C<References:> and C<In-Reply-To:> in the header
+of any of B, C, or D will be preserved as C<X-References:> or
+C<X-In-Reply-To:> respectively.
 
 =head1 SEE ALSO