UTILITY, SPLASH, FULLSCREEN

[Havoc Pennington <hp redhat com>]

Hi,

I'm going ahead and adding these to the CVS draft version of the WM
spec, since no one seemed to object. The patch is appended. Objections
are still welcome, if anyone has better ways of approaching these.

There's also a cheesy typo fix for SKIP_TASKBAR, SKIP_PAGER.

Havoc

Index: wm-spec.sgml
===================================================================
RCS file: /home/freedesktop/wm-spec/wm-spec.sgml,v
retrieving revision 1.14
diff -u -p -u -r1.14 wm-spec.sgml
--- wm-spec.sgml	2001/08/28 13:00:30	1.14
+++ wm-spec.sgml	2001/10/17 12:39:30
@@ -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,9 +633,23 @@ window manager would keep such windows o
 	</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
 _NET_WM_WINDOW_TYPE is not set, then windows with WM_TRANSIENT_FOR set MUST
 be taken as this type.  
@@ -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} indi
 _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;,
@@ -1221,6 +1243,12 @@ OR OTHER DEALINGS IN THE SOFTWARE.  
  			</para></listitem>
  			<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>