[gtk+/gtk-3-10] Improve gtk_container_add docs

[Matthias Clasen <matthiasc src gnome org>]

commit 89c3585eccee4698560fd2663cbfef47f899ec4b
Author: Matthias Clasen <mclasen redhat com>
Date:   Mon Sep 30 20:53:19 2013 -0400

    Improve gtk_container_add docs
    
    Mention that some containers add intermediate children automatically.

 gtk/gtkcontainer.c |    6 +++++-
 1 files changed, 5 insertions(+), 1 deletions(-)
---
diff --git a/gtk/gtkcontainer.c b/gtk/gtkcontainer.c
index b3b1094..82fda08 100644
--- a/gtk/gtkcontainer.c
+++ b/gtk/gtkcontainer.c
@@ -1520,7 +1520,11 @@ gtk_container_get_border_width (GtkContainer *container)
  * gtk_grid_attach() as an alternative to gtk_container_add() in
  * those cases. A widget may be added to only one container at a time;
  * you can't place the same widget inside two different containers.
- **/
+ *
+ * Note that some containers, such as #GtkScrolledWindow or #GtkListBox,
+ * may add intermediate children between the added widget and the
+ * container.
+ */
 void
 gtk_container_add (GtkContainer *container,
                    GtkWidget    *widget)