diff options
| author | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2013-10-14 17:19:18 +0100 |
|---|---|---|
| committer | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2013-11-04 13:41:04 +0000 |
| commit | fd0103d3786249bf12a9dc1533c499c10f607cdd (patch) | |
| tree | b750b2f3088898d34965fdf47324f9a8cb4e72d3 | |
| parent | 49cc40a4bd62603e6c4973866ea6e6d799241af4 (diff) | |
Renaming: emit new identifier in Renamed signals
As a general design principle, signals that announce a new handle
should announce its identifier too. This lets client libraries
construct a TpContact, Tp::Contact etc. without a round trip.
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=25147
Reviewed-by: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
| -rw-r--r-- | spec/Connection_Interface_Renaming1.xml | 14 |
1 files changed, 13 insertions, 1 deletions
diff --git a/spec/Connection_Interface_Renaming1.xml b/spec/Connection_Interface_Renaming1.xml index 7c480dae..5a5e2b70 100644 --- a/spec/Connection_Interface_Renaming1.xml +++ b/spec/Connection_Interface_Renaming1.xml @@ -27,11 +27,23 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</ The handle of the original identifier </tp:docstring> </arg> - <arg name="New" type="u" tp:type="Contact_Handle"> + <arg name="New_Handle" type="u" tp:type="Contact_Handle"> <tp:docstring> The handle of the new identifier </tp:docstring> </arg> + <arg name="New_Identifier" type="s"> + <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> + <p>The normalized identifier corresponding to New_Handle.</p> + + <tp:rationale> + <p>Providing this immediately means that client libraries + can do useful things with this signal (log the change, + construct contact objects, etc.) without an additional + round-trip to find the corresponding string.</p> + </tp:rationale> + </tp:docstring> + </arg> <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Emitted when the unique identifier of a contact on the server changes.</p> |