From 41312aab151fd821ac57c6e4a460f5012016b478 Mon Sep 17 00:00:00 2001
From: Julian Sparber <julian@sparber.net>
Date: Tue, 16 Apr 2024 10:18:31 +0200
Subject: [PATCH] notification: Improve wording around DBus Activation

---
 data/org.freedesktop.portal.Notification.xml | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/data/org.freedesktop.portal.Notification.xml b/data/org.freedesktop.portal.Notification.xml
index a17dbface..1dcc0d98c 100644
--- a/data/org.freedesktop.portal.Notification.xml
+++ b/data/org.freedesktop.portal.Notification.xml
@@ -35,8 +35,15 @@
 
       Notifications can specify actions that can be activated by the
       user. Actions whose name starts with 'app.' are assumed to be
-      exported and will be activated via the ActivateAction()
-      method in the org.freedesktop.Application interface. Other
+      exported (without the 'app.' prefix) and will be activated via
+      `DBus Activation
+      <https://specifications.freedesktop.org/desktop-entry-spec/latest/ar01s08.html>`_
+      using ``ActivateAction()`` method in the
+      ``org.freedesktop.Application`` interface. An `activation-token` for
+      ` XDG Activation
+      <https://gitlab.freedesktop.org/wayland/wayland-protocols/-/blob/main/staging/xdg-activation/xdg-activation-v1.xml>`_
+      and an application-defined `target` is passed when activating the action.
+      Other
       actions are activated by sending the
       #org.freedesktop.portal.Notification::ActionInvoked signal
       to the application.