[gtk+] gtk[h/v]box: Recommend the use of GtkGrid.

[Javier Jardón <jjardon src gnome org>]

commit 17ae6b2e0d745b47758583684ed36cf456f2fb4c
Author: Javier Jardón <jjardon gnome org>
Date:   Wed Jun 8 13:25:54 2011 +0100

    gtk[h/v]box: Recommend the use of GtkGrid.

 gtk/gtkhbox.c |   10 ++++++++--
 gtk/gtkvbox.c |   10 ++++++++--
 2 files changed, 16 insertions(+), 4 deletions(-)
---
diff --git a/gtk/gtkhbox.c b/gtk/gtkhbox.c
index cade454..dd6cd29 100644
--- a/gtk/gtkhbox.c
+++ b/gtk/gtkhbox.c
@@ -44,7 +44,10 @@
  *
  * All children are allocated the same height.
  *
- * GtkHBox has been deprecated, use #GtkBox instead.
+ * GtkHBox has been deprecated, you can use #GtkBox instead, which is a very
+ * quick and easy change. But the recommendation is to switch to #GtkGrid, since
+ * #GtkBox is going to go away eventually.
+ * See <xref linkend="gtk-migrating-GtkGrid"/>
  */
 
 
@@ -73,7 +76,10 @@ gtk_hbox_init (GtkHBox *hbox)
  *
  * Returns: a new #GtkHBox.
  *
- * Deprecated: 3.2: Use gtk_box_new() with %GTK_ORIENTATION_HORIZONTAL instead
+ * Deprecated: 3.2: You can use gtk_box_new() with %GTK_ORIENTATION_HORIZONTAL instead,
+ *   wich is a very quick and easy change. But the recommendation is to switch to
+ *   #GtkGrid, since #GtkBox is going to go away eventually.
+ *   See <xref linkend="gtk-migrating-GtkGrid"/>.
  */
 GtkWidget *
 gtk_hbox_new (gboolean homogeneous,
diff --git a/gtk/gtkvbox.c b/gtk/gtkvbox.c
index f7f91f6..ea05e99 100644
--- a/gtk/gtkvbox.c
+++ b/gtk/gtkvbox.c
@@ -44,7 +44,10 @@
  *
  * All children are allocated the same width.
  *
- * GtkVBox has been deprecated, use #GtkBox instead.
+ * GtkVBox has been deprecated, you can use #GtkBox instead, which is a very
+ * quick and easy change. But the recommendation is to switch to #GtkGrid, since
+ * #GtkBox is going to go away eventually.
+ * See <xref linkend="gtk-migrating-GtkGrid"/>
  */
 
 G_DEFINE_TYPE (GtkVBox, gtk_vbox, GTK_TYPE_BOX)
@@ -72,7 +75,10 @@ gtk_vbox_init (GtkVBox *vbox)
  *
  * Returns: a new #GtkVBox.
  *
- * Deprecated: 3.2: Use gtk_box_new() with %GTK_ORIENTATION_VERTICAL instead
+ * Deprecated: 3.2: You can use gtk_box_new() with %GTK_ORIENTATION_VERTICAL instead,
+ *   wich is a very quick and easy change. But the recommendation is to switch to
+ *   #GtkGrid, since #GtkBox is going to go away eventually.
+ *   See <xref linkend="gtk-migrating-GtkGrid"/>.
  */
 GtkWidget *
 gtk_vbox_new (gboolean homogeneous,