[gtk+/gtk-3-8] Clarify GtkH/VBox documentation

[Matthias Clasen <matthiasc src gnome org>]

commit 124e43d078d787c304abf8811d9286e917d7510e
Author: Matthias Clasen <mclasen redhat com>
Date:   Mon Sep 16 22:38:49 2013 -0400

    Clarify GtkH/VBox documentation
    
    Make it clearer that GtkBox still has uses.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=706269

 gtk/deprecated/gtkhbox.c |    8 ++++----
 gtk/deprecated/gtkvbox.c |    8 ++++----
 2 files changed, 8 insertions(+), 8 deletions(-)
---
diff --git a/gtk/deprecated/gtkhbox.c b/gtk/deprecated/gtkhbox.c
index 16d1a63..56966fb 100644
--- a/gtk/deprecated/gtkhbox.c
+++ b/gtk/deprecated/gtkhbox.c
@@ -49,10 +49,10 @@
  * from #GtkBox. No further changes are needed, since the default
  * value of the #GtkOrientable:orientation property is
  * %GTK_ORIENTATION_HORIZONTAL.
- * If you want your code to be future-proof, the recommendation is to
- * switch to #GtkGrid, since #GtkBox is going to be deprecated in favor
- * of the more flexible grid widget eventually. For more information
- * about migrating to #GtkGrid, see <xref linkend="gtk-migrating-GtkGrid"/>
+ * If you don't need first-child or last-child styling, and want your code
+ * to be future-proof, the recommendation is to switch to #GtkGrid instead
+ * of nested boxes. For more information about migrating to #GtkGrid,
+ * see <xref linkend="gtk-migrating-GtkGrid"/>
  */
 
 
diff --git a/gtk/deprecated/gtkvbox.c b/gtk/deprecated/gtkvbox.c
index 6428be1..f2d5299 100644
--- a/gtk/deprecated/gtkvbox.c
+++ b/gtk/deprecated/gtkvbox.c
@@ -54,10 +54,10 @@
  *   gtk_orientable_set_orientation (GTK_ORIENTABLE (object),
  *                                   GTK_ORIENTATION_VERTICAL);
  * ]|
- * If you want your code to be future-proof, the recommendation is to
- * switch to #GtkGrid, since #GtkBox is going to be deprecated in favor
- * of the more flexible grid widget eventually. For more information
- * about migrating to #GtkGrid, see <xref linkend="gtk-migrating-GtkGrid"/>.
+ * If you don't need first-child or last-child styling and want your code
+ * to be future-proof, the recommendation is to switch to #GtkGrid instead
+ * of nested boxes. For more information about migrating to #GtkGrid,
+ * see <xref linkend="gtk-migrating-GtkGrid"/>.
  */
 
 G_DEFINE_TYPE (GtkVBox, gtk_vbox, GTK_TYPE_BOX)