From 41bfb4b5ab61568d8d8232ca49704f39a97be00d Mon Sep 17 00:00:00 2001
From: Ricardo Mones <ricardo@mones.org>
Date: Tue, 7 Jun 2016 13:54:29 +0200
Subject: [PATCH] Improve script documentation

---
 tools/cm-reparent.pl | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/tools/cm-reparent.pl b/tools/cm-reparent.pl
index b9f3f7ce7..520e1350e 100755
--- a/tools/cm-reparent.pl
+++ b/tools/cm-reparent.pl
@@ -119,6 +119,28 @@ 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
 
+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
+
+ 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
+
 =head1 SEE ALSO
 
 L<Date::Parse>, L<Claws Mail|http://www.claws-mail.org>
-- 
2.11.4.GIT