← Back to branch summary

~ubuntu-branches/ubuntu/utopic/telepathy-python/utopic

« back to all changes in this revision

Viewing changes to spec/Connection_Interface_Renaming.xml

  • Committer: Bazaar Package Importer
  • Author(s): Jonny Lamb
  • Date: 2009-02-16 10:47:31 UTC
  • mfrom: (7.1.14 jaunty)
  • Revision ID: james.westby@ubuntu.com-20090216104731-3l467x71wygwok32
Tags: 0.15.6-2
debian/control: Added myself to Uploaders.

Show diffs side-by-side

added added

removed removed

Lines of Context:
spec/Connection_Interface_Renaming.xml
21
21
  <interface name="org.freedesktop.Telepathy.Connection.Interface.Renaming"
22
22
    tp:causes-havoc='not well-tested'>
23
23
    <tp:requires interface="org.freedesktop.Telepathy.Connection"/>
24
 
    <signal name="Renamed">
25
 
      <arg name="original" type="u" tp:type="Contact_Handle">
 
24
    <signal name="Renamed" tp:name-for-bindings="Renamed">
 
25
      <arg name="Original" type="u" tp:type="Contact_Handle">
26
26
        <tp:docstring>
27
27
          The handle of the original identifier
28
28
        </tp:docstring>
29
29
      </arg>
30
 
      <arg name="new" type="u" tp:type="Contact_Handle">
 
30
      <arg name="New" type="u" tp:type="Contact_Handle">
31
31
        <tp:docstring>
32
32
          The handle of the new identifier
33
33
        </tp:docstring>
50
50
        <p>If the contact's old handle is in any of the member lists of
51
51
          a channel which has the groups interface, it will be removed from
52
52
          the channel and the new handle will be added. The resulting
53
 
          MembersChanged signal must be emitted <em>after</em> the Renamed
54
 
          signal; the reason should be RENAMED.
 
53
          <tp:dbus-ref
 
54
            namespace="org.freedesktop.Telepathy.Channel.Interface.Group">MembersChanged</tp:dbus-ref>
 
55
          signal must be emitted <em>after</em> the
 
56
          <tp:member-ref>Renamed</tp:member-ref> signal; the reason should be
 
57
          RENAMED.
55
58
        </p>
56
59
 
57
60
        <p>The handles may be either general-purpose or channel-specific.
61
64
        </p>
62
65
      </tp:docstring>
63
66
    </signal>
64
 
    <method name="RequestRename">
65
 
      <arg direction="in" name="name" type="s">
 
67
    <method name="RequestRename" tp:name-for-bindings="Request_Rename">
 
68
      <arg direction="in" name="Name" type="s">
66
69
        <tp:docstring>
67
70
          The desired identifier
68
71
        </tp:docstring>
69
72
      </arg>
70
73
      <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
71
74
        <p>Request that the user's own identifier is changed on the server.
72
 
          If successful, a Renamed signal will be emitted for the current
73
 
          "self handle" as returned by GetSelfHandle.</p>
 
75
          If successful, a <tp:member-ref>Renamed</tp:member-ref> signal will
 
76
          be emitted for the current "self handle" as returned by <tp:dbus-ref
 
77
            namespace="org.freedesktop.Telepathy.Connection">GetSelfHandle</tp:dbus-ref>.</p>
74
78
        <p>It is protocol-dependent how the identifier that's actually
75
79
          used will be derived from the supplied identifier; some sort of
76
80
          normalization might take place.</p>