[gtkmm/gtkmm-2-24] ComboBoxText, ComboBoxEntryText: Add warning about not confusing these.

[Murray Cumming <murrayc src gnome org>]

commit 4baa3dc789e61f3247ad2739d84aa44f85909f84
Author: Murray Cumming <murrayc murrayc com>
Date:   Tue Feb 8 09:36:05 2011 +0100

    ComboBoxText, ComboBoxEntryText: Add warning about not confusing these.
    
    * gtk/gtkmm/comboboxentrytext.h:
    * gtk/gtkmm/comboboxtext.h: Add a doxygen comment warning people not to
    call set_model() on these or to pack more cells in.

 ChangeLog                     |    8 ++++++++
 gtk/gtkmm/comboboxentrytext.h |    2 ++
 gtk/gtkmm/comboboxtext.h      |    4 +++-
 3 files changed, 13 insertions(+), 1 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index 61dac2f..d3cea0c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2011-02-08  Murray Cumming  <murrayc murrayc com>
+
+	ComboBoxText, ComboBoxEntryText: Add warning about not confusing these.
+
+	* gtk/gtkmm/comboboxentrytext.h:
+	* gtk/gtkmm/comboboxtext.h: Add a doxygen comment warning people not to 
+	call set_model() on these or to pack more cells in.
+
 2.23.91:
 
 2011-02-02  Murray Cumming  <murrayc murrayc com>
diff --git a/gtk/gtkmm/comboboxentrytext.h b/gtk/gtkmm/comboboxentrytext.h
index 944971e..1adf16b 100644
--- a/gtk/gtkmm/comboboxentrytext.h
+++ b/gtk/gtkmm/comboboxentrytext.h
@@ -37,6 +37,8 @@ namespace Gtk
 /** This is a specialisation of the ComboBoxEntry which has one column of text (a simple list),
  * and appropriate methods for setting and getting the text.
  *
+ * You should not call set_model() or attempt to pack more cells into this combo box via its CellLayout base class.
+ *
  * @deprecated Instead use ComboBoxText with has_entry = true.
  *
  * @ingroup Widgets
diff --git a/gtk/gtkmm/comboboxtext.h b/gtk/gtkmm/comboboxtext.h
index 752547a..2842ec9 100644
--- a/gtk/gtkmm/comboboxtext.h
+++ b/gtk/gtkmm/comboboxtext.h
@@ -33,7 +33,9 @@ namespace Gtk
 /** This is a specialisation of the ComboBox which has one column of text (a simple list),
  * and appropriate methods for setting and getting the text.
  *
- * Note that you can not use this class with Gnome::Glade::Xml::get_widget_derived() to wrap a GtkComboBox added 
+ * You should not call set_model() or attempt to pack more cells into this combo box via its CellLayout base class.
+ *
+ * Note that you cannot use this class with Gnome::Glade::Xml::get_widget_derived() to wrap a GtkComboBox added 
  * in the Glade user interface designer, because Glade adds its own TreeModel instead of using the TreeModel from 
  * this class. You could use a normal Gtk::ComboBox instead, though you can not use Glade to add rows to a TreeModel 
  * that is defined in your C++ code.