[gtkmm] Replace deprecated classes in comments.

[Kjell Ahlstedt <kjellahl src gnome org>]

commit b206905b2bdfbb4b6b1fcd48854acc335088f50f
Author: Kjell Ahlstedt <kjell ahlstedt bredband net>
Date:   Mon Jul 15 15:25:00 2013 +0200

    Replace deprecated classes in comments.
    
    * gtk/src/bin.hg: Replace HBox by horizontal Box.
    * gtk/src/dialog.hg: Replace VBox by vertical Box.
    * gtk/src/builder.hg:
    * gtk/src/scrolledwindow.hg:
    * gtk/src/sizegroup.hg: Replace Table by Grid.
    * gtk/src/hvseparator.hg: Add @deprecated Doxygen command.
    * gtk/src/filechooserbutton.hg:
    * gtk/src/infobar.hg:
    * gtk/src/statusbar.hg: Mention that the C object derives from GtkBox.

 gtk/src/bin.hg               |    8 ++++----
 gtk/src/builder.hg           |    4 ++--
 gtk/src/dialog.hg            |    4 ++--
 gtk/src/filechooserbutton.hg |    2 +-
 gtk/src/hvseparator.hg       |    4 ++++
 gtk/src/infobar.hg           |    2 +-
 gtk/src/scrolledwindow.hg    |    4 ++--
 gtk/src/sizegroup.hg         |    2 +-
 gtk/src/statusbar.hg         |    2 +-
 9 files changed, 18 insertions(+), 14 deletions(-)
---
diff --git a/gtk/src/bin.hg b/gtk/src/bin.hg
index 6b3dff1..dee93e5 100644
--- a/gtk/src/bin.hg
+++ b/gtk/src/bin.hg
@@ -91,8 +91,8 @@ public:
   /* Add Image and Label objects.
    * This does not correspond to any GTK+ function and is provided purely for
    * convenience.
-   * This will create, manage, add, and show a new Image and Label (within an
-   * HBox) to this Bin.
+   * This will create, manage, add, and show a new Image and Label (within a
+   * horizontal Box) to this Bin.
    * @param pixmap A Glib::RefPtr to a Gdk::Pixmap.
    * @param mask A Glib::RefPtr to a Gdk::Bitmap.
    * @param label The text for the label.
@@ -109,8 +109,8 @@ public:
   /** Add Image and Label objects.
    * This does not correspond to any GTK+ function and is provided purely for
    * convenience.
-   * This will create, manage, add, and show a new Image and Label (within an
-   * HBox) to this Bin.
+   * This will create, manage, add, and show a new Image and Label (within a
+   * horizontal Box) to this Bin.
    * @param pixfile The path to a file to be displayed.
    * @param label The text for the label.
    * @param x_align The horizontal alignment of the text in the label.
diff --git a/gtk/src/builder.hg b/gtk/src/builder.hg
index e1e6762..638d8e1 100644
--- a/gtk/src/builder.hg
+++ b/gtk/src/builder.hg
@@ -402,8 +402,8 @@ public:
   /** Get a widget from the Builder file.
    * For instance:
    * @code
-   * Gtk::Table* pTable = 0;
-   * refXml->get_widget("mytable", pTable);
+   * Gtk::Grid* pGrid = 0;
+   * refXml->get_widget("mygrid", pGrid);
    * @endcode
    * This method prints a warning message to the console if the widget
    * doesn't exist or has the wrong type, so you don't need to check that
diff --git a/gtk/src/dialog.hg b/gtk/src/dialog.hg
index 37425c6..526c61d 100644
--- a/gtk/src/dialog.hg
+++ b/gtk/src/dialog.hg
@@ -42,10 +42,10 @@ _WRAP_ENUM(ResponseType, GtkResponseType)
  * does not require extensive effort on the user's part.
  *
  * gtkmm treats a dialog as a window split vertically. The top section is a
- * Gtk::VBox, and is where widgets such as a Gtk::Label or a Gtk::Entry should be
+ * vertical Gtk::Box, and is where widgets such as a Gtk::Label or a Gtk::Entry should be
  * packed. The bottom area is known as the action_area. This is generally
  * used for packing buttons into the dialog which may perform functions such
- * as cancel, ok, or apply. The two areas are separated by a Gtk::HSeparator.
+ * as cancel, ok, or apply.
  *
  * The dialog can be 'modal' (that is, one which freezes the rest of the
  * application from user input) - this can be specified in the Gtk::Dialog
diff --git a/gtk/src/filechooserbutton.hg b/gtk/src/filechooserbutton.hg
index 788c122..190dfc1 100644
--- a/gtk/src/filechooserbutton.hg
+++ b/gtk/src/filechooserbutton.hg
@@ -43,7 +43,7 @@ namespace Gtk
  * @ingroup Widgets
  */
 class FileChooserButton
-  : public HBox, //Note: The C object really derives from this convenience type.
+  : public HBox, //Note: The C object derives from GtkBox.
     public FileChooser
 {
   _CLASS_GTKOBJECT(FileChooserButton, GtkFileChooserButton, GTK_FILE_CHOOSER_BUTTON, Gtk::HBox, GtkHBox)
diff --git a/gtk/src/hvseparator.hg b/gtk/src/hvseparator.hg
index fbbe69c..95835cb 100644
--- a/gtk/src/hvseparator.hg
+++ b/gtk/src/hvseparator.hg
@@ -38,6 +38,8 @@ namespace Gtk
  * @image html vseparator1.png
  *
  * @ingroup Widgets
+ *
+ * @deprecated Use Separator instead.
  */
 class VSeparator : public Separator
 {
@@ -58,6 +60,8 @@ public:
  * @image html hseparator1.png
  *
  * @ingroup Widgets
+ *
+ * @deprecated Use Separator instead.
  */
 class HSeparator : public Separator
 {
diff --git a/gtk/src/infobar.hg b/gtk/src/infobar.hg
index 3b79aac..239048e 100644
--- a/gtk/src/infobar.hg
+++ b/gtk/src/infobar.hg
@@ -47,7 +47,7 @@ namespace Gtk
  *
  * @ingroup Widgets
  */
-class InfoBar : public HBox //Note: The C object really derives from this convenience type.
+class InfoBar : public HBox //Note: The C object derives from GtkBox.
 {
   _CLASS_GTKOBJECT(InfoBar, GtkInfoBar, GTK_INFO_BAR, Gtk::HBox, GtkHBox)
 public:
diff --git a/gtk/src/scrolledwindow.hg b/gtk/src/scrolledwindow.hg
index 10fa2f1..4a3ded3 100644
--- a/gtk/src/scrolledwindow.hg
+++ b/gtk/src/scrolledwindow.hg
@@ -32,7 +32,7 @@ class Scrollbar;
  * The scrolled window can work in two ways:
  * <OL>
  * <LI>Some widgets have native scrolling support; these widgets handle certain Gtk::Adjustment signals. 
Widgets with native scroll support include Gtk::TreeView, Gtk::TextView, and Gtk::Layout.</LI>
- * <LI>For widgets that lack native scrolling support, such as Gtk::Table, Gtk::Box, and so on, the widget 
will be placed inside a Gtk::Viewport.</LI>
+ * <LI>For widgets that lack native scrolling support, such as Gtk::Grid, Gtk::Box, and so on, the widget 
will be placed inside a Gtk::Viewport.</LI>
  * </OL>
  *
  * The position of the scrollbars is controlled by the scroll adjustments. See Gtk::Adjustment for the 
fields in an adjustment - for Gtk::Scrollbar, used by Gtk::ScrolledWindow,
@@ -40,7 +40,7 @@ class Scrollbar;
  * The "page_size" field represents the size of the visible scrollable area.
  * The "step_increment" and "page_increment" fields are used when the user asks to step down (using the 
small stepper arrows) or page down (using for example the PageDown key).
  *
- * If a Gtk::ScrolledWindow doesn't behave quite as you would like, or doesn't have exactly the right 
layout, it's very possible to set up your own scrolling with Gtk::Scrollbar and, for example, a Gtk::Table.
+ * If a Gtk::ScrolledWindow doesn't behave quite as you would like, or doesn't have exactly the right 
layout, it's very possible to set up your own scrolling with Gtk::Scrollbar and, for example, a Gtk::Grid.
  *
  * @ingroup Widgets
  * @ingroup Containers
diff --git a/gtk/src/sizegroup.hg b/gtk/src/sizegroup.hg
index 3b5852c..839a238 100644
--- a/gtk/src/sizegroup.hg
+++ b/gtk/src/sizegroup.hg
@@ -31,7 +31,7 @@ _CC_INCLUDE(gtk/gtk.h)
 _WRAP_ENUM(SizeGroupMode, GtkSizeGroupMode)
 
 /** Gtk::SizeGroup provides a mechanism for grouping a number of widgets together so they all request the 
same amount of space.
- * This is typically useful when you want a column of widgets to have the same size, but you can't use a 
Gtk::Table widget.
+ * This is typically useful when you want a column of widgets to have the same size, but you can't use a 
Gtk::Grid widget.
  *
  * In detail, the size requested for each widget in a Gtk::SizeGroup is the maximum of the sizes that would 
have been
  * requested for each widget in the size group if they were not in the size group. The mode of the size 
group (see
diff --git a/gtk/src/statusbar.hg b/gtk/src/statusbar.hg
index 76ba399..e3ae4a2 100644
--- a/gtk/src/statusbar.hg
+++ b/gtk/src/statusbar.hg
@@ -38,7 +38,7 @@ namespace Gtk
  *
  * @ingroup Widgets
  */
-class Statusbar : public HBox //Note: The C object really derives from this convenience type.
+class Statusbar : public HBox //Note: The C object derives from GtkBox.
 {
   _CLASS_GTKOBJECT(Statusbar,GtkStatusbar,GTK_STATUSBAR,Gtk::HBox,GtkHBox)
   _IGNORE(gtk_statusbar_push)