comparison libpurple/debug.h @ 32819:2c6510167895 default tip

propagate from branch 'im.pidgin.pidgin.2.x.y' (head 3315c5dfbd0ad16511bdcf865e5b07c02d07df24) to branch 'im.pidgin.pidgin' (head cbd1eda6bcbf0565ae7766396bb8f6f419cb6a9a)
author Elliott Sales de Andrade <qulogic@pidgin.im>
date Sat, 02 Jun 2012 02:30:49 +0000
parents 98520ee78f12
children
comparison
equal deleted inserted replaced
32818:01ff09d4a463 32819:2c6510167895
57 void (*_purple_reserved2)(void); 57 void (*_purple_reserved2)(void);
58 void (*_purple_reserved3)(void); 58 void (*_purple_reserved3)(void);
59 void (*_purple_reserved4)(void); 59 void (*_purple_reserved4)(void);
60 } PurpleDebugUiOps; 60 } PurpleDebugUiOps;
61 61
62 #ifdef __cplusplus 62 G_BEGIN_DECLS
63 extern "C" {
64 #endif
65 63
66 /**************************************************************************/ 64 /**************************************************************************/
67 /** @name Debug API */ 65 /** @name Debug API */
68 /**************************************************************************/ 66 /**************************************************************************/
69 /** 67 /**
159 * Enable or disable verbose debugging. This ordinarily should only be called 157 * Enable or disable verbose debugging. This ordinarily should only be called
160 * by #purple_debug_init, but there are cases where this can be useful for 158 * by #purple_debug_init, but there are cases where this can be useful for
161 * plugins. 159 * plugins.
162 * 160 *
163 * @param verbose TRUE to enable verbose debugging or FALSE to disable it. 161 * @param verbose TRUE to enable verbose debugging or FALSE to disable it.
164 *
165 * @since 2.6.0
166 */ 162 */
167 void purple_debug_set_verbose(gboolean verbose); 163 void purple_debug_set_verbose(gboolean verbose);
168 164
169 /** 165 /**
170 * Check if verbose logging is enabled. 166 * Check if verbose logging is enabled.
171 * 167 *
172 * @return TRUE if verbose debugging is enabled, FALSE if it is not. 168 * @return TRUE if verbose debugging is enabled, FALSE if it is not.
173 *
174 * @since 2.6.0
175 */ 169 */
176 gboolean purple_debug_is_verbose(void); 170 gboolean purple_debug_is_verbose(void);
177 171
178 /** 172 /**
179 * Enable or disable unsafe debugging. This ordinarily should only be called 173 * Enable or disable unsafe debugging. This ordinarily should only be called
181 * plugins. 175 * plugins.
182 * 176 *
183 * @param unsafe TRUE to enable debug logging of messages that could 177 * @param unsafe TRUE to enable debug logging of messages that could
184 * potentially contain passwords and other sensitive information. 178 * potentially contain passwords and other sensitive information.
185 * FALSE to disable it. 179 * FALSE to disable it.
186 *
187 * @since 2.6.0
188 */ 180 */
189 void purple_debug_set_unsafe(gboolean unsafe); 181 void purple_debug_set_unsafe(gboolean unsafe);
190 182
191 /** 183 /**
192 * Check if unsafe debugging is enabled. Defaults to FALSE. 184 * Check if unsafe debugging is enabled. Defaults to FALSE.
193 * 185 *
194 * @return TRUE if the debug logging of all messages is enabled, FALSE 186 * @return TRUE if the debug logging of all messages is enabled, FALSE
195 * if messages that could potentially contain passwords and other 187 * if messages that could potentially contain passwords and other
196 * sensitive information are not logged. 188 * sensitive information are not logged.
197 *
198 * @since 2.6.0
199 */ 189 */
200 gboolean purple_debug_is_unsafe(void); 190 gboolean purple_debug_is_unsafe(void);
201 191
202 /*@}*/ 192 /*@}*/
203 193
234 */ 224 */
235 void purple_debug_init(void); 225 void purple_debug_init(void);
236 226
237 /*@}*/ 227 /*@}*/
238 228
239 #ifdef __cplusplus 229 G_END_DECLS
240 }
241 #endif
242 230
243 #endif /* _PURPLE_DEBUG_H_ */ 231 #endif /* _PURPLE_DEBUG_H_ */