From: Jan Djärv <jan.h.d@swipnet.se>
Date: Sun, 12 Oct 2003 18:22:42 +0000 (+0000)
Subject: * xresources.texi (GTK resources): Added a note that some themes
X-Git-Tag: ttn-vms-21-2-B4~8562
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=583a618e46f4dfd8d987bf3158a46b0362505889;p=emacs.git

* 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 28968d0d411..c8d2d18b397 100644
--- a/man/ChangeLog
+++ b/man/ChangeLog
@@ -1,3 +1,8 @@
+2003-10-12  Jan Dj,Ad(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 4c4e840e776..3141aee2d34 100644
--- 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,