[gtk+] Move GtkMenuBar docs inline

[Matthias Clasen <matthiasc src gnome org>]

commit 9d85d87f0561ce2af3c72d7b9bb787b958a97e30
Author: Matthias Clasen <mclasen redhat com>
Date:   Thu Jan 13 22:11:22 2011 -0500

    Move GtkMenuBar docs inline
    
    And remove some outdated content.

 docs/reference/gtk/tmpl/.gitignore      |    1 +
 docs/reference/gtk/tmpl/gtkmenubar.sgml |  104 -------------------------------
 gtk/gtkenums.h                          |   10 +++
 gtk/gtkmenubar.c                        |   18 +++++
 4 files changed, 29 insertions(+), 104 deletions(-)
---
diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 1249f4d..ebc9d6b 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -34,6 +34,7 @@ gtkitemfactory.sgml
 gtklayout.sgml
 gtklinkbutton.sgml
 gtkmain.sgml
+gtkmenubar.sgml
 gtkmessagedialog.sgml
 gtknotebook.sgml
 gtkobject.sgml
diff --git a/gtk/gtkenums.h b/gtk/gtkenums.h
index d146359..76ea885 100644
--- a/gtk/gtkenums.h
+++ b/gtk/gtkenums.h
@@ -648,6 +648,16 @@ typedef enum
   GTK_IM_STATUS_NONE
 } GtkIMStatusStyle;
 
+/**
+ * GtkPackDirection:
+ * @GTK_PACK_DIRECTION_LTR: Widgets are packed left-to-right
+ * @GTK_PACK_DIRECTION_RTL: Widgets are packed right-to-left
+ * @GTK_PACK_DIRECTION_TTB: Widgets are packed top-to-bottom
+ * @GTK_PACK_DIRECTION_BTT: Widgets are packed bottom-to-top
+ *
+ * Determines how widgets should be packed insided menubars
+ * and menuitems contained in menubars.
+ */
 typedef enum
 {
   GTK_PACK_DIRECTION_LTR,
diff --git a/gtk/gtkmenubar.c b/gtk/gtkmenubar.c
index 42f2f25..b35ec0c 100644
--- a/gtk/gtkmenubar.c
+++ b/gtk/gtkmenubar.c
@@ -24,6 +24,17 @@
  * GTK+ at ftp://ftp.gtk.org/pub/gtk/. 
  */
 
+/**
+ * SECTION:gtkmenubar
+ * @Title: GtkMenuBar
+ * @Short_description: A subclass of GtkMenuShell which holds GtkMenuItem widgets
+ * @See_also: #GtkMenuShell, #GtkMenu, #GtkMenuItem
+ *
+ * The #GtkMenuBar is a subclass of #GtkMenuShell which contains one or
+ * more #GtkMenuItems. The result is a standard menu bar which can hold
+ * many menu items.
+ */
+
 #include "config.h"
 
 #include "gtkmenubar.h"
@@ -224,6 +235,13 @@ gtk_menu_bar_init (GtkMenuBar *menu_bar)
   gtk_style_context_add_class (context, GTK_STYLE_CLASS_MENUBAR);
 }
 
+/**
+ * gtk_menu_bar_new:
+ *
+ * Creates a new #GtkMenuBar
+ *
+ * Returns: the new menu bar, as a #GtkWidget
+ */
 GtkWidget*
 gtk_menu_bar_new (void)
 {