[gsettings-desktop-schemas] Update docs for org.gnome.desktop.wm.preferences.raise-on-click

[Jasper St. Pierre <jstpierre src gnome org>]

commit aa548bbca450e25252297b3954496948b947dba0
Author: Federico Mena Quintero <federico gnome org>
Date:   Wed Sep 26 14:56:37 2012 -0500

    Update docs for org.gnome.desktop.wm.preferences.raise-on-click
    
    Now that this is fixed in mutter via https://bugzilla.gnome.org/show_bug.cgi?id=669139,
    it no longer makes sense to talk about old bugs or inconsistencies when raise-on-click
    is turned off.  We simply describe what the option does.

 ....gnome.desktop.wm.preferences.gschema.xml.in.in |   30 +++++--------------
 1 files changed, 8 insertions(+), 22 deletions(-)
---
diff --git a/schemas/org.gnome.desktop.wm.preferences.gschema.xml.in.in 
b/schemas/org.gnome.desktop.wm.preferences.gschema.xml.in.in
index 6809cca..15ad8e7 100644
--- a/schemas/org.gnome.desktop.wm.preferences.gschema.xml.in.in
+++ b/schemas/org.gnome.desktop.wm.preferences.gschema.xml.in.in
@@ -63,31 +63,17 @@
     <key name="raise-on-click" type="b">
       <default>true</default>
       <_summary>
-        Whether raising should be a side-effect of other user interactions
+        Whether windows should be raised when their client area is clicked
       </_summary>
       <_description>
-        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 http://bugzilla.gnome.org/show_bug.cgi?id=445447#c6.
+       The default, true, indicates that a window will be raised
+       whenever its client area or its frame is clicked.
 
-        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.
+       Setting this to false means that a window will not be raised
+       if it is clicked on the client area.  To raise it, one can
+       click anywhere in the window's frame, or Super-click on any
+       part of the window.  This mode is useful if one uses many overlapping
+       windows.
       </_description>
     </key>
     <key name="action-double-click-titlebar"