From: Benjamin Otte Date: Fri, 23 Dec 2022 05:49:10 +0000 (+0100) Subject: alertdialog: Rephrase docs for show() a bit X-Git-Tag: archive/raspbian/4.12.3+ds-1+rpi1~1^2^2^2~22^2~9^2~2^2~1 X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=c4c747d2addaddf5000e2c23ef3be5c83e9233b6;p=gtk4.git alertdialog: Rephrase docs for show() a bit In particular, discuss what to do about cancellables. Related: !5326 --- diff --git a/gtk/gtkalertdialog.c b/gtk/gtkalertdialog.c index d4e0512a16..33ccac37d9 100644 --- a/gtk/gtkalertdialog.c +++ b/gtk/gtkalertdialog.c @@ -755,11 +755,13 @@ gtk_alert_dialog_choose_finish (GtkAlertDialog *self, * @self: a `GtkAlertDialog` * @parent: (nullable): the parent `GtkWindow` * - * This function shows the alert to the user. + * Show the alert to the user. * - * If the alert has more than one button, you should use - * [method@Gtk.AlertDialog.choose] instead and provide - * a callback that can react to the button that was clicked. + * This function is a simple version of [method@Gtk.AlertDialog.choose] + * intended for dialogs with a single button. + * If you want to cancel the dialog or if the alert has more than one button, + * you should use that function instead and provide it with a #GCancellable or + * callback respectively. * * Since: 4.10 */