Sync to HEAD

[bpt/emacs.git] / man / xresources.texi

diff --git a/man/xresources.texi b/man/xresources.texi
index 702c6fe..515ad9f 100644 (file)
--- a/man/xresources.texi
+++ b/man/xresources.texi
@@ -142,6 +142,7 @@ frame.  Select one of them, such as @samp{menubar}, then select
 @samp{Show Resource Box} from the @samp{Commands} menu.  This displays
 a list of all the meaningful X resources and allows you to edit them.
 Changes take effect immediately if you click on the @samp{Apply} button.
+(See the @code{editres} man page for more details.)
 
 @node Table of Resources
 @appendixsec Table of X Resources for Emacs
@@ -392,15 +393,22 @@ In the menu bar, the color of the foreground for a selected item.
 @item horizontalSpacing
 Horizontal spacing in pixels between items.  Default is 3.
 @item verticalSpacing
-Vertical spacing in pixels between items.  Default is 1.
+Vertical spacing in pixels between items.  Default is 2.
 @item arrowSpacing
 Horizontal spacing between the arrow (which indicates a submenu) and
 the associated text.  Default is 10.
 @item shadowThickness
-Thickness of shadow line around the widget.
+Thickness of shadow line around the widget.  Default is 1.
+
+Also determines the thickness of shadow lines around other objects,
+for instance 3D buttons and arrows.  If you have the impression that
+the arrows in the menus do not stand out clearly enough or that the
+difference between ``in'' and ``out'' buttons is difficult to see, set
+this to 2.  If you have no problems with visibility, the default
+probably looks better.  The background color may also have some effect
+on the contrast.
 @item margin
-The margin of the menu bar, in characters.  The default of 4 makes the
-menu bar appear like the LessTif/Motif one.
+The margin of the menu bar, in characters.  Default is 1.
 @end table
 
 @node LessTif Resources
@@ -551,7 +559,12 @@ the standard GTK @file{~/.gtkrc-2.0} file or with the Emacs specific
 customizing specific GTK widget features.  To customize Emacs font,
 background, faces etc., use the normal X resources, see @ref{Resources}.
 
-In these files you first defines a style and then how to apply that style
+  Some GTK themes override these mechanisms, which means that using
+these mechanisms will not work to customize them.  We recommend that
+you use @file{~/.emacs.d/gtkrc} for customizations, since
+@file{~/.gtkrc-2.0} seems to be ignored when running GConf with GNOME.
+
+  In these files you first defines a style and then how to apply that style
 to widgets (@pxref{GTK widget names}).  Here is an example of how to
 change the font for Emacs menus:
 
@@ -564,6 +577,21 @@ style "menufont"
 
 widget "*emacs-menuitem*" style "menufont"
 
+@end smallexample
+
+  Here is a more elaborate example, showing how to change the parts of
+the scroll bar:
+
+@smallexample
+style "scroll"
+@{
+  fg[NORMAL] = "red"@ @ @ @ @ # The arrow color.
+  bg[NORMAL] = "yellow"@ @ # The thumb and background around the arrow.
+  bg[ACTIVE] = "blue"@ @ @ @ # The trough color.
+  bg[PRELIGHT] = "white"@ # The thumb color when the mouse is over it.
+@}
+
+widget "*verticalScrollBar*" style "scroll"
 @end smallexample
 
   There are some things you can set without using any style or widget name,
@@ -702,7 +730,7 @@ The names for the emacs widgets, and their classes, are:
 @tab @code{GtkVHbox}
 @item @code{emacs}
 @tab @code{GtkFixed}
-@item @code{verticalScrollbar}
+@item @code{verticalScrollBar}
 @tab @code{GtkVScrollbar}
 @item @code{emacs-toolbar}
 @tab @code{GtkToolbar}
@@ -717,7 +745,7 @@ Thus, for Emacs you can write the two examples above as:
 
 @smallexample
 widget "Emacs.pane.menubar" style "my_style"
-widget "Emacs.pane.emacs.verticalScrollbar" style "my_style"
+widget "Emacs.pane.emacs.verticalScrollBar" style "my_style"
 @end smallexample
 
   GTK absolute names are quite strange when it comes to menus
@@ -929,3 +957,7 @@ family.  It corresponds to the fifth part of an X font name.  It is one of
 
 @noindent
 @var{size} is a decimal number that describes the font size in points.
+
+@ignore
+   arch-tag: 9b6ff773-48b6-41f6-b2f9-f114b8bdd97f
+@end ignore