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.

doc/emacs/ChangeLog

+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:

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

doc/lispref/ChangeLog

+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

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.

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.