diff --git a/include/zim/archive.h b/include/zim/archive.h
index db28d1291..81862f9c3 100644
--- a/include/zim/archive.h
+++ b/include/zim/archive.h
@@ -225,7 +225,10 @@ namespace zim
        *  On archive without new namespace scheme, path must contain the namespace.
        *  A compatibility layer exists to accept "old" path on new archive (and the opposite)
        *  to help using saved path (bookmark) on new archive.
-       *  But it is not possible to access content in other namespace than `C` in new archive.
+       *  On new archive, we first search the path in `C` namespace, then try to remove the potential namespace in path
+       *  and search again in `C` namespace with path "without namespace".
+       *  On old archive, we first assume path contains a namespace and if not (or no entry found) search in
+       *  namespaces `A`, `I`, `J` and `-`.
        *
        *  @param path The entry's path.
        *  @return The Entry.