Mention cairo_save/restore in the ::draw migration docs

https://bugzilla.gnome.org/show_bug.cgi?id=646798

diff --git a/docs/reference/gtk/migrating-2to3.xml b/docs/reference/gtk/migrating-2to3.xml
index 33d227557ad0407a6464ec4f2d7c67780bd5811c..9db760ae0073d161ebd4b7b7725073f333f51221 100644 (file)
--- a/docs/reference/gtk/migrating-2to3.xml
+++ b/docs/reference/gtk/migrating-2to3.xml
@@ -1001,7 +1001,8 @@ AM_CONDITIONAL(BUILD_x11, [test "x$have_x11" = "xyes"])
       Another convenience function that can help when implementing
       ::draw for multi-window widgets is gtk_cairo_transform_to_window(),
       which transforms a cairo context from widget-relative coordinates
-      to window-relative coordinates.
+      to window-relative coordinates. You may want to use cairo_save() and
+      cairo_restore() when modifying the cairo context in your draw function.
     </para>
     <para>
       All GtkStyle drawing functions (gtk_paint_box(), etc) have been changed