From 88805125c4bb6fecc149793366bd011887f8dd73 Mon Sep 17 00:00:00 2001
From: llunak <llunak>
Date: Fri, 13 Oct 2006 16:03:28 +0000
Subject: Add _NET_WM_FULL_PLACEMENT
 (http://mail.gnome.org/archives/wm-spec-list/2006-August/msg00000.html).

---
 wm-spec/wm-spec.xml | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

(limited to 'wm-spec')

diff --git a/wm-spec/wm-spec.xml b/wm-spec/wm-spec.xml
index a8d3671..68ca3df 100644
--- a/wm-spec/wm-spec.xml
+++ b/wm-spec/wm-spec.xml
@@ -1631,6 +1631,40 @@ window.
 	</sect2>
 </sect1>
 
+
+<sect1>
+	<title>Other Properties</title>
+	<sect2>
+		<title>_NET_WM_FULL_PLACEMENT</title>
+		<para>
+By including this hint in _NET_WM_SUPPORTED_LIST the Window Manager announces
+that it performs reasonable window placement for all window types it supports
+(for example centering dialogs on the mainwindow or whatever handling the
+Window Manager considers reasonable). This in turn means that Clients,
+when they detect that this hint is supported, SHOULD NOT abuse or often even
+use PPosition and USPosition hints for requesting placement. In particular:
+		</para>
+<itemizedlist>
+<listitem><para>USPosition is reserved to be used only to indicate that the position was 
+specified by the user and MUST NOT be used for anything else (see ICCCM 
+section 4.1.2.3 for details)</para></listitem>
+<listitem><para>PPosition SHOULD be used for for specifying position only if a specific 
+position should be used. Position SHOULD NOT be specified for "default" 
+placement such as centering dialog windows on their mainwindow.</para></listitem>
+</itemizedlist>
+                <para>
+Rationale: Window managers can often perform better placement (that may be 
+even configurable) for windows than the application. However at the time of 
+writing this it is problematic for Window managers to decide when to use them 
+because many applications abuse positioning flags and/or provide unnecessary 
+default positions.
+                </para>
+                <para>
+Note: The property is not used anywhere else besides being listed in _NET_WM_SUPPORTED_LIST.
+                </para>
+        </sect2>
+</sect1>
+
 <sect1>
     <title>Compositing Managers</title>
     <para>
@@ -2161,6 +2195,9 @@ Added note WM_TRANSIENT_FOR for override-redirect windows
 			<listitem><para>
 Added _NET_WM_USER_TIME_WINDOW.
 			</para></listitem>
+			<listitem><para>
+Added _NET_WM_FULL_PLACEMENT.
+			</para></listitem>
 	        </itemizedlist>
             </sect2>
  	    <sect2>
-- 
cgit v1.2.3-70-g09d2