[PATCH] [wm-spec] Add a _NET_WM_DESKTOP_FILE

[Martin Gräßlin <mgraesslin kde org>]

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


--nextPart20687335.alxH3FLv42--

--nextPart1968119.pnI14V4cNJ
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: This is a digitally signed message part.
Content-Transfer-Encoding: 7Bit

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2

iEYEABECAAYFAlZDO8MACgkQqVXwidMiVrqmTACfebju5V7w4+o6WI1k/cWhJWq9
oToAn0PbuOr2PF9FYLAfFVcoXSw8uGXP
=wef6
-----END PGP SIGNATURE-----

--nextPart1968119.pnI14V4cNJ--