From 2c22a5a3a8da9968cc5b19f0c24d96c25bea6db9 Mon Sep 17 00:00:00 2001 From: Marcel Holtmann Date: Wed, 11 Aug 2010 14:31:43 -0400 Subject: [PATCH] doc: Update network registration and operator API Change the network registration API to reflect simplification in the operator selection and scanning handling for applications. --- doc/network-api.txt | 25 ++++++++++++++----------- 1 file changed, 14 insertions(+), 11 deletions(-) diff --git a/doc/network-api.txt b/doc/network-api.txt index 9e8478c..083e918 100644 --- a/doc/network-api.txt +++ b/doc/network-api.txt @@ -36,7 +36,20 @@ Methods dict GetProperties() Possible Errors: [service].Error.InvalidArguments - array{object} ProposeScan() + array{object,dict} GetOperators() + + Retrieve array of operator object and properties. + + This method can be used to retrieve the current + operator list. This is eithe an empty list (when + not registered to any network) or a list with one + or more operators (when registered). + + This list will also return cached values of previously + seen networks. Manual updates to list can only be + done via the Scan method call. + + array{object,dict} Scan() Runs a network operator scan to discover the currently available operators. This operation can take several @@ -143,16 +156,6 @@ Properties string Mode [readonly] unavailable, this property will not be returned by GetProperties or will be set to an empty string. - array{object} Operators [readonly] - - List of all operator object paths known to the - telephony stack. The scanning for new operators is - done in the background. - - The list of operators is only useful when attempting - manual registration. The automatic registration is - the preferred method. - Network operator hierarchy ========================== -- 2.7.4