From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Fri, 21 Aug 2020 14:33:33 +0000 (+0200)
Subject: help-at-pt-display-when-idle doc string clarification
X-Git-Tag: emacs-28.0.90~6470
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=fff5c3c061d99a067d728bd90ca00e329bb252ab;p=emacs.git

help-at-pt-display-when-idle doc string clarification

* lisp/help-at-pt.el (help-at-pt-display-when-idle): Clarify when
kbd-help is useful (bug#39295).
---

diff --git a/lisp/help-at-pt.el b/lisp/help-at-pt.el
index dead1f6bf77..e184c782640 100644
--- a/lisp/help-at-pt.el
+++ b/lisp/help-at-pt.el
@@ -162,6 +162,10 @@ included in this list.  Suggested properties are `keymap',
 `local-map', `button' and `kbd-help'.  Any value other than t or
 a non-empty list disables the feature.
 
+The text printed from the `help-echo' property is often only
+relevant when using the mouse.  The presence of a `kbd-help'
+property guarantees that non mouse specific help is available.
+
 This variable only takes effect after a call to
 `help-at-pt-set-timer'.  The help gets printed after Emacs has
 been idle for `help-at-pt-timer-delay' seconds.  You can call