summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorXavier Claessens <xavier.claessens@collabora.co.uk>2012-05-18 15:01:44 +0200
committerXavier Claessens <xavier.claessens@collabora.co.uk>2012-07-09 10:25:53 +0200
commit1bf0d434b2112780234b1ef2ee3a4d189e524e48 (patch)
treeb2f5c7603514875ba840215a910dafb32ace587c
parent86f82788bbb0166a1abe3e75f3ebd5012dcff778 (diff)
Remove GetLocations, replaced by the contact attribute
-rw-r--r--spec/Connection_Interface_Location1.xml75
1 files changed, 12 insertions, 63 deletions
diff --git a/spec/Connection_Interface_Location1.xml b/spec/Connection_Interface_Location1.xml
index 1f717eb3..e451a3c4 100644
--- a/spec/Connection_Interface_Location1.xml
+++ b/spec/Connection_Interface_Location1.xml
@@ -258,54 +258,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
</tp:member>
</tp:mapping>
- <method name="GetLocations" tp:name-for-bindings="Get_Locations">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>Return the current locations of the given contacts, if they are
- already known. If any of the given contacts' locations are not known,
- request their current locations, but return immediately without waiting
- for a reply; if a reply with a non-empty location is later received
- for those contacts, the <tp:member-ref>LocationUpdated</tp:member-ref>
- signal will be emitted for them.</p>
-
- <tp:rationale>
- <p>This method is appropriate for "lazy" location finding, for instance
- displaying the location (if available) of everyone in your contact
- list.</p>
- </tp:rationale>
-
- <p>For backwards compatibility, if this method is called by a client
- whose "interest count" for this interface, as defined by <tp:dbus-ref
- namespace="im.telepathy1"
- >Connection.AddClientInterest</tp:dbus-ref>, is zero, the
- Connection SHOULD behave as if AddClientInterest had been called for
- this interface just before that method call. Clients that do not
- explicitly call AddClientInterest SHOULD NOT call <tp:dbus-ref
- namespace="im.telepathy1"
- >Connection.RemoveClientInterest</tp:dbus-ref> either.</p>
- </tp:docstring>
-
- <arg direction="in" name="Contacts" type="au" tp:type="Contact_Handle[]">
- <tp:docstring>
- The contacts whose locations should be returned or signalled.
- </tp:docstring>
- </arg>
-
- <arg direction="out" name="Locations" type="a{ua{sv}}"
- tp:type="Contact_Locations">
- <tp:docstring>
- The contacts' locations, if already known. Contacts whose locations
- are not already known are omitted from the mapping; contacts known
- to have no location information appear in the mapping with an empty
- Location dictionary.
- </tp:docstring>
- </arg>
-
- <tp:possible-errors>
- <tp:error name="im.telepathy1.Error.Disconnected"/>
- <tp:error name="im.telepathy1.Error.InvalidHandle"/>
- </tp:possible-errors>
- </method>
-
<method name="RequestLocation" tp:name-for-bindings="Request_Location">
<tp:docstring>
Return the current location of the given contact. If necessary, make
@@ -441,21 +393,18 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
<tp:contact-attribute name="location"
type="a{sv}" tp:type="Location">
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The same mapping that would be returned by
- <tp:member-ref>GetLocations</tp:member-ref> for this contact.
- Omitted from the result if the contact's location
- is not known.</p>
-
- <p>For backwards compatibility, if contact attributes that include
- this interface are requested
- by a client whose "interest count" for this interface, as defined by
- <tp:dbus-ref namespace="im.telepathy1"
- >Connection.AddClientInterest</tp:dbus-ref>, is zero, the
- Connection SHOULD behave as if AddClientInterest was called for this
- interface just before that request. Clients that do not explicitly
- call AddClientInterest SHOULD NOT call <tp:dbus-ref
- namespace="im.telepathy1"
- >Connection.RemoveClientInterest</tp:dbus-ref> either.</p>
+ <p>The contact's current location, if already known. If contact's
+ location is not known, request their current locations, but return
+ immediately without waiting for a reply; if a reply with a non-empty
+ location is later received, the <tp:member-ref>LocationUpdated</tp:member-ref>
+ signal will be emitted.</p>
+
+ <tp:rationale>
+ <p>This method is appropriate for "lazy" location finding, for instance
+ displaying the location (if available) of everyone in your contact
+ list.</p>
+ </tp:rationale>
+
</tp:docstring>
</tp:contact-attribute>