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 4be16b21fb88d39819f0f4a8d6fdb17d29a2045d..01bd8f75265260fd5e6ae0ce587baa1bd3018290 100644 (file)
--- 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