libgimp/gimpdrawablecombobox.c changed the API docs to suggest to use

2004-10-28  Sven Neumann  <sven@gimp.org>

	* libgimp/gimpdrawablecombobox.c
	* libgimp/gimpimagecombobox.c: changed the API docs to suggest to
	use gimp_int_combo_box_connect() with these widgets. We don't want
	more people to be caught by bug #156659.

ChangeLog

+2004-10-28  Sven Neumann  <sven@gimp.org>
+
+	* libgimp/gimpdrawablecombobox.c
+	* libgimp/gimpimagecombobox.c: suggest to use
+	gimp_int_combo_box_connect() with these widgets. We don't want more
+	people to be caught by bug #156659.
+
 2004-10-28  Sven Neumann  <sven@gimp.org>
 	* plug-ins/common/grid.c: fixed a long-standing cut'n'paste bug

libgimp/gimpdrawablecombobox.c

@@ -53,9 +53,10 @@ static gint  gimp_drawable_combo_box_model_add (GtkListStore               *stor
  * each drawable and only if the function returns %TRUE, the drawable
  * is added to the combobox.
  *
- * Use gimp_int_combo_box_set_active() to get the active drawable ID
- * and gimp_int_combo_box_get_active() to retrieve the ID of the
- * selected drawable.
+ * You should use gimp_int_combo_connect() to initialize and connect
+ * the combo.  Use gimp_int_combo_box_set_active() to get the active
+ * drawable ID and gimp_int_combo_box_get_active() to retrieve the ID
+ * of the selected drawable.
  *
  * Return value: a new #GimpIntComboBox.
  *

libgimp/gimpimagecombobox.c

@@ -52,9 +52,10 @@ static void  gimp_image_combo_box_model_add (GtkListStore            *store,
  * each image and only if the function returns %TRUE, the image is
  * added to the combobox.
  *
- * Use gimp_int_combo_box_set_active() to get the active image ID and
- * gimp_int_combo_box_get_active() to retrieve the ID of the selected
- * image.
+ * You should use gimp_int_combo_connect() to initialize and connect
+ * the combo. Use gimp_int_combo_box_set_active() to get the active
+ * image ID and gimp_int_combo_box_get_active() to retrieve the ID of
+ * the selected image.
  *
  * Return value: a new #GimpIntComboBox.
  *

libgimp/gimpitemcombobox.c

@@ -53,9 +53,10 @@ static gint  gimp_drawable_combo_box_model_add (GtkListStore               *stor
  * each drawable and only if the function returns %TRUE, the drawable
  * is added to the combobox.
  *
- * Use gimp_int_combo_box_set_active() to get the active drawable ID
- * and gimp_int_combo_box_get_active() to retrieve the ID of the
- * selected drawable.
+ * You should use gimp_int_combo_connect() to initialize and connect
+ * the combo.  Use gimp_int_combo_box_set_active() to get the active
+ * drawable ID and gimp_int_combo_box_get_active() to retrieve the ID
+ * of the selected drawable.
  *
  * Return value: a new #GimpIntComboBox.
  *