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

« back to all changes in this revision

Viewing changes to folks/favourite-details.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:
22
22
using GLib;
23
23
 
24
24
/**
25
 
 * Interface exposing a {@link Persona}'s or {@link Individual}'s user-defined
26
 
 * status as a favourite.
 
25
 * Favourite status for a contact.
 
26
 *
 
27
 * This allows user-defined favourite contacts to be specified. A contact is a
 
28
 * favourite if the user has selected them as such; the semantics of 'favourite'
 
29
 * are left unspecified by folks. Typically, a user might select the contacts
 
30
 * that they talk to most frequently as their favourite contacts in an instant
 
31
 * messaging program, for example.
27
32
 */
28
33
public interface Folks.FavouriteDetails : Object
29
34
{
40
45
   * notification and will only return once the favouriteness has been written
41
46
   * to the relevant backing store (or the operation's failed).
42
47
   *
43
 
   * @param is_favourite `true` if the contact is a favourite; `false` otherwise
 
48
   * @param is_favourite ``true`` if the contact is a favourite; ``false``
 
49
   * otherwise
44
50
   * @throws PropertyError if setting the favouriteness failed
45
51
   * @since 0.6.2
46
52
   */