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