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.

2 files changed, 15 insertions, 0 deletions

diff --git a/ChangeLog b/ChangeLog
index f4ba1d43..659c3de8 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,10 @@
 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
 	leaving stacking of unselected windows unchanged.  Fixes #314285.
 
diff --git a/src/metacity.schemas.in b/src/metacity.schemas.in
index e39ad0cc..337b1ae5 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>