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

« back to all changes in this revision

Viewing changes to spec/Account_Manager.xml

  • Committer: Bazaar Package Importer
  • Author(s): Jonny Lamb
  • Date: 2009-02-23 11:15:10 UTC
  • mfrom: (1.1.13 upstream) (8.1.1 squeeze)
  • Revision ID: james.westby@ubuntu.com-20090223111510-hlm7wiq24fa93o8k
Tags: 0.15.7-1
* New upstream release.
* debian/control: Removed XS-Dm-Upload-Allowed.
* debian/gbp.conf: Removed no-create-orig field.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
<?xml version="1.0" ?>
2
2
<node name="/Account_Manager"
3
3
  xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
4
 
  <tp:copyright>Copyright (C) 2008 Collabora Ltd.</tp:copyright>
5
 
  <tp:copyright>Copyright (C) 2008 Nokia Corporation</tp:copyright>
 
4
  <tp:copyright>Copyright (C) 2008-2009 Collabora Ltd.</tp:copyright>
 
5
  <tp:copyright>Copyright (C) 2008-2009 Nokia Corporation</tp:copyright>
6
6
  <tp:license xmlns="http://www.w3.org/1999/xhtml">
7
7
<p>This library is free software; you can redistribute it and/or
8
8
modify it under the terms of the GNU Lesser General Public
89
89
 
90
90
        <tp:rationale>
91
91
          This is effectively change notification for the valid and invalid
92
 
          accounts lists.
 
92
          accounts lists. On emission of this signal, the Account indicated
 
93
          will no longer be present in either of the lists.
93
94
        </tp:rationale>
94
95
      </tp:docstring>
95
96
 
148
149
      <arg name="Display_Name" direction="in" type="s">
149
150
        <tp:docstring>The initial value of the new account's <tp:dbus-ref
150
151
            namespace="org.freedesktop.Telepathy.Account">DisplayName</tp:dbus-ref>
151
 
          property. The account manager MAY modify this to make it unique,
152
 
          for instance by appending a number or the 'account'
153
 
          parameter.</tp:docstring>
 
152
          property. The account manager SHOULD modify this to make it unique if
 
153
          an Account already exists with the same display name, for instance by
 
154
          appending a number or the 'account' parameter. Account manager
 
155
          implementations SHOULD accept an empty string but account editing user
 
156
          interfaces should avoid passing an empty string for this parameter.
 
157
 
 
158
          <tp:rationale>
 
159
            <p>The account creation UI may ask the user for a name for the new
 
160
              account. If the author of the UI chooses not to do this, the
 
161
              account creation UI is better able to suggest a default display
 
162
              name because it has protocol-specific knowledge which the account
 
163
              manager does not.</p>
 
164
 
 
165
            <p>The account manager always knows the complete list of accounts so
 
166
              it can easily tell whether it should append something to the
 
167
              display name to avoid presenting two identically-named accounts to
 
168
              the user.</p>
 
169
          </tp:rationale>
 
170
        </tp:docstring>
154
171
      </arg>
155
172
 
156
173
      <arg name="Parameters" direction="in" type="a{sv}">