[gtk+] Move documentation to inline comments: GtkHBox

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

commit 3cc9575323b4ca8c6d82572f1bfe3eb23555fdb3
Author: Javier Jardón <jjardon gnome org>
Date:   Wed Apr 28 04:29:41 2010 +0200

    Move documentation to inline comments: GtkHBox

 docs/reference/gtk/tmpl/.gitignore   |    1 +
 docs/reference/gtk/tmpl/gtkhbox.sgml |   49 ----------------------------------
 gtk/gtkhbox.c                        |   25 +++++++++++++++++
 3 files changed, 26 insertions(+), 49 deletions(-)
---
diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index b6d9f7a..a9378ad 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -1,2 +1,3 @@
+gtkhbox.sgml
 gtkmessagedialog.sgml
 gtktesting.sgml
diff --git a/gtk/gtkhbox.c b/gtk/gtkhbox.c
index b917c40..61855f3 100644
--- a/gtk/gtkhbox.c
+++ b/gtk/gtkhbox.c
@@ -30,6 +30,22 @@
 #include "gtkorientable.h"
 #include "gtkalias.h"
 
+
+/**
+ * SECTION:gtkhbox
+ * @Short_description: A horizontal container box
+ * @Title: GtkHBox
+ * @See_also: #GtkVBox
+ *
+ * #GtkHBox is a container that organizes child widgets into a single row.
+ *
+ * Use the #GtkBox packing interface to determine the arrangement,
+ * spacing, width, and alignment of #GtkHBox children.
+ *
+ * All children are allocated the same height.
+ */
+
+
 G_DEFINE_TYPE (GtkHBox, gtk_hbox, GTK_TYPE_BOX)
 
 static void
@@ -46,6 +62,15 @@ gtk_hbox_init (GtkHBox *hbox)
   _gtk_box_set_old_defaults (GTK_BOX (hbox));
 }
 
+/**
+ * gtk_hbox_new:
+ * @homogeneous: %TRUE if all children are to be given equal space allotments.
+ * @spacing: the number of pixels to place by default between children.
+ *
+ * Creates a new #GtkHBox.
+ *
+ * Returns: a new #GtkHBox.
+ */
 GtkWidget *
 gtk_hbox_new (gboolean homogeneous,
 	      gint     spacing)