+2007-11-25 Matthias Clasen <mclasen@redhat.com>
+
+ * gtk/gtkdialog.c: Move signal and property documentation inline,
+ fix a problem with the ::response signal docs. (#499133, Josselin
+ Mouette)
+
2007-11-22 15:48:26 Tim Janik <timj@imendio.com>
* Makefile.decl: initialize automake variables EXTRA_DIST and
<!-- ##### SIGNAL GtkDialog::response ##### -->
<para>
-Emitted when an action widget is clicked, the dialog receives a delete event, or
-the application programmer calls gtk_dialog_response(). On a delete event, the
-response ID is #GTK_RESPONSE_NONE. Otherwise, it depends on which action widget
-was clicked.
+
</para>
-@dialog: the object which received the signal.
-@arg1: the response ID
+@dialog:
+@arg1:
<!-- ##### ARG GtkDialog:has-separator ##### -->
<para>
g_type_class_add_private (gobject_class, sizeof (GtkDialogPrivate));
+ /**
+ * GtkDialog:has-separator:
+ *
+ * When %TRUE, the dialog has a separator bar above its buttons.
+ */
g_object_class_install_property (gobject_class,
PROP_HAS_SEPARATOR,
g_param_spec_boolean ("has-separator",
P_("The dialog has a separator bar above its buttons"),
TRUE,
GTK_PARAM_READWRITE));
-
+
+ /**
+ * GtkDialog::response:
+ * @dialog: the object on which the signal is emitted
+ * @response_id: the response ID
+ *
+ * Emitted when an action widget is clicked, the dialog receives a
+ * delete event, or the application programmer calls gtk_dialog_response().
+ * On a delete event, the response ID is #GTK_RESPONSE_DELETE_EVENT.
+ * Otherwise, it depends on which action widget was clicked.
+ */
dialog_signals[RESPONSE] =
g_signal_new (I_("response"),
G_OBJECT_CLASS_TYPE (class),
G_TYPE_NONE, 1,
G_TYPE_INT);
+ /**
+ * GtkDialog::close:
+ *
+ * The ::close signal is a
+ * <link linkend="keybinding-signals">keybinding signal</link>
+ * which getrs emitted when the user uses a keybinding to close
+ * the dialog.
+ *
+ * The default binding for this signal is the Escape key.
+ */
dialog_signals[CLOSE] =
g_signal_new (I_("close"),
G_OBJECT_CLASS_TYPE (class),
binding_set = gtk_binding_set_by_class (class);
- gtk_binding_entry_add_signal (binding_set, GDK_Escape, 0,
- "close", 0);
+ gtk_binding_entry_add_signal (binding_set, GDK_Escape, 0, "close", 0);
}
static void