doc: Update network registration and operator API

Change the network registration API to reflect simplification in the
operator selection and scanning handling for applications.
This commit is contained in:
Marcel Holtmann 2010-08-11 14:31:43 -04:00
parent dc8dd86672
commit 2c22a5a3a8
1 changed files with 14 additions and 11 deletions

View File

@ -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
==========================