interimap: clarify that 'ignore-mailbox' is matched against internal names.

That is, without leading reference, and where the hierarchy delimiter is
replaced with null characters.

/!\ This changes breaks backward compatibility!

diff --git a/Changelog b/Changelog
index 4cc66baba2015cc948b971932a90dfeba2ac6961..84a62b624b758ef1644175a33bac0a65fd3eb902 100644 (file)
--- a/Changelog
+++ b/Changelog
@@ -1,5 +1,13 @@
 interimap (0.5) upstream;
 
+ Breaking changes:
+ * interimap: when matching mailbox names against the 'ignore-mailbox'
+   pattern, the hierarchy delimiter is substituted with a null character
+   before hand.  For instance one should now use '^virtual(?:\x00|$)' to
+   exclude the mailbox named 'virtual' as well as its descendants
+   (regardless of the hierarchy delimiter in use).
+
+ Other changes:
  * interimap: the space-speparated list of names and/or patterns in
    'list-mailbox' can now contain C-style escape sequences (backslash
    and hexadecimal escape).

diff --git a/doc/interimap.1.md b/doc/interimap.1.md
index 387850a87c215f704bed9ed81b5a0db3760c6ee2..d7c371129bc0878e87e28fedc859632c72e71fce 100644 (file)
--- a/doc/interimap.1.md
+++ b/doc/interimap.1.md
@@ -266,7 +266,10 @@ Valid options are:
 :   An optional Perl Compatible Regular Expressions ([PCRE]) covering
     mailboxes to exclude: any ([UTF-7 encoded][RFC 2152] and unquoted)
     mailbox listed in the initial `LIST` responses is ignored if it
-    matches the given expression.
+    matches the given expression after trimming the reference names and
+    substituting the hiearchy delimiter with the null character.  For
+    instance, specifying `^virtual(?:\x00|$)` excludes the mailbox named
+    “virtual” as well as its descendants.
     Note that the *MAILBOX*es given as command-line arguments bypass the
     check and are always considered for synchronization.  This option is
     only available in the default section.

diff --git a/interimap.sample b/interimap.sample
index f771e54efa349bc88307bee86145df57ecb70ef5..2433563add376b8d6c3c8e7569927b701e5656da 100644 (file)
--- a/interimap.sample
+++ b/interimap.sample
@@ -1,7 +1,12 @@
 #database = imap.example.org.db
-#list-mailbox = "*"
+
+# only consider subscribed mailboxes
 list-select-opts = SUBSCRIBED
-ignore-mailbox = ^virtual/
+#list-mailbox = "*"
+
+# ignore the mailbox named 'virtual' and its descendants
+ignore-mailbox = ^virtual(?:\x00|$)
+
 
 [local]
 type = tunnel