Hi X11 friends,

please find attached a patch to the WM spec to add a new window property.
Inspiration and idea is taken from Wayland's wl_shell_surface::set_class.

The description should hopefully explain it:

_NET_WM_DESKTOP_FILE, UTF8_STRING

The client SHOULD set this property to the name of the desktop file as
described in http://standards.freedesktop.org/desktop-entry-spec/latest/ if it
is known to the
client. In case it is not known to the client, it SHOULD NOT set the property
at all.

In case the desktop file is not stored in a standard location, the client
should set _NET_WM_DESKTOP_FILE to the full path (e.g. "/opt/foo/
org.freedesktop.foo.desktop").

Otherwise the client should set _NET_WM_DESKTOP_FILE to the base name of the
desktop entry. This is the file name, without the full path and without
extension, of the desktop entry that represents this application according to
the freedesktop desktop entry specification (e.g. "org.freedesktop.foo").

----

I hope we can add this to the protocol. I think it should be easy for toolkits
to add support for this given that it's needed for Wayland anyway. With my Qt
hat on I know that everything is in place to add it to Qt 5.7. With my KDE hat
on I know that everything is in place to add it to frameworks 5.17 even
without support in Qt yet.

Opinions?

Best Regards
Martin Gräßlin
From 0a973875f05f02a31c10439ff3b141d5f3983f69 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Martin Gräßlin?= <mgraess...@kde.org>
Date: Wed, 11 Nov 2015 13:50:09 +0100
Subject: [PATCH] [wm-spec] Add a _NET_WM_DESKTOP_FILE

This new property allows a client window to specify the desktop file
which belongs to the application. This can provide additional
information for e.g. task managers and window managers.
---
 wm-spec/wm-spec.xml | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/wm-spec/wm-spec.xml b/wm-spec/wm-spec.xml
index 0859dc6..b81c35c 100644
--- a/wm-spec/wm-spec.xml
+++ b/wm-spec/wm-spec.xml
@@ -1599,6 +1599,29 @@ copies) and thus perform better. An application which creates
 pop-up windows might always want to run composited to avoid exposes.
         </para>
        </sect2>
+       <sect2><title>_NET_WM_DESKTOP_FILE</title>
+       <programlisting><![CDATA[
+_NET_WM_DESKTOP_FILE, UTF8_STRING
+]]></programlisting>
+       <para>
+The client SHOULD set this property to the name of the desktop file as
+described in the <ulink url="http://standards.freedesktop.org/desktop-entry-spec/latest/";>
+freedesktop desktop entry specification</ulink>
+if it is known to the client. In case it is not known to the client, it
+SHOULD NOT set the property at all.
+       </para>
+       <para>
+In case the desktop file is not stored in a standard location, the client
+should set _NET_WM_DESKTOP_FILE to the full path
+(e.g. &quot;/opt/foo/org.freedesktop.foo.desktop&quot;).
+       </para>
+       <para>
+Otherwise the client should set _NET_WM_DESKTOP_FILE to the base name of the
+desktop entry. This is the file name, without the full path and without
+extension, of the desktop entry that represents this application according to
+the freedesktop desktop entry specification (e.g. &quot;org.freedesktop.foo&quot;).
+       </para>
+       </sect2>
 </sect1>
 <sect1>
 	<title>Window Manager Protocols</title>
@@ -2313,6 +2336,9 @@ Added _NET_WM_STATE_FOCUSED.
 			<listitem><para>
 Added _NET_WM_OPAQUE_REGION
 			</para></listitem>
+			<listitem><para>
+Added _NET_WM_DESKTOP_FILE
+			</para></listitem>
 		</itemizedlist>
 	    </sect2>
  	    <sect2>
--
2.6.2

Attachment: signature.asc
Description: This is a digitally signed message part.

_______________________________________________
wm-spec-list mailing list
wm-spec-list@gnome.org
https://mail.gnome.org/mailman/listinfo/wm-spec-list

Reply via email to