Document clears_as_native and make the name more descriptive

(cherry picked from commit 9ae0d9a44f785564a9b100a58b34a9dcabf61724)

1 files changed, 6 insertions, 2 deletions

diff --git a/gdk/gdkwindow.c b/gdk/gdkwindow.c
index d1d5331df..6d7603263 100644
--- a/gdk/gdkwindow.c
+++ b/gdk/gdkwindow.c
@@ -4389,8 +4389,12 @@ gdk_window_clear (GdkWindow *window)
 			 width, height);
 }
 
+/* TRUE if the window clears to the same pixels as a native
+   window clear. This means you can use the native window
+   clearing operation, and additionally it means any clearing
+   done by the native window system for you will already be right */
 static gboolean
-clears_on_native (GdkWindowObject *private)
+clears_as_native (GdkWindowObject *private)
 {
   GdkWindowObject *next;
 
@@ -4424,7 +4428,7 @@ gdk_window_clear_region_internal (GdkWindow *window,
 
       impl_iface = GDK_WINDOW_IMPL_GET_IFACE (private->impl);
 
-      if (impl_iface->clear_region && clears_on_native (private))
+      if (impl_iface->clear_region && clears_as_native (private))
 	{
 	  GdkRegion *copy;
 	  copy = gdk_region_copy (region);