X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=man%2Flispref%2Ftoolbar.texi;h=7cf6a90b6b2da91c3b0a1cb83607b8bb27600606;hb=dbaabf26db874df0c4d70d3bd88247296660dac8;hp=13747cd518059aa72e3ea65dd4a365efbfd84f9f;hpb=2fd9701a4f902054649dde9143a3f77809afee8f;p=chise%2Fxemacs-chise.git

diff --git a/man/lispref/toolbar.texi b/man/lispref/toolbar.texi
index 13747cd..7cf6a90 100644
--- a/man/lispref/toolbar.texi
+++ b/man/lispref/toolbar.texi
@@ -9,7 +9,9 @@
 
 @menu
 * Toolbar Intro::		An introduction.
-* Toolbar Descriptor Format::	How to create a toolbar.
+* Creating Toolbar::            How to create a toolbar.
+* Toolbar Descriptor Format::	Accessing and modifying a toolbar's
+                                  properties.
 * Specifying the Toolbar::	Setting a toolbar's contents.
 * Other Toolbar Variables::	Controlling the size of toolbars.
 @end menu
@@ -57,6 +59,27 @@ from the default just sets the position-specific specifiers, and if
 the user sets the default toolbar to the same position, it will just
 not be visible.
 
+@node Creating Toolbar
+@section Creating Toolbar
+
+@defun make-toolbar-specifier spec-list
+
+Return a new @code{toolbar} specifier object with the given
+specification list.  @var{spec-list} can be a list of specifications
+(each of which is a cons of a locale and a list of instantiators), a
+single instantiator, or a list of instantiators.  @xref{Specifiers}, for
+more information about specifiers.
+
+Toolbar specifiers are used to specify the format of a toolbar.  The
+values of the variables @code{default-toolbar}, @code{top-toolbar},
+@code{left-toolbar}, @code{right-toolbar}, and @code{bottom-toolbar} are
+always toolbar specifiers.
+
+Valid toolbar instantiators are called "toolbar descriptors"
+and are lists of vectors.  See @code{default-toolbar} for a description
+of the exact format.
+@end defun
+
 @node Toolbar Descriptor Format
 @section Toolbar Descriptor Format
 
@@ -187,7 +210,7 @@ the user to choose where the toolbar should go.
 
 @defvr Specifier default-toolbar
 The position of this toolbar is specified in the function
-@code{default-toolbar-position}.  If the corresponding 
+@code{default-toolbar-position}.  If the corresponding
 position-specific toolbar (e.g. @code{top-toolbar} if
 @code{default-toolbar-position} is @code{top}) does not specify a
 toolbar in a particular domain, then the value of @code{default-toolbar}
@@ -247,7 +270,7 @@ Specifier for the toolbar at the right edge of the frame.
 @end defvr
 
 @defun toolbar-specifier-p object
-This function returns non-nil if @var{object} is a toolbar specifier.
+This function returns non-@code{nil} if @var{object} is a toolbar specifier.
 Toolbar specifiers are the actual objects contained in the toolbar
 variables described above, and their valid instantiators are
 toolbar descriptors (@pxref{Toolbar Descriptor Format}).
@@ -343,7 +366,7 @@ Thus, for example, if you set the frame width to 80 characters and the
 left toolbar width for that frame to 68 pixels, then the frame will be
 sized to fit 80 characters plus a 68-pixel left toolbar.  If you then
 set the left toolbar width to 0 for a particular buffer (or if that
-buffer does not specify a left toolbar or has a nil value specified for
+buffer does not specify a left toolbar or has a @code{nil} value specified for
 @code{left-toolbar-visible-p}), you will find that, when that buffer is
 displayed in the selected window, the window will have a width of 86 or
 87 characters---the frame is sized for a 68-pixel left toolbar but the