summaryrefslogtreecommitdiff
path: root/spec/Account.xml
diff options
context:
space:
mode:
authorSimon McVittie <simon.mcvittie@collabora.co.uk>2010-07-20 17:27:15 +0100
committerSimon McVittie <simon.mcvittie@collabora.co.uk>2010-07-20 17:27:15 +0100
commit11f06e38a50fffe3ef02540e09123aeca4113200 (patch)
treee1a46f4e5879c7570424be46656597a316b7c6ed /spec/Account.xml
parent465e4adf6f999d45ee0d780321fe415c76cd150f (diff)
downloadtelepathy-glib-11f06e38a50fffe3ef02540e09123aeca4113200.tar.gz
Update spec to 0.19.10
Diffstat (limited to 'spec/Account.xml')
-rw-r--r--spec/Account.xml30
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>