Mercurial > pidgin

changeset 21385:821dc8ba9e3f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Document that callbacks for mini-dialogs may be NULL.
author Will Thompson <will.thompson@collabora.co.uk>
date Wed, 31 Oct 2007 15:17:09 +0000
parents 5c26dc790c71
children 86b0dc1f60ae
files pidgin/gtkutils.h
diffstat 1 files changed, 5 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/pidgin/gtkutils.h	Wed Oct 31 00:57:26 2007 +0000
+++ b/pidgin/gtkutils.h	Wed Oct 31 15:17:09 2007 +0000
@@ -616,7 +616,11 @@
  *                       <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