Re: UTILITY, SPLASH, FULLSCREEN

["Matthias Clasen" <matthiasc poet de>]

May I propose that we add a sentence to the NET_WM_TYPE_DIALOG explanation
to make
it explicit that NET_WM_TYPE_DIALOG is only for transient dialogs and
persistent dialogs should use
NET_WM_TYPE_UTILITY. This may make the transition from EHWM1.1 to EHWM1.2
easier, since
NET_WM_TYPE_UTILITY seems to be a subtype of the old NET_WM_TYPE_DIALOG type
of windows.

Also I would prefer s/DIALOG/NET_WM_TYPE_DIALOG/ in the explanation of
NET_WM_TYPE_UTILITY.

I think the FULLSCREEN explanation should say something about the relation
to WORKAREA and not just
refer to the "entire screen".

Matthias


----- Original Message -----
From: "Havoc Pennington" <hp redhat com>
To: <wm-spec-list gnome org>
Sent: Wednesday, October 17, 2001 8:54 PM
Subject: UTILITY, SPLASH, FULLSCREEN


>
> 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>
>
>
>
>
>
>
> _______________________________________________
> wm-spec-list mailing list
> wm-spec-list gnome org
> http://mail.gnome.org/mailman/listinfo/wm-spec-list
>