im.pidgin.cpw.resiak.disconnectreason: 47fda7b123eae2b717ca991138186a53e6336d44

[resiak at soc.pidgin.im]

-----------------------------------------------------------------
Revision: 47fda7b123eae2b717ca991138186a53e6336d44
Ancestor: d05eabc3d9cb0afe1d98c462f6e5aa5fa0f20b0d
Author: resiak at soc.pidgin.im
Date: 2007-10-31T15:17:09
Branch: im.pidgin.cpw.resiak.disconnectreason

Modified files:
        pidgin/gtkutils.h

ChangeLog: 

Document that callbacks for mini-dialogs may be NULL.

-------------- next part --------------
============================================================
--- pidgin/gtkutils.h	d57d55835c907195041eb18b37e8feb9986fa983
+++ pidgin/gtkutils.h	1b8453a2a37b4351d32ef44f42fe500357dceff1
@@ -616,7 +616,11 @@ char *pidgin_make_pretty_arrows(const ch
  *                       <tt>void *</tt> argument, as which @a user_data will
  *                       be passed.  (Strictly speaking a <tt>GtkButton *</tt>
  *                       will be passed as the second argument, but it can
- *                       safely be omitted.)
+ *                       safely be omitted.)  When a button is pressed, the
+ *                       callback will be called; when the callback returns the
+ *                       dialog will evaporate.  Callbacks may be @c NULL, in
+ *                       which case pressing the corresponding button simply
+ *                       dismisses the dialog.
  * @return               A <tt>GtkWidget *</tt> suitable for passing to
  *                       pidgin_blist_add_alert().
  * @see pidginstock.h