[gtk+] Add a note to ::fill and ::expand docs

[Matthias Clasen <matthiasc src gnome org>]

commit fb860a9527e2eed805222568fed50294cdc49e3b
Author: Matthias Clasen <mclasen redhat com>
Date:   Mon Jan 31 10:26:28 2011 -0500

    Add a note to ::fill and ::expand docs

 gtk/gtkbox.c |    8 ++++++++
 1 files changed, 8 insertions(+), 0 deletions(-)
---
diff --git a/gtk/gtkbox.c b/gtk/gtkbox.c
index 6292ca8..1ff75eb 100644
--- a/gtk/gtkbox.c
+++ b/gtk/gtkbox.c
@@ -261,6 +261,10 @@ gtk_box_class_init (GtkBoxClass *class)
    * Note that the default value for this property is %FALSE for GtkBox,
    * but #GtkHBox, #GtkVBox and other subclasses use the old default
    * of %TRUE.
+   *
+   * Note that the #GtkWidget:halign, #GtkWidget:valign, #GtkWidget:hexpand
+   * and #GtkWidget:vexpand properties are the preferred way to influence
+   * child size allocation in containers.
    */
   gtk_container_class_install_child_property (container_class,
 					      CHILD_PROP_EXPAND,
@@ -274,6 +278,10 @@ gtk_box_class_init (GtkBoxClass *class)
    * GtkBox:fill:
    *
    * Whether the child should receive extra space when the parent grows.
+   *
+   * Note that the #GtkWidget:halign, #GtkWidget:valign, #GtkWidget:hexpand
+   * and #GtkWidget:vexpand properties are the preferred way to influence
+   * child size allocation in containers.
    */
   gtk_container_class_install_child_property (container_class,
 					      CHILD_PROP_FILL,