From 0a13bf3270a2b24e7fd3f247f7f4bbaaf244daed Mon Sep 17 00:00:00 2001
From: Elijah Newren <newren@gmail.com>
Date: Mon, 3 Oct 2005 20:10:56 +0000
Subject: [PATCH] clarify the meaning of the auto_raise preference. Fixes one
 of the issues

2005-10-03  Elijah Newren  <newren@gmail.com>

	* src/metacity.schemas.in: clarify the meaning of the auto_raise
	preference.  Fixes one of the issues in #312421.
---
 ChangeLog               |  5 +++++
 src/metacity.schemas.in | 10 ++++++++++
 2 files changed, 15 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index f4ba1d433..659c3de86 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2005-10-03  Elijah Newren  <newren@gmail.com>
+
+	* src/metacity.schemas.in: clarify the meaning of the auto_raise
+	preference.  Fixes one of the issues in #312421.
+
 2005-10-03  Elijah Newren  <newren@gmail.com>
 
 	Patch from Ross Cohen to make alt-esc consistent with alt-tab by
diff --git a/src/metacity.schemas.in b/src/metacity.schemas.in
index e39ad0cc9..337b1ae59 100644
--- a/src/metacity.schemas.in
+++ b/src/metacity.schemas.in
@@ -90,6 +90,16 @@
           If true, and the focus mode is either "sloppy" or "mouse"
 	  then the focused window will be automatically raised after a 
 	  delay (the delay is specified by the auto_raise_delay key).
+
+          This preference is poorly named, but kept for backwards
+          compatibility.  To try to be more clear (at least to the
+          technically inclined), its meaning is "automatically raise
+          the window following a timeout which is triggered by
+          non-grabbed mouse entry in sloppy or mouse focus modes".  It
+          is unrelated to clicking behavior (i.e. this is not related
+          to raise-on-click/orthogonal-raise).  It is unrelated to
+          entering a window during drag and drop (because that results
+          in the application grabbing the mouse)
          </long>
       </locale>
     </schema>