Add docs for GtkComboBoxText

(cherry picked from commit 3e9bdf6fd9)

docs/reference/gtk/gtk-docs.sgml

@@ -229,6 +229,7 @@ that is, GUI components such as #GtkButton or #GtkTextView.
     <chapter id="MenusAndCombos">
       <title>Menus, Combo Box, Toolbar</title>
       <xi:include href="xml/gtkcombobox.xml" />
+      <xi:include href="xml/gtkcomboboxtext.xml" />
       <xi:include href="xml/gtkcomboboxentry.xml" />
       <xi:include href="xml/gtkmenu.xml" />
       <xi:include href="xml/gtkmenubar.xml" />

docs/reference/gtk/gtk-sections.txt

@@ -1002,6 +1002,30 @@ gtk_combo_box_entry_get_type
 </SECTION>
 
 <SECTION>
+<FILE>gtkcomboboxtext</FILE>
+<TITLE>GtkComboBoxText</TITLE>
+GtkComboBoxText
+gtk_combo_box_text_new
+gtk_combo_box_text_new_with_entry
+gtk_combo_box_text_append_text
+gtk_combo_box_text_insert_text
+gtk_combo_box_text_prepend_text
+gtk_combo_box_text_remove_text
+gtk_combo_box_text_get_active_text
+
+<SUBSECTION Standard>
+GTK_TYPE_COMBO_BOX_TEXT
+GTK_COMBO_BOX_TEXT
+GTK_IS_COMBO_BOX_TEXT
+GTK_COMBO_BOX_TEXT_CLASS
+GTK_IS_COMBO_BOX_TEXT_CLASS
+GTK_COMBO_BOX_TEXT_GET_CLASS
+
+<SUBSECTION Private>
+GtkComboBoxTextPrivate
+gtk_combo_box_text_get_type
+</SECTION>
+
 <FILE>gtkcontainer</FILE>
 <TITLE>GtkContainer</TITLE>
 GtkContainer

docs/reference/gtk/gtk.types

@@ -43,6 +43,7 @@ gtk_color_selection_get_type
 gtk_combo_box_entry_get_type
 gtk_combo_box_get_type
 gtk_combo_get_type
+gtk_combo_box_text_get_type
 gtk_container_get_type
 gtk_ctree_get_type
 gtk_curve_get_type

gtk/gtkcombobox.c

@@ -57,7 +57,7 @@
  * SECTION:gtkcombobox
  * @Short_description: A widget used to choose from a list of items
  * @Title: GtkComboBox
- * @See_also: #GtkComboBoxEntry, #GtkTreeModel, #GtkCellRenderer
+ * @See_also: #GtkComboBoxText, #GtkTreeModel, #GtkCellRenderer
  *
  * A GtkComboBox is a widget that allows the user to choose from a list of
  * valid choices. The GtkComboBox displays the selected choice. When

gtk/gtkcomboboxtext.c

@@ -25,6 +25,24 @@
 #include "gtkalias.h"
 
 
+/**
+ * SECTION:gtkcomboboxtext
+ * @Short_description: A simple, text-only combo box
+ * @Title: GtkComboBoxText
+ * @See_also: @GtkComboBox
+ *
+ * A GtkComboBoxText is a simple variant of #GtkComboBox that hides
+ * the model-view complexity for simple text-only use cases.
+ *
+ * To create a GtkComboBoxText, use gtk_combo_box_text_new() or
+ * gtk_combo_box_text_new_with_entry().
+ *
+ * You can add items to a GtkComboBoxText with
+ * gtk_combo_box_text_append_text(), gtk_combo_box_text_insert_text()
+ * or gtk_combo_box_text_prepend_text() and remove options with
+ * gtk_combo_box_text_remove_text().
+ */
+
 G_DEFINE_TYPE (GtkComboBoxText, gtk_combo_box_text, GTK_TYPE_COMBO_BOX);
 
 static void