Index: ChangeLog
===================================================================
RCS file: /cvs/gnome/gtkmm-root/base/ChangeLog,v
retrieving revision 1.793
diff -u -3 -r1.793 ChangeLog
--- ChangeLog	27 Jul 2003 12:00:42 -0000	1.793
+++ ChangeLog	9 Aug 2003 12:39:17 -0000
@@ -1,3 +1,10 @@
+2003-08-09  Martin Schulze  <teebaum@cvs.gnome.org>
+
+	* gtk/src/treeview.hg, docs/tutorial/gtkmm-tut.xml:
+	Add information about what to do when the column type is not
+	supported and TreeView::append_column() sets up the CellRenderer
+	incompletely (bug #118922).
+
 2003-07-26  Murray Cumming  <murrayc@usa.net>
 
 	* glib/glibmm/dispatcher.cc: Added #include <algorithm>, needed
Index: docs/tutorial/gtkmm-tut.xml
===================================================================
RCS file: /cvs/gnome/gtkmm-root/doc-tutorial/gtkmm-tut.xml,v
retrieving revision 1.89
diff -u -3 -r1.89 gtkmm-tut.xml
--- docs/tutorial/gtkmm-tut.xml	21 May 2003 05:17:19 -0000	1.89
+++ docs/tutorial/gtkmm-tut.xml	9 Aug 2003 12:39:26 -0000
@@ -2604,7 +2604,12 @@
 display the model data with an appropriate CellRenderer. For instance,
 strings and
 numbers are shown in a simple Gtk::Entry widget, and booleans are
-shown in a Gtk::CheckButton. This is usually what you need.  
+shown in a Gtk::CheckButton. This is usually what you need.
+For other column types you have to install a callback that converts
+your type into a string with TreeViewColumn::set_cell_data_func()
+or derive a custom CellRenderer.
+Note that (unsigned) short is not supported by default - use
+(unsigned) int or (unsigned) long as column type instead!
 </para>
 </sect2>
 
Index: gtk/src/treeview.hg
===================================================================
RCS file: /cvs/gnome/gtkmm-root/gtk-src/treeview.hg,v
retrieving revision 1.67
diff -u -3 -r1.67 treeview.hg
--- gtk/src/treeview.hg	12 Jul 2003 13:48:39 -0000	1.67
+++ gtk/src/treeview.hg	9 Aug 2003 12:39:28 -0000
@@ -106,7 +106,15 @@
 
   _WRAP_METHOD(int append_column(TreeViewColumn& column), gtk_tree_view_append_column)
 
-  /// Appends a View column with the appropriate CellRenderer for the Model column.
+  /** Appends a View column with the appropriate CellRenderer for the Model column.
+   * Note that only for some basic column types like Glib::ustring, int, bool, Gdk::Pixbuf, etc.
+   * the CellRenderer is set up correctly. For other types by default a CellRendererText
+   * is used and you must provide a callback that converts the type into a string with
+   * TreeViewColumn::set_cell_data_func().
+   * If this is not possible manually create an appropriate CellRenderer.
+   * If you want this function to support a custom CellRenderer provide a template
+   * specialization of TreeViewColumn_CellRendererGeneration::generate_cellrenderer().
+   */
   template <class ColumnType> inline
   int append_column(const Glib::ustring& title, const TreeModelColumn<ColumnType>& model_column);
 
