Mercurial > pidgin.yaz
annotate src/debug.h @ 6452:e14382546fbd
[gaim-migrate @ 6961]
updates to the it.po and pt_BR.po from the usual suspects
committer: Tailor Script <tailor@pidgin.im>
author | Luke Schierer <lschiere@pidgin.im> |
---|---|
date | Wed, 13 Aug 2003 16:52:25 +0000 |
parents | 158196b2db19 |
children | 565339a6eb86 |
rev | line source |
---|---|
5212 | 1 /** |
2 * @file debug.h Debug API | |
3 * @ingroup core | |
4 * | |
5 * gaim | |
6 * | |
7 * Copyright (C) 2002-2003, Christian Hammond <chipx86@gnupdate.org> | |
8 * | |
9 * This program is free software; you can redistribute it and/or modify | |
10 * it under the terms of the GNU General Public License as published by | |
11 * the Free Software Foundation; either version 2 of the License, or | |
12 * (at your option) any later version. | |
13 * | |
14 * This program is distributed in the hope that it will be useful, | |
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
17 * GNU General Public License for more details. | |
18 * | |
19 * You should have received a copy of the GNU General Public License | |
20 * along with this program; if not, write to the Free Software | |
21 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA | |
22 */ | |
23 #ifndef _GAIM_DEBUG_H_ | |
24 #define _GAIM_DEBUG_H_ | |
25 | |
26 #include <stdarg.h> | |
27 | |
28 /** | |
29 * Debug levels. | |
30 */ | |
31 typedef enum | |
32 { | |
33 GAIM_DEBUG_ALL = 0, /**< All debug levels. */ | |
34 GAIM_DEBUG_MISC, /**< General chatter. */ | |
35 GAIM_DEBUG_INFO, /**< General operation Information. */ | |
36 GAIM_DEBUG_WARNING, /**< Warnings. */ | |
37 GAIM_DEBUG_ERROR, /**< Errors. */ | |
38 GAIM_DEBUG_FATAL /**< Fatal errors. */ | |
39 | |
40 } GaimDebugLevel; | |
41 | |
42 /** | |
43 * Debug UI operations. | |
44 */ | |
45 typedef struct | |
46 { | |
47 void (*print)(GaimDebugLevel level, const char *category, | |
48 const char *format, va_list args); | |
49 | |
50 } GaimDebugUiOps; | |
51 | |
5944
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
52 #ifdef __cplusplus |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
53 extern "C" { |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
54 #endif |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
55 |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
56 /**************************************************************************/ |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
57 /** @name Debug API */ |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
58 /**************************************************************************/ |
5212 | 59 /** |
60 * Outputs debug information. | |
61 * | |
62 * This differs from gaim_debug() in that it takes a va_list. | |
63 * | |
64 * @param level The debug level. | |
65 * @param category The category (or @c NULL). | |
66 * @param format The format string. | |
67 * @param args The format parameters. | |
68 * | |
69 * @see gaim_debug() | |
70 */ | |
71 void gaim_debug_vargs(GaimDebugLevel level, const char *category, | |
72 const char *format, va_list args); | |
73 | |
74 /** | |
75 * Outputs debug information. | |
76 * | |
77 * @param level The debug level. | |
78 * @param category The category (or @c NULL). | |
79 * @param format The format string. | |
80 */ | |
81 void gaim_debug(GaimDebugLevel level, const char *category, | |
82 const char *format, ...); | |
83 | |
84 /** | |
85 * Outputs debug information. | |
86 * | |
87 * @deprecated This has been replaced with gaim_debug(), and will be | |
88 * removed in a future release. | |
89 * | |
90 * @param fmt The format string. | |
91 * | |
92 * @see gaim_debug() | |
93 */ | |
94 void debug_printf(const char *fmt, ...); | |
95 | |
5944
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
96 /*@}*/ |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
97 |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
98 /**************************************************************************/ |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
99 /** @name UI Registration Functions */ |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
100 /**************************************************************************/ |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
101 /*@{*/ |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
102 |
5212 | 103 /** |
104 * Sets the UI operations structure to be used when outputting debug | |
105 * information. | |
106 * | |
107 * @param ops The UI operations structure. | |
108 */ | |
109 void gaim_set_debug_ui_ops(GaimDebugUiOps *ops); | |
110 | |
111 /** | |
112 * Returns the UI operations structure used when outputting debug | |
113 * information. | |
114 * | |
115 * @return The UI operations structure in use. | |
116 */ | |
117 GaimDebugUiOps *gaim_get_debug_ui_ops(void); | |
118 | |
5944
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
119 /*@}*/ |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
120 |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
121 #ifdef __cplusplus |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
122 } |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
123 #endif |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5212
diff
changeset
|
124 |
5212 | 125 #endif /* _GAIM_DEBUG_H_ */ |