From d93526a11481847a7e318c9d4ca0e5c83748a119 Mon Sep 17 00:00:00 2001 From: Aleksander Morgado Date: Sun, 12 Apr 2020 17:15:58 +0200 Subject: [PATCH] api,location: improve Location property docs Clearly specify that GetLocation() is another way to retrieve the location information instead of the Location property. --- ...org.freedesktop.ModemManager1.Modem.Location.xml | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/introspection/org.freedesktop.ModemManager1.Modem.Location.xml b/introspection/org.freedesktop.ModemManager1.Modem.Location.xml index d785a24c..4201615c 100644 --- a/introspection/org.freedesktop.ModemManager1.Modem.Location.xml +++ b/introspection/org.freedesktop.ModemManager1.Modem.Location.xml @@ -168,9 +168,16 @@ gathering is enabled. If the modem supports multiple location types it may return more than one here. - Note that if the device was told not to emit updated location - information when location information gathering was initially enabled, - this property may not return any location information for security reasons. + For security reasons, the location information updates via this + property are disabled by default. Users can use this property to monitor + location updates only if the location signals are enabled with + Setup(), + but considering that enabling the location signals would allow all users + to receive property updates as well, not just the process that enabled them. + For a finer grained access control, the user can use the + GetLocation() + method instead, which may require the client to authenticate itself on every + call. This dictionary is composed of a MMModemLocationSource