From b62a3abbffe5a1d5abf1db8f1d61b7d32fb7824b Mon Sep 17 00:00:00 2001 From: Dan Williams Date: Wed, 10 Apr 2013 13:49:02 -0500 Subject: [PATCH] api: update Settings documentation to explain NewConnection signal timing (bgo #697742) --- introspection/nm-settings.xml | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/introspection/nm-settings.xml b/introspection/nm-settings.xml index 301cde76dd..c791466843 100644 --- a/introspection/nm-settings.xml +++ b/introspection/nm-settings.xml @@ -8,7 +8,7 @@ - List the connections stored by this Settings object. + List the saved network connections known to NetworkManager. @@ -37,7 +37,10 @@ - Add new connection. + Add new connection and save it to disk. This operation does not start + the network connection unless (1) device is idle and able to connect to + the network described by the new connection, and (2) the connection + is allowed to be started automatically. @@ -88,7 +91,14 @@ - Emitted when a new connection has been added. + Emitted when a new connection has been added after NetworkManager has + started up and initialized. This signal is not emitted for connections + read while starting up, because NetworkManager's D-Bus service is only + available after all connections have been read, and to prevent spamming + listeners with too many signals at one time. To retrieve the initial + connection list, call the ListConnections() method once, and then listen + for individual Settings.NewConnection and Settings.Connection.Deleted + signals for further updates.