← Back to branch summary

~ubuntu-branches/ubuntu/quantal/folks/quantal

« back to all changes in this revision

Viewing changes to folks/persona.vala

  • Committer: Package Import Robot
  • Author(s): Robert Ancell
  • Date: 2012-09-12 09:48:10 UTC
  • mfrom: (1.6.2)
  • Revision ID: package-import@ubuntu.com-20120912094810-6zlx8889hcovxj7p
Tags: 0.7.4.1-0ubuntu1
* New upstream bugfix release
* debian/control:
  - Bump build-depends on libglib2.0-dev, valac-0.18, libvala-0.18-dev
* debian/libfolks-eds25.symbols:
* debian/libfolks25.symbols:
  - Updated

Show diffs side-by-side

added added

removed removed

Lines of Context:
folks/persona.vala
48
48
   *
49
49
   * @since 0.6.2
50
50
   */
51
 
  UNKNOWN_ERROR
 
51
  UNKNOWN_ERROR,
 
52
 
 
53
  /**
 
54
   * The backing store is offline or otherwise unavailable.
 
55
   *
 
56
   * This is a temporary error which should be retifiable by going online or
 
57
   * ensuring the backing store is logged in.
 
58
   *
 
59
   * @since 0.7.4
 
60
   */
 
61
  UNAVAILABLE
52
62
}
53
63
 
54
64
/**
106
116
   * The human-readable, service-specific universal ID used to represent the
107
117
   * Persona.
108
118
   *
109
 
   * For example: `foo@@xmpp.example.org`.
 
119
   * For example: ``foo@@xmpp.example.org``.
110
120
   *
111
121
   * This should be used whenever the user needs to be presented with a
112
122
   * familiar, service-specific ID. For instance, in a prompt for the user to
124
134
   * Whether the Persona is the user.
125
135
   *
126
136
   * Iff the Persona represents the user (the person who owns the account in
127
 
   * the respective backend) this is `true`.
 
137
   * the respective backend) this is ``true``.
128
138
   *
129
139
   * @since 0.3.0
130
140
   */
148
158
  /**
149
159
   * The {@link Individual} which contains this Persona.
150
160
   *
151
 
   * This may be `null`, but should only ever be so when the Persona has just
 
161
   * This may be ``null``, but should only ever be so when the Persona has just
152
162
   * been created, when its {@link PersonaStore} is being destroyed, or when
153
163
   * it's moving between {@link Individual}s.
154
164
   *
224
234
   *
225
235
   * This is a callback provided by the {@link IndividualAggregator} whenever
226
236
   * a {@link Persona.linkable_property_to_links} method is called, which should
227
 
   * be called by the `linkable_property_to_links` implementation for each
 
237
   * be called by the ``linkable_property_to_links`` implementation for each
228
238
   * linkable-property-to-individual mapping it wants to add or remove in the
229
239
   * aggregator.
230
240
   *
242
252
   * This is a virtual method, to be overridden by subclasses of {@link Persona}
243
253
   * who have linkable properties. Each of their linkable properties should be
244
254
   * handled by their implementation of this function, examining the current
245
 
   * value of the property and calling `callback` with one or more mapping
 
255
   * value of the property and calling ``callback`` with one or more mapping
246
256
   * strings for the property's value. Each of these mapping strings will be
247
257
   * added to the {@link IndividualAggregator}'s link map, related to the
248
258
   * {@link Individual} instance which contains this {@link Persona}.