diff --git a/man/org.freedesktop.login1.xml b/man/org.freedesktop.login1.xml
index 65618356d7e..fda93450b06 100644
--- a/man/org.freedesktop.login1.xml
+++ b/man/org.freedesktop.login1.xml
@@ -1002,6 +1002,11 @@ node /org/freedesktop/login1/seat/seat0 {
CanGraphical, CanTTY,
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.
@@ -1122,6 +1127,10 @@ node /org/freedesktop/login1/user/_1000 {
Whenever Sessions or the idle state changes,
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.
@@ -1483,6 +1492,11 @@ node /org/freedesktop/login1/session/1 {
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.