Add doc and NEWS for tool-bar-position.

* doc/emacs/frames.texi (Tool Bars): Add doc for tool-bar-position.

* doc/lispref/frames.texi (Layout Parameters): Add doc for tool-bar-position.

5 files changed, 24 insertions, 0 deletions

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index a082f8ddb65..fb57554765a 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,7 @@
+2010-07-29  Jan Djärv  <jan.h.d@swipnet.se>
+
+        * frames.texi (Tool Bars): Add doc for tool-bar-position.
+
 2010-06-23  Glenn Morris  <rgm@gnu.org>
 
         * abbrevs.texi, basic.texi, buffers.texi, building.texi, calendar.texi:
diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi
index fbc21f17884..fb7413e8593 100644
--- a/doc/emacs/frames.texi
+++ b/doc/emacs/frames.texi
@@ -1270,6 +1270,12 @@ Customize @code{tool-bar-style} to select style.  The default style is
 the same as for the desktop in the Gnome case.  If no default is found,
 the tool bar uses just images.
 
+@cindex Tool Bar position
+  You can also control the placement of the tool bar for the GTK+ tool bar
+with the frame parameter @code{tool-bar-position}.
+For a detailed description of frame parameters and customization,
+see @ref{Frame Parameters,,, elisp, The Emacs Lisp Reference Manual}.
+
 @node Dialog Boxes
 @section Using Dialog Boxes
 @cindex dialog boxes
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 9d1a9db1148..f5c66806764 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,7 @@
+2010-07-29  Jan Djärv  <jan.h.d@swipnet.se>
+
+        * frames.texi (Layout Parameters): Add doc for tool-bar-position.
+
 2010-07-29  Michael Albinus  <michael.albinus@gmx.de>
 
         * processes.texi (Process Information): Explain process property
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 7dfe3242c5d..a54a65b0743 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -677,6 +677,11 @@ The number of lines to use for the tool bar.  A value of @code{nil}
 means don't display a tool bar.  (GTK and Nextstep allow at most one
 tool bar line; they treat larger values as 1.)
 
+@item tool-bar-position
+The position of the tool bar.  Currently only for the GTK tool bar.
+Value can be one of @code{top}, @code{bottom} @code{left}, @code{right}.
+The default is  @code{top}.
+
 @item line-spacing
 Additional space to leave below each text line, in pixels (a positive
 integer).  @xref{Line Height}, for more information.
diff --git a/etc/NEWS b/etc/NEWS
index 6b781ab8364..2aed81de277 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -99,6 +99,11 @@ Use `set-scroll-bar-mode' to change this.
 Customize `tool-bar-style' to choose style.  On a Gnome desktop, the default
 is taken from the desktop settings.
 
+** GTK tool bars can be placed on the left/right or top/bottom of the frame.
+The frame-parameter tool-bar-position controls this.  It takes the values
+top, left, tight or bottom.  The Options => Show/Hide menu has entries
+for this.
+
 ** Lucid menus and dialogs can display antialiased fonts if Emacs is built
 with Xft.