From 2e2cfb788b7d448e7f23510203211b279ae1e064 Mon Sep 17 00:00:00 2001
From: Daniel Mendler <mail@daniel-mendler.de>
Date: Thu, 22 Jan 2026 08:48:23 +0100
Subject: Add comment regarding metadata merging

---
 cape.el | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/cape.el b/cape.el
index c2cd78b..6105366 100644
--- a/cape.el
+++ b/cape.el
@@ -261,6 +261,8 @@ precedence over the properties specified as part of the Capf result."
                         (and aff `((affixation-function . ,aff))))))
     (if alist
         (lambda (str pred action)
+          ;; We cannot use `completion-table-with-metadata' since the new
+          ;; metadata should be merged with the one of the underlying table.
           (if (eq action 'metadata)
               `(metadata ,@alist
                          ,@(and (functionp table)
-- 
cgit v1.0