From: Glenn Morris <rgm@gnu.org>
Date: Mon, 6 Feb 2012 01:27:57 +0000 (-0800)
Subject: * doc/lispref/keymaps.texi (Tool Bar): Mention separators.
X-Git-Tag: emacs-pretest-24.0.94~292
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=f7c9199f38b54df31db3808356a7924c5636c1fe;p=emacs.git

* doc/lispref/keymaps.texi (Tool Bar): Mention separators.
* etc/NEWS: Related markup.
---

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index e184f263737..e26f91b1b4c 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,5 +1,7 @@
 2012-02-06  Glenn Morris  <rgm@gnu.org>
 
+	* keymaps.texi (Tool Bar): Mention separators.
+
 	* modes.texi (Running Hooks): Mention run-hook-wrapped.
 
 	* control.texi (Handling Errors):
diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi
index 8e03ade285f..923989413ee 100644
--- a/doc/lispref/keymaps.texi
+++ b/doc/lispref/keymaps.texi
@@ -2658,6 +2658,15 @@ The @code{:rtl} property specifies an alternative image to use for
 right-to-left languages.  Only the Gtk+ version of Emacs supports this
 at present.
 
+Like the menu bar, the tool bar can display separators (@pxref{Menu
+Separators}).  Tool bar separators are vertical rather than
+horizontal, though, and only a single style is supported.  Separators
+are represented in the tool bar keymap in the same way as for the
+menu-bar, i.e. using a @code{(menu-item "--"}) entry.  The Gtk+ and
+Nextstep tool bars render separators natively, otherwise Emacs selects
+a separator image that is appropriate for the display.  Note that tool
+bar separators do not support any properties, such as @code{:visible}.
+
 The default tool bar is defined so that items specific to editing do not
 appear for major modes whose command symbol has a @code{mode-class}
 property of @code{special} (@pxref{Major Mode Conventions}).  Major
diff --git a/etc/NEWS b/etc/NEWS
index 86b4f60dddf..9ea5d6af7b0 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1335,6 +1335,7 @@ argument is supplied (see Trash changes, above).
 or RGB triplet, instead of signaling an error if the user provides
 invalid input.
 
++++
 ** Tool-bars can display separators.
 Tool-bar separators are handled like menu separators in menu-bar maps,
 i.e. via menu entries of the form `(menu-item "--")'.