Mercurial > pidgin.yaz
annotate src/debug.h @ 6065:3a40666c08b4
[gaim-migrate @ 6515]
These be away messages. They don't do nothing that the old away messages
ain't done, but they save themselves in ~/.gaim/status.xml instead of
~/.gaimrc. Astute CVS watchers will have noticed a bit of a trend like that.
So in the future status.xml will have all sorts of cool stuff (I have big plans) but it's kinda boring for now. Also, I should've done this weeks ago. I
should stop being busy.
I'd like to give a shoutout to my boy Rob Flynn, keepin' it real in Atlanta.
You know you my boy, Dawg.
committer: Tailor Script <tailor@pidgin.im>
author | Sean Egan <seanegan@gmail.com> |
---|---|
date | Tue, 08 Jul 2003 23:48:10 +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_ */ |