[gtk+] Improve docs for gtk_widget_reset_style().

[Carlos Garnacho <carlosg src gnome org>]

commit f9ed6baeb46ce07b86ed23fe60eef8e94552f77d
Author: Carlos Garnacho <carlosg gnome org>
Date:   Wed Dec 15 03:33:01 2010 +0100

    Improve docs for gtk_widget_reset_style().
    
    Document that it may be needed in containers when
    children are reordered.

 gtk/gtkwidget.c |    4 +++-
 1 files changed, 3 insertions(+), 1 deletions(-)
---
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 317b45b..05ea17b 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -8689,7 +8689,9 @@ reset_style_recurse (GtkWidget *widget, gpointer data)
  * @widget: a #GtkWidget
  *
  * Updates the style context of @widget and all descendents
- * by updating its widget path.
+ * by updating its widget path. #GtkContainer<!-- -->s may want
+ * to use this on a child when reordering it in a way that a different
+ * style might apply to it. See also gtk_container_get_path_for_child().
  *
  * Since: 3.0
  */