~ubuntu-branches/ubuntu/quantal/ibus/quantal

« back to all changes in this revision

Viewing changes to src/ibuserror.h

  • Committer: Bazaar Package Importer
  • Author(s): Barry Warsaw
  • Date: 2011-08-11 17:00:57 UTC
  • mfrom: (6.2.14 sid)
  • Revision ID: james.westby@ubuntu.com-20110811170057-6dmbfs4s3cchzl7x
Tags: 1.3.99.20110419-1ubuntu1
* Merge with Debian unstable.  Remaining Ubuntu changes:
  - Indicator support:
    + Add 05_appindicator.patch: Use an indicator rather than a notification
      icon.
    + debian/control: Recommend python-appindicator.
  - debian/control: Install im-switch instead of im-config by default.
  - debian/README.source: Removed, it was outdated and no longer correct
  - debian/patches/01_ubuntu_desktop: Fix "Desktop entry needs the
    X-Ubuntu-Gettext-Domain key"  (LP: #457632)
  - debian/patches/02_title_update.patch: Rename "IBus Preferences" to
    "Keyboard Input Methods"
  - debian/patches/06_locale_parser.patch: Cherry-picked from upstream.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
/* -*- mode: C; c-basic-offset: 4; indent-tabs-mode: nil; -*- */
2
 
/* vim:set et sts=4: */
3
 
/* ibus - The Input Bus
4
 
 * Copyright (C) 2008-2010 Peng Huang <shawn.p.huang@gmail.com>
5
 
 * Copyright (C) 2008-2010 Red Hat, Inc.
6
 
 *
7
 
 * This library is free software; you can redistribute it and/or
8
 
 * modify it under the terms of the GNU Lesser General Public
9
 
 * License as published by the Free Software Foundation; either
10
 
 * version 2 of the License, or (at your option) any later version.
11
 
 *
12
 
 * This library is distributed in the hope that it will be useful,
13
 
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14
 
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15
 
 * Lesser General Public License for more details.
16
 
 *
17
 
 * You should have received a copy of the GNU Lesser General Public
18
 
 * License along with this library; if not, write to the
19
 
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20
 
 * Boston, MA 02111-1307, USA.
21
 
 */
22
 
/**
23
 
 * SECTION: ibuserror
24
 
 * @short_description: Error message output.
25
 
 * @stability: Stable
26
 
 *
27
 
 * An IBusError is actually a #DBusError.
28
 
 * Functions listed here are convenient wrapper for IBusError new and free.
29
 
 */
30
 
#ifndef __IBUS_ERROR_H_
31
 
#define __IBUS_ERROR_H_
32
 
 
33
 
#include <glib.h>
34
 
#include "ibusdbus.h"
35
 
 
36
 
G_BEGIN_DECLS
37
 
 
38
 
/**
39
 
 * ibus_error_new:
40
 
 * @returns: A newly allocated IBusError.
41
 
 *
42
 
 * New an empty IBusError.
43
 
 */
44
 
IBusError       *ibus_error_new             (void);
45
 
 
46
 
/**
47
 
 * ibus_error_new_from_text:
48
 
 * @name: The error name.
49
 
 * @message: Detailed error message.
50
 
 * @returns: A newly allocated IBusError.
51
 
 *
52
 
 * New an IBusError from error name and message.
53
 
 */
54
 
IBusError       *ibus_error_new_from_text   (const gchar    *name,
55
 
                                             const gchar    *message);
56
 
 
57
 
/**
58
 
 * ibus_error_new_from_printf:
59
 
 * @name: The error name.
60
 
 * @format_message: printf() formatted error message.
61
 
 * @...: Formatting parameters.
62
 
 * @returns: A newly allocated IBusError.
63
 
 *
64
 
 * New an IBusError from error name and a printf-formatted message.
65
 
 */
66
 
IBusError       *ibus_error_new_from_printf (const gchar    *name,
67
 
                                             const gchar    *format_message,
68
 
                                             ...);
69
 
 
70
 
/**
71
 
 * ibus_error_new_from_message:
72
 
 * @message: A DBusMessage
73
 
 * @returns: A newly allocated IBusError.
74
 
 *
75
 
 * New an IBusError from a #IBusMessage.
76
 
 */
77
 
IBusError       *ibus_error_new_from_message
78
 
                                            (IBusMessage    *message);
79
 
 
80
 
/**
81
 
 * ibus_error_free:
82
 
 * @error: An IBusError
83
 
 *
84
 
 * Free an IBusError.
85
 
 */
86
 
void             ibus_error_free            (IBusError      *error);
87
 
 
88
 
G_END_DECLS
89
 
#endif