From: Ralf Habacker <ralf.habacker@freenet.de>
Date: Tue, 15 Feb 2022 15:19:59 +0000 (+0100)
Subject: dbus-specification: Add signal 'ActivatableServicesChanged' and related bus feature
X-Git-Tag: dbus-1.13.22~8^2~1
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=5efc97f03ca581df139b8ed4bca75b333d9e606e;p=thirdparty%2Fdbus.git

dbus-specification: Add signal 'ActivatableServicesChanged' and related bus feature

Signed-off-by: Ralf Habacker <ralf.habacker@freenet.de>
---

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index fecb43802..257fa3007 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -6441,6 +6441,32 @@
         </para>
       </sect3>
 
+      <sect3 id="bus-messages-activatable-services-changed">
+        <title><literal>org.freedesktop.DBus.ActivatableServicesChanged</literal></title>
+        <para>
+          This is a signal:
+          <programlisting>
+            ActivatableServicesChanged ()
+          </programlisting>
+        </para>
+        <para>
+          This signal is sent when the list of activatable services,
+          as returned by ListActivatableNames(), might have changed
+          (see <xref linkend="bus-messages-list-activatable-names"/>).
+          Clients that have cached information about the activatable
+          services should call ListActivatableNames() again to update
+          their cache.
+        </para>
+        <para>
+          The presence of this signal is indicated by a
+          bus feature property (for details see
+          <xref linkend="message-bus-properties-features"/>).
+          In older implementations that do not have this feature,
+          there is no way to be informed when the list of activatable
+          names has changed.
+        </para>
+      </sect3>
+
       <sect3 id="bus-messages-start-service-by-name">
         <title><literal>org.freedesktop.DBus.StartServiceByName</literal></title>
         <para>
@@ -7253,6 +7279,17 @@
           The features currently defined in this specification are as follows:
           <variablelist>
 
+            <varlistentry>
+              <term><literal>ActivatableServicesChanged</literal></term>
+              <listitem>
+                <para>
+                  This message bus emits the <literal>ActivatableServicesChanged</literal>
+                  signal whenever its list of activatable services might have changed
+                  (for details see <xref linkend="bus-messages-activatable-services-changed"/>).
+                </para>
+              </listitem>
+            </varlistentry>
+
             <varlistentry>
               <term><literal>AppArmor</literal></term>
               <listitem>