[gtk+/gtk-2-24] ComboBox: Clarify documentation of get_active_iter

[Daniel Boles <dboles src gnome org>]

commit 2166e25f2ef0f75dacc63a046b51e56767e842dc
Author: Daniel Boles <dboles src gnome org>
Date:   Thu Aug 24 12:46:47 2017 +0100

    ComboBox: Clarify documentation of get_active_iter
    
    https://bugzilla.gnome.org/show_bug.cgi?id=618160

 gtk/gtkcombobox.c |   11 ++++++-----
 1 files changed, 6 insertions(+), 5 deletions(-)
---
diff --git a/gtk/gtkcombobox.c b/gtk/gtkcombobox.c
index 1324d98..6271349 100644
--- a/gtk/gtkcombobox.c
+++ b/gtk/gtkcombobox.c
@@ -5188,11 +5188,12 @@ gtk_combo_box_set_active_internal (GtkComboBox *combo_box,
 /**
  * gtk_combo_box_get_active_iter:
  * @combo_box: A #GtkComboBox
- * @iter: (out): The uninitialized #GtkTreeIter
- * 
- * Sets @iter to point to the current active item, if it exists.
- * 
- * Return value: %TRUE, if @iter was set
+ * @iter: (out): A #GtkTreeIter
+ *
+ * Sets @iter to point to the currently active item, if any item is active.
+ * Otherwise, @iter is left unchanged.
+ *
+ * Returns: %TRUE if @iter was set, %FALSE otherwise
  *
  * Since: 2.4
  */