# HG changeset patch
# User Mark Doliner <mark@kingant.net>
# Date 1281115240 0
# Node ID 3f503c81de769f79eaa221e8ec0d6bf6cdd8f73f
# Parent  5b22fbb5f38854d2327c07f24aee9c9d400672fe
Correct and clarify some documentation

diff -r 5b22fbb5f388 -r 3f503c81de76 libpurple/debug.h
--- a/libpurple/debug.h	Tue Aug 03 16:33:04 2010 +0000
+++ b/libpurple/debug.h	Fri Aug 06 17:20:40 2010 +0000
@@ -176,20 +176,24 @@
 gboolean purple_debug_is_verbose(void);
 
 /**
- * Enable or disable verbose debugging.  This ordinarily should only be called
+ * Enable or disable unsafe debugging.  This ordinarily should only be called
  * by #purple_debug_init, but there are cases where this can be useful for
  * plugins.
  *
- * @param unsafe  TRUE to enable verbose debugging or FALSE to disable it.
+ * @param unsafe TRUE to enable debug logging of messages that could
+ *        potentially contain passwords and other sensitive information.
+ *        FALSE to disable it.
  *
  * @since 2.6.0
  */
 void purple_debug_set_unsafe(gboolean unsafe);
 
 /**
- * Check if unsafe debugging is enabled.
+ * Check if unsafe debugging is enabled.  Defaults to FALSE.
  *
- * @return TRUE if verbose debugging is enabled, FALSE if it is not.
+ * @return TRUE if the debug logging of all messages is enabled, FALSE
+ *         if messages that could potentially contain passwords and other
+ *         sensitive information are not logged.
  *
  * @since 2.6.0
  */