# HG changeset patch
# User Stu Tomlinson <stu@nosnilmot.com>
# Date 1189784391 0
# Node ID 1691f4c9b6a82379294a9108fa5334c9a5814c96
# Parent  b88747698e968053c08d25a00ef7c4a9d3507a24# Parent  ba649e93098b3fb38079a8618e7879b2fef9f616
merge of '507542b421b5b1da79e4b5a2624a5f768e2683e3'
     and 'ef6f42907128e792c95b8f7d47c90105f35f20c2'

diff -r ba649e93098b -r 1691f4c9b6a8 libpurple/accountopt.h
--- a/libpurple/accountopt.h	Fri Sep 14 15:38:40 2007 +0000
+++ b/libpurple/accountopt.h	Fri Sep 14 15:39:51 2007 +0000
@@ -49,8 +49,10 @@
 
 	} default_value;
 
-	gboolean masked;
-
+	gboolean masked;        /**< Whether the value entered should be
+	                         *   obscured from view (for passwords and
+	                         *   similar options)
+	                         */
 } PurpleAccountOption;
 
 /**
@@ -184,10 +186,12 @@
 											const char *value);
 
 /**
- * Sets the masking for an account option.
+ * Sets the masking for an account option. Setting this to %TRUE acts
+ * as a hint to the UI that the option's value should be obscured from
+ * view, like a password.
  *
  * @param option The account option.
- * @param masked  The masking.
+ * @param masked The masking.
  */
 void
 purple_account_option_set_masked(PurpleAccountOption *option, gboolean masked);
@@ -282,11 +286,13 @@
 	const PurpleAccountOption *option);
 
 /**
- * Returns the masking for an account option.
+ * Returns whether an option's value should be masked from view, like a
+ * password.  If so, the UI might display each character of the option
+ * as a '*' (for example).
  *
  * @param option The account option.
  *
- * @return The masking.
+ * @return %TRUE if the option's value should be obscured.
  */
 gboolean
 purple_account_option_get_masked(const PurpleAccountOption *option);