From ef38bc5a69eef20bf347b1f464f43482ebd65f50 Mon Sep 17 00:00:00 2001
From: hp <hp>
Date: Wed, 17 Oct 2001 12:43:02 +0000
Subject: add TYPE_UTILITY, TYPE_SPLASH, STATE_FULLSCREEN

---
 wm-spec/wm-spec.sgml | 38 +++++++++++++++++++++++++++++++++-----
 1 file changed, 33 insertions(+), 5 deletions(-)

(limited to 'wm-spec/wm-spec.sgml')

diff --git a/wm-spec/wm-spec.sgml b/wm-spec/wm-spec.sgml
index d396d01..e3ea8a8 100644
--- a/wm-spec/wm-spec.sgml
+++ b/wm-spec/wm-spec.sgml
@@ -15,8 +15,8 @@
 	<sect2>
 		<title>Version</title>
 		<para>
-This is version 1.1 of the Extended Window Manager Hints (EWMH) spec,
-updated 10 March 2001.
+This is DRAFT version 1.2 of the Extended Window Manager Hints (EWMH) spec,
+updated October 11 2001.
 		</para>
 	</sect2>
 	<sect2>
@@ -616,6 +616,8 @@ _NET_WM_WINDOW_TYPE_DESKTOP, ATOM
 _NET_WM_WINDOW_TYPE_DOCK, ATOM
 _NET_WM_WINDOW_TYPE_TOOLBAR, ATOM
 _NET_WM_WINDOW_TYPE_MENU, ATOM
+_NET_WM_WINDOW_TYPE_UTILITY, ATOM
+_NET_WM_WINDOW_TYPE_SPLASH, ATOM
 _NET_WM_WINDOW_TYPE_DIALOG, ATOM
 _NET_WM_WINDOW_TYPE_NORMAL, ATOM
 ]]></programlisting>	
@@ -631,7 +633,21 @@ window manager would keep such windows on top of all other windows.
 	</para>
 	<para>
 _NET_WM_WINDOW_TYPE_TOOLBAR and _NET_WM_WINDOW_TYPE_MENU indicate toolbar and
-pinnable menu windows, respectively. 
+pinnable menu windows, respectively (i.e. toolbars and menus "torn off" from 
+the main application). Windows of this type may set the WM_TRANSIENT_FOR 
+hint indicating the main application window.
+	</para>
+	<para>
+_NET_WM_WINDOW_TYPE_UTILITY indicates a small persistent utility window, such as
+a palette or toolbox. It is distinct from type TOOLBAR because it does not
+correspond to a toolbar torn off from the main application. It's distinct from
+type DIALOG because it isn't a transient dialog, the user will probably keep it
+open while they're working. Windows of this type may set the WM_TRANSIENT_FOR
+hint indicating the main application window.
+	</para>
+	<para>
+_NET_WM_WINDOW_TYPE_SPLASH indicates that the window is a splash screen
+displayed as an application is starting up.
 	</para>
 	<para>
 _NET_WM_WINDOW_TYPE_DIALOG indicates that this is a dialog window.  If
@@ -669,6 +685,7 @@ _NET_WM_STATE_MAXIMIZED_HORZ, ATOM
 _NET_WM_STATE_SHADED, ATOM
 _NET_WM_STATE_SKIP_TASKBAR, ATOM
 _NET_WM_STATE_SKIP_PAGER, ATOM
+_NET_WM_STATE_FULLSCREEN, ATOM
 ]]></programlisting>
       <para>
 An implementation MAY add new atoms to this list. Implementations
@@ -694,14 +711,19 @@ _NET_WM_STATE_MAXIMIZED_{VERT,HORZ} indicates that the window is
 _NET_WM_STATE_SHADED indicates that the window is shaded.
 	</para>
 	<para>
-_NET_WM_SKIP_TASKBAR indicates that the window should not be included on a
+_NET_WM_STATE_SKIP_TASKBAR indicates that the window should not be included on a
 taskbar.
 	</para>
 	<para>
-_NET_WM_SKIP_PAGER indicates that the window should not be included on a
+_NET_WM_STATE_SKIP_PAGER indicates that the window should not be included on a
 pager.
 	</para>
 	<para>
+_NET_WM_STATE_FULLSCREEN indicates that the window should fill the entire screen
+and have no window decorations. For example, a presentation program would use
+this hint.
+	</para>
+	<para>
 To change the state of a mapped window, a Client MUST send a _NET_WM_STATE
 client message to the root window  (window is the respective window, type
 _NET_WM_STATE, format 32, l[0]=&lt;the action, as listed below&gt;,
@@ -1222,6 +1244,12 @@ OR OTHER DEALINGS IN THE SOFTWARE.
  			<listitem><para>
  Specification and sample code for the content of WM_CLIENT_NAME(STRING).
  			</para></listitem>
+ 			<listitem><para>
+ Added _NET_WM_WINDOW_TYPE_SPLASH, _NET_WM_WINDOW_TYPE_UTILITY.
+ 			</para></listitem>
+ 			<listitem><para>
+ Added _NET_WM_STATE_FULLSCREEN.
+ 			</para></listitem>
  	</itemizedlist>
  	</sect2>
     <sect2>
-- 
cgit v1.2.3-70-g09d2