From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Mon, 14 Dec 2020 16:07:41 +0000 (+0100)
Subject: Tool bar documentation clarification: Mention forcing updates
X-Git-Tag: emacs-28.0.90~4715
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=10bc4eac5bb2e7e4b520628286a52f0508332119;p=emacs.git

Tool bar documentation clarification: Mention forcing updates

* doc/lispref/keymaps.texi (Tool Bar): Document that flipping the
status of a tool bar item doesn't necessarily update the visuals
(bug#42957).
---

diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi
index 6635f50960a..9daeb2c77f9 100644
--- a/doc/lispref/keymaps.texi
+++ b/doc/lispref/keymaps.texi
@@ -2812,6 +2812,11 @@ the shift modifier:
 @xref{Function Keys}, for more information about how to add modifiers to
 function keys.
 
+If you have functions that change whether a tool bar item is enabled
+or not, this status is not necessarily updated visually immediately.
+To force recalculation of the tool bar, call
+@code{force-mode-line-update} (@pxref{Mode Line Format}).
+
 @node Modifying Menus
 @subsection Modifying Menus
 @cindex menu modification