Describe how gdk_x11_drawable_get_xid() works wrt CSW in docs

diff --git a/docs/reference/gtk/migrating-ClientSideWindows.sgml b/docs/reference/gtk/migrating-ClientSideWindows.sgml
index 488013487add07c3c409d8295825bd1a0e6e6263..96372f79af0e2c32cb77dd7998f2dfcf1c6120a6 100644 (file)
--- a/docs/reference/gtk/migrating-ClientSideWindows.sgml
+++ b/docs/reference/gtk/migrating-ClientSideWindows.sgml
@@ -13,6 +13,9 @@
     longer correct to assume that each window has an associated XID.
     Code that makes this assumption can sometimes be fixed by calling
     gdk_window_ensure_native() on the windows in question.
+    Calling gdk_x11_drawable_get_xid() from the X11-specific API on a
+    non-native window will explicitly call gdk_window_ensure_native(),
+    so old code using this will continue to work.
   </para>
 
   <para>