From: Philip Withnall <pwithnall@gnome.org>
Date: Thu, 20 Feb 2025 18:13:00 +0000 (+0000)
Subject: docs: Fix some confusing wording in various D-Bus docs
X-Git-Tag: v258-rc1~1282^2~1
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=5fe4edd3fccd2a14ec3488daeac80ddb33bc71db;p=thirdparty%2Fsystemd.git

docs: Fix some confusing wording in various D-Bus docs

Signed-off-by: Philip Withnall <pwithnall@gnome.org>
---

diff --git a/man/org.freedesktop.locale1.xml b/man/org.freedesktop.locale1.xml
index 4e42c290708..96cca287f43 100644
--- a/man/org.freedesktop.locale1.xml
+++ b/man/org.freedesktop.locale1.xml
@@ -131,7 +131,7 @@ node /org/freedesktop/locale1 {
       <title>Signals</title>
 
       <para>Whenever the system locale or keymap is changed via the daemon,
-      <function>PropertyChanged</function> signals are sent out to which clients can subscribe.</para>
+      <function>PropertyChanged</function> signals are sent out to clients which have subscribed.</para>
     </refsect2>
 
     <refsect2>
diff --git a/man/org.freedesktop.login1.xml b/man/org.freedesktop.login1.xml
index 145c24de260..1e28d4a6466 100644
--- a/man/org.freedesktop.login1.xml
+++ b/man/org.freedesktop.login1.xml
@@ -754,7 +754,7 @@ node /org/freedesktop/login1 {
       <title>Signals</title>
 
       <para>Whenever the inhibition state or idle hint changes, <function>PropertyChanged</function>
-      signals are sent out to which clients can subscribe.</para>
+      signals are sent out to clients which have subscribed.</para>
 
       <para>The <function>SecureAttentionKey()</function> signal is sent when the user presses Ctrl+Alt+Shift+Esc to
       request the login manager to display the greeter, for instance in the case of a deadlocked compositor.
@@ -1000,8 +1000,8 @@ node /org/freedesktop/login1/seat/seat0 {
 
       <para>Whenever <function>ActiveSession</function>, <function>Sessions</function>,
       <function>CanGraphical</function>, <function>CanTTY</function>,
-      or the idle state changes, <function>PropertyChanged</function> signals are sent out to which clients
-      can subscribe.</para>
+      or the idle state changes, <function>PropertyChanged</function> signals are sent out to clients which
+      have subscribed.</para>
     </refsect2>
 
     <refsect2>
@@ -1121,7 +1121,7 @@ node /org/freedesktop/login1/user/_1000 {
       <title>Signals</title>
 
       <para>Whenever <varname>Sessions</varname> or the idle state changes,
-      <function>PropertyChanged</function> signals are sent out to which clients can subscribe.</para>
+      <function>PropertyChanged</function> signals are sent out to clients which have subscribed.</para>
     </refsect2>
 
     <refsect2>
@@ -1477,7 +1477,7 @@ node /org/freedesktop/login1/session/1 {
       open file descriptor in the kernel (except for a limited set of device types).</para>
 
       <para>Whenever <function>Active</function> or the idle state changes,
-      <function>PropertyChanged</function> signals are sent out to which clients can subscribe.</para>
+      <function>PropertyChanged</function> signals are sent out to clients which have subscribed.</para>
 
       <para><function>Lock()</function>/<function>Unlock()</function> is sent when the session is asked to be
       screen-locked/unlocked. A session manager of the session should listen to this signal and act
diff --git a/man/org.freedesktop.timedate1.xml b/man/org.freedesktop.timedate1.xml
index d5044eac71a..aad87b3af56 100644
--- a/man/org.freedesktop.timedate1.xml
+++ b/man/org.freedesktop.timedate1.xml
@@ -148,7 +148,7 @@ node /org/freedesktop/timedate1 {
       over D-Bus. Local clients can access the information directly.</para>
 
       <para>Whenever the <varname>Timezone</varname> and <varname>LocalRTC</varname> settings are changed via
-      the daemon, <function>PropertyChanged</function> signals are sent out to which clients can subscribe.
+      the daemon, <function>PropertyChanged</function> signals are sent out to clients which have subscribed.
       </para>
 
       <para>Note that this service will not inform you about system time changes. Use