[gtk+] Clarify GtkH/VBox documentation

[Matthias Clasen <matthiasc src gnome org>]

commit f503d4debdf209ea107348a741ca550aed067459
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 a5fe1a8..5c6b3ca 100644
--- a/gtk/deprecated/gtkhbox.c
+++ b/gtk/deprecated/gtkhbox.c
@@ -50,10 +50,10 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
  * 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 707ccec..7745045 100644
--- a/gtk/deprecated/gtkvbox.c
+++ b/gtk/deprecated/gtkvbox.c
@@ -55,10 +55,10 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
  *   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)