summaryrefslogtreecommitdiff
path: root/spec/Connection_Manager.xml
diff options
context:
space:
mode:
authorWill Thompson <will.thompson@collabora.co.uk>2011-03-30 14:58:09 +0100
committerWill Thompson <will.thompson@collabora.co.uk>2011-03-30 14:58:09 +0100
commitb2e7daca8cf62663aaef34b49a7e5b5d56370804 (patch)
treeaed392cb83440881cc9f922f116cd6abde92aa0e /spec/Connection_Manager.xml
parent55d3fecc427d3225f150092b0d63dcaa854957c6 (diff)
downloadtelepathy-glib-b2e7daca8cf62663aaef34b49a7e5b5d56370804.tar.gz
Update to spec 0.22.1.
Diffstat (limited to 'spec/Connection_Manager.xml')
-rw-r--r--spec/Connection_Manager.xml22
1 files changed, 17 insertions, 5 deletions
diff --git a/spec/Connection_Manager.xml b/spec/Connection_Manager.xml
index 3683fcadf..10ade57e8 100644
--- a/spec/Connection_Manager.xml
+++ b/spec/Connection_Manager.xml
@@ -196,11 +196,14 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
</tp:docstring>
</arg>
<tp:docstring>
- Get a list of the parameters which must or may be provided to the
- <tp:member-ref>RequestConnection</tp:member-ref> method when connecting
- to the given protocol,
- or registering (the boolean &quot;register&quot; parameter is available,
- and set to true).
+ Get a list of the parameters which may be specified in the
+ <tp:dbus-ref namespace='ofdT.Account'>Parameters</tp:dbus-ref> of an
+ <tp:dbus-ref namespace='ofdT'>Account</tp:dbus-ref> (or, for
+ specialised applications which do not use the account manager, passed
+ to <tp:member-ref>RequestConnection</tp:member-ref>). Some parameters
+ are mandatory, and some parameters only make sense when registering new
+ accounts with the server; see the <tp:type>Param_Spec</tp:type>
+ documentation for more details.
</tp:docstring>
<tp:possible-errors>
<tp:error name="org.freedesktop.Telepathy.Error.NotImplemented">
@@ -323,6 +326,15 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
<tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">Connect</tp:dbus-ref>
method.</p>
+ <p><strong>Most applications should not use this method</strong>: they
+ should instead use the the <tp:dbus-ref
+ namespace='ofdT.Account'>Connection</tp:dbus-ref> property on an
+ <tp:dbus-ref namespace='ofdT'>Account</tp:dbus-ref> object obtained
+ from the <tp:dbus-ref
+ namespace='ofdT'>AccountManager</tp:dbus-ref>. This method is used
+ internally by the account manager to create connections when
+ needed.</p>
+
<p>The parameters which must and may be provided in the parameters
dictionary can be discovered with the
<tp:member-ref>GetParameters</tp:member-ref> method. These