From dd4d09dffb2bc3a1c39a272a1af7168e9e224a90 Mon Sep 17 00:00:00 2001 From: Marcel Holtmann Date: Mon, 16 Apr 2012 11:31:32 +0200 Subject: [PATCH] doc: Update global state property details --- doc/manager-api.txt | 22 +++++++++++++++++----- 1 file changed, 17 insertions(+), 5 deletions(-) diff --git a/doc/manager-api.txt b/doc/manager-api.txt index 166d58a..1f4663e 100644 --- a/doc/manager-api.txt +++ b/doc/manager-api.txt @@ -186,12 +186,24 @@ Signals TechnologyAdded(object path, dict properties) Properties string State [readonly] The global connection state of a system. Possible - values are "online" if at least one connection exists - and "offline" if no device is connected. + values are "offline", "idle", "ready" and "online". - In certain situations the state might change to - the value "connected". This can only be seen if - previously no connection was present. + If the device is in offline mode, the value "offline" + indicates this special global state. It can also be + retrieved via the OfflineMode property, but is kept + here for consistency and to differentiate from "idle". + + The states "idle", "ready" and "online" match to + states from the services. If no service is in + either "ready" or "online" state it will indicate + the "idle" state. + + If at least one service is in "ready" state and no + service is in "online" state, then it will indicate + the "ready" state. + + When at least one service is in "online" state, + this property will indicate "online" as well. boolean OfflineMode [readwrite] -- 2.7.4