summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAleix Pol <aleixpol@kde.org>2021-06-14 18:30:29 +0200
committerAleix Pol <aleixpol@kde.org>2021-07-15 16:46:15 +0000
commit923eb9fea389aa3286f2e80deba5e32f3cdb6785 (patch)
treeaaf1473c96898fde94fbb8aaf439f66a0f9aa4cb
parentb9a470004d5a91e4f1de85133a892130e714fc75 (diff)
Let DBus-activated processes properly integrate on Wayland
On Wayland, the xdg-activation-v1 protocol provides means for processes to get activated that requires a token to be passed to the compositor. This change explains how to make this wayland activation happen when the process has been invoked through DBus.
-rw-r--r--desktop-entry/desktop-entry-spec.xml24
1 files changed, 19 insertions, 5 deletions
diff --git a/desktop-entry/desktop-entry-spec.xml b/desktop-entry/desktop-entry-spec.xml
index 35581b3..101a786 100644
--- a/desktop-entry/desktop-entry-spec.xml
+++ b/desktop-entry/desktop-entry-spec.xml
@@ -1035,12 +1035,26 @@
</para>
<para>
All methods take a <literal>platform-data</literal> argument that is used in a similar way to how
- environment variables might be used. Currently, only one field is defined by the specification:
- <varname>desktop-startup-id</varname>. This should be a string of the same value as would be stored in
- the <varname>DESKTOP_STARTUP_ID</varname> environment variable, as specified by the <ulink
- url="http://www.freedesktop.org/Standards/startup-notification-spec">Startup Notification Protocol
- Specification</ulink>.
+ environment variables might be used. Current fields described by the specification are:
</para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <varname>desktop-startup-id</varname>: This should be a string of the same value as would be stored in
+ the <varname>DESKTOP_STARTUP_ID</varname> environment variable, as specified by the <ulink
+ url="http://www.freedesktop.org/Standards/startup-notification-spec">Startup Notification Protocol
+ Specification</ulink>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <varname>activation-token</varname>: This should be a string of the same value as would be stored in
+ the <varname>XDG_ACTIVATION_TOKEN</varname> environment variable, as specified by the <ulink
+ url="https://gitlab.freedesktop.org/wayland/wayland-protocols/-/blob/main/staging/xdg-activation/xdg-activation-v1.xml">
+ XDG Activation</ulink> protocol for Wayland.
+ </para>
+ </listitem>
+ <itemizedlist>
</sect1>
<sect1 id="interfaces">
<title>Interfaces</title>