[elpa] externals/cape 659f710682 089/146: Add comment

[ELPA Syncer]

branch: externals/cape
commit 659f710682280ba7aee17405217e48a1aba24613
Author: Daniel Mendler <mail@daniel-mendler.de>
Commit: Daniel Mendler <mail@daniel-mendler.de>

    Add comment
---
 cape.el | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/cape.el b/cape.el
index 0c455ac020..deac42a270 100644
--- a/cape.el
+++ b/cape.el
@@ -806,6 +806,11 @@ The PREDICATE is passed the candidate symbol or string."
        `(,beg ,end ,table
               :predicate
               ,(if-let (pred (plist-get plist :predicate))
+                   ;; First argument is key, second is value for hash tables.
+                   ;; The first argument can be a cons cell for alists. Then
+                   ;; the candidate itself is either a string or a symbol. We
+                   ;; normalize the calling convention here such that PREDICATE
+                   ;; always receives a string or a symbol.
                    (lambda (&rest args)
                      (when (apply pred args)
                        (setq args (car args))