summaryrefslogtreecommitdiffstats
path: root/wm-spec/wm-spec.sgml
diff options
context:
space:
mode:
authorhp <hp>2001-10-17 12:43:02 +0000
committerhp <hp>2001-10-17 12:43:02 +0000
commitef38bc5a69eef20bf347b1f464f43482ebd65f50 (patch)
tree116eff7c6b23ac88520abdf01176912c1c4022c1 /wm-spec/wm-spec.sgml
parent03eb8fe8d7b0ad9be2aecb71085df97398d1512a (diff)
downloadxdg-specs-ef38bc5a69eef20bf347b1f464f43482ebd65f50.tar.xz
add TYPE_UTILITY, TYPE_SPLASH, STATE_FULLSCREEN
Diffstat (limited to 'wm-spec/wm-spec.sgml')
-rw-r--r--wm-spec/wm-spec.sgml38
1 files changed, 33 insertions, 5 deletions
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>