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 {
Signals
Whenever the system locale or keymap is changed via the daemon,
- PropertyChanged signals are sent out to which clients can subscribe.
+ PropertyChanged signals are sent out to clients which have subscribed.
diff --git a/man/org.freedesktop.login1.xml b/man/org.freedesktop.login1.xml
index 145c24de260..32734b01c0b 100644
--- a/man/org.freedesktop.login1.xml
+++ b/man/org.freedesktop.login1.xml
@@ -754,7 +754,7 @@ node /org/freedesktop/login1 {
Signals
Whenever the inhibition state or idle hint changes, PropertyChanged
- signals are sent out to which clients can subscribe.
+ signals are sent out to clients which have subscribed.
The SecureAttentionKey() 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,13 @@ node /org/freedesktop/login1/seat/seat0 {
Whenever ActiveSession, Sessions,
CanGraphical, CanTTY,
- or the idle state changes, PropertyChanged signals are sent out to which clients
- can subscribe.
+ or the idle state changes, PropertyChanged signals are sent out to clients which
+ have subscribed.
+
+ Signals are only emitted on objects referencing a specific seat ID, not on the
+ /org/freedesktop/login1/seat/self or
+ /org/freedesktop/login1/seat/auto convenience objects, as they can only be
+ dereferenced relative to a method caller.
@@ -1121,7 +1126,11 @@ node /org/freedesktop/login1/user/_1000 {
Signals
Whenever Sessions or the idle state changes,
- PropertyChanged signals are sent out to which clients can subscribe.
+ PropertyChanged signals are sent out to clients which have subscribed.
+
+ Signals are only emitted on objects referencing a specific UID, not on the
+ /org/freedesktop/login1/user/self convenience object, as self
+ can only be dereferenced relative to a method caller.
@@ -1477,12 +1486,17 @@ node /org/freedesktop/login1/session/1 {
open file descriptor in the kernel (except for a limited set of device types).
Whenever Active or the idle state changes,
- PropertyChanged signals are sent out to which clients can subscribe.
+ PropertyChanged signals are sent out to clients which have subscribed.
Lock()/Unlock() 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
accordingly. This signal is sent out as a result of the Lock() and
Unlock() methods, respectively.
+
+ Signals are only emitted on objects referencing a specific session ID, not on the
+ /org/freedesktop/login1/session/self or
+ /org/freedesktop/login1/session/auto convenience objects, as they can only be
+ dereferenced relative to a method caller.
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.
Whenever the Timezone and LocalRTC settings are changed via
- the daemon, PropertyChanged signals are sent out to which clients can subscribe.
+ the daemon, PropertyChanged signals are sent out to clients which have subscribed.
Note that this service will not inform you about system time changes. Use