docs: Mention GdkSurface:mapped

It replaces the ::map-event and ::unmap-event signals on GtkWidget.

diff --git a/docs/reference/gtk/migrating-3to4.md b/docs/reference/gtk/migrating-3to4.md
index 49f3d6c8ddd2bd78ee14974cccf447ee67c0ed91..f286fc72dce19ef80132d5a08bc41b9b6e526e9d 100644 (file)
--- a/docs/reference/gtk/migrating-3to4.md
+++ b/docs/reference/gtk/migrating-3to4.md
@@ -197,6 +197,9 @@ on a one-by-one basis:
  - If you were using `::delete-event` to present a confirmation when using
    the close button of a window, you should use the
    [signal@Gtk.Window::close-request] signal.
+ - If you were using `::map-event` and `::unmap-event` to track a window
+   being mapped, you should use property notification for the
+   [property@Gdk.Surface:mapped] property instead.
 
 ### Set a proper application ID