[gtk+/gtk-2-18] Document clears_as_native and make the name more descriptive

[Alexander Larsson <alexl src gnome org>]

commit ace51e1426756b2b1fbeaf21eebaf88eb435a2e1
Author: Alexander Larsson <alexl redhat com>
Date:   Wed Nov 4 14:01:36 2009 +0100

    Document clears_as_native and make the name more descriptive
    (cherry picked from commit 9ae0d9a44f785564a9b100a58b34a9dcabf61724)

 gdk/gdkwindow.c |    8 ++++++--
 1 files changed, 6 insertions(+), 2 deletions(-)
---
diff --git a/gdk/gdkwindow.c b/gdk/gdkwindow.c
index d1d5331..6d76032 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);