From: Juri Linkov <juri@linkov.net>
Date: Thu, 30 Sep 2021 07:04:20 +0000 (+0300)
Subject: ; * lisp/help.el (help--analyze-key): Add comment.
X-Git-Tag: emacs-28.0.90~504
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=a20e013d56fc6ab6e63fea84e48af873cb1cf1c9;p=emacs.git

; * lisp/help.el (help--analyze-key): Add comment.
---

diff --git a/lisp/help.el b/lisp/help.el
index 02e9b9e8e46..eaca33795ae 100644
--- a/lisp/help.el
+++ b/lisp/help.el
@@ -695,6 +695,10 @@ Returns a list of the form (BRIEF-DESC DEFN EVENT MOUSE-MSG)."
 	 (mouse-msg (if (or (memq 'click modifiers) (memq 'down modifiers)
 			    (memq 'drag modifiers))
                         " at that spot" ""))
+         ;; Use mouse-set-point to handle the case when a menu item
+         ;; is selected from the context menu that should describe KEY
+         ;; at the position of mouse click that opened the context menu.
+         ;; When no mouse was involved, it defaults to window-point.
 	 (defn (save-excursion (mouse-set-point event) (key-binding key t))))
     ;; Handle the case where we faked an entry in "Select and Paste" menu.
     (when (and (eq defn nil)