diff options
author | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2010-07-20 17:27:15 +0100 |
---|---|---|
committer | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2010-07-20 17:27:15 +0100 |
commit | 11f06e38a50fffe3ef02540e09123aeca4113200 (patch) | |
tree | e1a46f4e5879c7570424be46656597a316b7c6ed /spec/Account.xml | |
parent | 465e4adf6f999d45ee0d780321fe415c76cd150f (diff) | |
download | telepathy-glib-11f06e38a50fffe3ef02540e09123aeca4113200.tar.gz |
Update spec to 0.19.10
Diffstat (limited to 'spec/Account.xml')
-rw-r--r-- | spec/Account.xml | 30 |
1 files changed, 21 insertions, 9 deletions
diff --git a/spec/Account.xml b/spec/Account.xml index 2bce393ee..5917c6f0b 100644 --- a/spec/Account.xml +++ b/spec/Account.xml @@ -330,7 +330,8 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. <p>If any of the changed parameters' <tp:type>Conn_Mgr_Param_Flags</tp:type> include - <code>DBus_Property</code>, the change will be applied to the + <code>DBus_Property</code>, the change will be applied immediately to + the corresponding D-Bus Property on the active <tp:member-ref>Connection</tp:member-ref>, if there is one. Changes to other parameters will not take effect until the next time the account @@ -372,14 +373,25 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. </arg> <arg name="Reconnect_Required" type="as" direction="out"> - <tp:docstring> - A list of the names of parameters with changes that will not take - effect until the account is reconnected (this may be empty, e.g. if - all the parameters are D-Bus properties or parameters for which the - account manager has specific support). User interfaces that - require "instant apply" semantics MAY call - <tp:member-ref>Reconnect</tp:member-ref> in response to receiving - a non-empty list. + <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> + <p>If all of the parameters had the <code>DBus_Property</code> flag, + the empty list, signifying that no reconnection is required for the + new parameters to take effect. For example, if the only parameter + updated is <tt>...Cellular.<tp:dbus-ref + namespace="org.freedesktop.Telepathy.Connection.Interface.Cellular">MessageValidityPeriod</tp:dbus-ref></tt>, + the new value can be applied immediately to the connection.</p> + + <p>Otherwise, a list of the names of parameters with changes that + will not take effect until the account is reconnected. User + interfaces that require "instant apply" semantics MAY call + <tp:member-ref>Reconnect</tp:member-ref> in response to receiving a + non-empty list. For example, if the caller updates both + <tt>...Anonymity.<tp:dbus-ref + namespace="org.freedesktop.Telepathy.Connection.Interface.Anonymity">AnonymityMandatory</tp:dbus-ref></tt> + and <tt>require-encryption</tt>, the former can be applied to the + current connection, but the latter needs a reconnect to take + effect, so this method should return + <code>["require-encryption"]</code>.</p> </tp:docstring> </arg> |