diff options
authorThomas James Alexander Thurman <>2008-11-10 12:51:33 +0000
committerThomas James Alexander Thurman <>2008-11-10 12:51:33 +0000
commitd079ef538cba10c20bd7f3ef02875a1fa3802d57 (patch)
parent203046237c277dab3a65e503aec1486485e2f8c9 (diff)
updated description of raise_on_click:
* src/ updated description of raise_on_click: svn path=/trunk/; revision=4016
2 files changed, 25 insertions, 0 deletions
diff --git a/ChangeLog b/ChangeLog
index 6a6021b..7446413 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2008-11-10 Elijah Newren <newren gmail com>
+ * src/ updated description of
+ raise_on_click:
2008-11-08 Thomas Thurman <>
* added dependency on Zenity
diff --git a/src/ b/src/
index 5934308..b3a0ec4 100644
--- a/src/
+++ b/src/
@@ -90,11 +90,30 @@
<short>Whether raising should be a side-effect of other user
+ Setting this option to false can lead to buggy behavior, so
+ users are strongly discouraged from changing it from the default
+ of true.
Many actions (e.g. clicking in the client area, moving or resizing the window)
normally raise the window as a side-effect. Setting this option to false, which
is strongly discouraged, will decouple raising from other user actions, and
ignore raise requests generated by applications. See
+ Even when this option is false, windows can
+ still be raised by an alt-left-click anywhere on the window, a
+ normal click on the window decorations, or by special messages
+ from pagers, such as activation requests from tasklist applets.
+ This option is currently disabled in click-to-focus mode.
+ Note that the list of ways to raise windows when raise_on_click
+ is false does not include programmatic requests from
+ applications to raise windows; such requests will be ignored
+ regardless of the reason for the request. If you are an
+ application developer and have a user complaining that your
+ application does not work with this setting disabled, tell them
+ it is _their_ fault for breaking their window manager and that
+ they need to change this option back to true or live with the
+ "bug" they requested.