From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Sat, 12 Oct 2019 05:30:36 +0000 (+0200)
Subject: tool-bar-map doc string clarification
X-Git-Tag: emacs-27.0.90~1138
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=32c500df99deb88cace9be53dde0dfa0f50304f3;p=emacs.git

tool-bar-map doc string clarification

* lisp/tool-bar.el (tool-bar-map): Try to clarify how this
variable is used (bug#17709).
---

diff --git a/lisp/tool-bar.el b/lisp/tool-bar.el
index 4be16b21fb8..01bd8f75265 100644
--- a/lisp/tool-bar.el
+++ b/lisp/tool-bar.el
@@ -77,7 +77,11 @@ See `tool-bar-mode' for more information."
 
 (defvar tool-bar-map (make-sparse-keymap)
   "Keymap for the tool bar.
-Define this locally to override the global tool bar.")
+
+To override the global tool bar, define this variable
+buffer-locally and add the items you want to it with
+`tool-bar-add-item', `tool-bar-add-item-from-menu' and related
+functions.")
 
 (global-set-key [tool-bar]
 		`(menu-item ,(purecopy "tool bar") ignore