summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2022-10-29 13:53:47 -0400
committerMatthias Clasen <mclasen@redhat.com>2022-10-29 15:27:53 -0400
commit9948053cd7e43e09cdcc3942c08d33fc6dc58c62 (patch)
tree13567c05eb01624e8833b0b728030f952edfb9dd /docs
parentf1af8046d0dc225dac57b7762d3216267afa67f2 (diff)
downloadgtk+-9948053cd7e43e09cdcc3942c08d33fc6dc58c62.tar.gz
Deprecate GtkDialog
GtkDialog is too flexible in terms of UI (headerbars vs action bar, etc), and has archaic APIs. It is time to retire it.
Diffstat (limited to 'docs')
-rw-r--r--docs/reference/gtk/migrating-4to5.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/docs/reference/gtk/migrating-4to5.md b/docs/reference/gtk/migrating-4to5.md
index 2025d66304..14c37f70f1 100644
--- a/docs/reference/gtk/migrating-4to5.md
+++ b/docs/reference/gtk/migrating-4to5.md
@@ -89,3 +89,11 @@ There are also equivalents for some of the 'button' widgets:
Like the Chooser interfaces, GtkMessageDialog has been replaced by
a new async API that will be more convenient, in particular for
language binding. The new API is [class@Gtk.AlertDialog].
+
+## GtkDialog is going away
+
+After gtk_dialog_run() was removed, the usefulness of GtkDialog
+is much reduced, and it has awkward, archaice APIs. Therefore,
+it is dropped. The recommended replacement is to just create
+your own window and add buttons as required, either in the header
+or elsewhere.