* xresources.texi (GTK resources): Added a note that some themes

disallow customizations.  Added scroll theme example.

diff --git a/man/ChangeLog b/man/ChangeLog
index 28968d0d4118fa68916105af281dcda9890bd841..c8d2d18b39724c8236486a99e521e7f1f920dc9c 100644 (file)
--- a/man/ChangeLog
+++ b/man/ChangeLog
@@ -1,3 +1,8 @@
+2003-10-12  Jan Dj\e,Ad\e(Brv  <jan.h.d@swipnet.se>
+
+       * xresources.texi (GTK resources): Added a note that some themes
+       disallow customizations.  Added scroll theme example.
+
 2003-10-08  Nick Roberts  <nick@nick.uklinux.net>
 
        * speedbar.texi: Remove paragraph for GUD that is no longer true.

diff --git a/man/xresources.texi b/man/xresources.texi
index 4c4e840e776d39c154a2057d08c3e9a0d17c879d..3141aee2d348a591f90f4600f41fda858e68ef4c 100644 (file)
--- a/man/xresources.texi
+++ b/man/xresources.texi
@@ -559,7 +559,14 @@ 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
+  NOTE:  Some themes does not allow cutomizations and the mechanisms
+described here may not work for those themes.  The theme may ignore the
+attempt to customization, or things are just not drawn correctly.
+Also, it is recommended that you use @file{~/.emacs.d/gtkrc} for
+customizations, @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:
 
@@ -572,6 +579,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,