diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 7b7458760a..e8b63c1d86 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,6 +1,18 @@
+2004-12-15  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tmpl/gtkcelleditable.sgml: 
+	* gtk/tmpl/gtkcellview.sgml: 
+	* gtk/tmpl/gtktreeviewcolumn.sgml: 
+	* gtk/tmpl/gtktreeview.sgml: 
+	* gtk/tmpl/gtktreesortable.sgml: Add/improve long
+	descriptions.
+
+	* gtk/glossary.xml: Remove a dangling link.
+
 2004-12-14  Matthias Clasen  <mclasen@redhat.com>
 
 	* gtk/gtk-sections.txt: Add new iconview methods.
+	Remove gtk_cell_view_set_value[s] for now.
 
 2004-12-13  Matthias Clasen  <mclasen@redhat.com>
 
diff --git a/docs/reference/gtk/tmpl/gtkcelleditable.sgml b/docs/reference/gtk/tmpl/gtkcelleditable.sgml
index d4f0aa5d09..c4df9822c0 100644
--- a/docs/reference/gtk/tmpl/gtkcelleditable.sgml
+++ b/docs/reference/gtk/tmpl/gtkcelleditable.sgml
@@ -6,7 +6,8 @@ Interface for widgets which can are used for editing cells
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+The #GtkCellEditable interface must be implemented for widgets
+to be usable when editing the contents of a #GtkTreeView cell.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
diff --git a/docs/reference/gtk/tmpl/gtkcellview.sgml b/docs/reference/gtk/tmpl/gtkcellview.sgml
index ec0072bce6..d324d40dc5 100644
--- a/docs/reference/gtk/tmpl/gtkcellview.sgml
+++ b/docs/reference/gtk/tmpl/gtkcellview.sgml
@@ -6,7 +6,10 @@ A widget displaying a single row of a GtkTreeModel
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+A #GtkCellView displays a single row of a #GtkTreeModel, using
+cell renderers just like #GtkTreeView. #GtkCellView doesn't support
+some of the more complex features of #GtkTreeView, like cell editing
+and drag and drop.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
@@ -70,27 +73,6 @@ A widget displaying a single row of a GtkTreeModel
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_cell_view_set_value ##### -->
-<para>
-
-</para>
-
-@cell_view: 
-@renderer: 
-@property: 
-@value: 
-
-
-<!-- ##### FUNCTION gtk_cell_view_set_values ##### -->
-<para>
-
-</para>
-
-@cell_view: 
-@renderer: 
-@Varargs: 
-
-
 <!-- ##### FUNCTION gtk_cell_view_set_model ##### -->
 <para>
 
@@ -138,16 +120,6 @@ A widget displaying a single row of a GtkTreeModel
 @color: 
 
 
-<!-- ##### FUNCTION gtk_cell_view_set_cell_data ##### -->
-<para>
-
-</para>
-
-@cell_view: 
-<!-- # Unused Parameters # -->
-@cellview: 
-
-
 <!-- ##### FUNCTION gtk_cell_view_get_cell_renderers ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtktreesortable.sgml b/docs/reference/gtk/tmpl/gtktreesortable.sgml
index 2c40f5b9a2..546654b7ef 100644
--- a/docs/reference/gtk/tmpl/gtktreesortable.sgml
+++ b/docs/reference/gtk/tmpl/gtktreesortable.sgml
@@ -6,12 +6,14 @@ The interface for sortable models used by GtkTreeView
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+#GtkTreeSortable is an interface to be implemented by tree models which
+support sorting. The #GtkTreeView uses the methods provided by this interface
+to sort the model.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
 <para>
-
+#GtkTreeModel, #GtkTreeView
 </para>
 
 <!-- ##### STRUCT GtkTreeSortable ##### -->
diff --git a/docs/reference/gtk/tmpl/gtktreeview.sgml b/docs/reference/gtk/tmpl/gtktreeview.sgml
index f3a127eba5..47bde21e39 100644
--- a/docs/reference/gtk/tmpl/gtktreeview.sgml
+++ b/docs/reference/gtk/tmpl/gtktreeview.sgml
@@ -10,6 +10,12 @@ Widget that displays any object that implements the <link
 linkend="GtkTreeModel">GtkTreeModel</link> interface.
 </para>
 
+<para>
+Please refer to the <link linkend="TreeWidget">tree widget conceptual overview</link> 
+for an overview of all the objects and data types related to the tree widget and how 
+they work together.
+</para>
+
 <!-- ##### SECTION See_Also ##### -->
 <para>
 #GtkTreeViewColumn, #GtkTreeSelection, #GtkTreeDnd, #GtkTreeMode, #GtkTreeSortable, #GtkTreeModelSort, #GtkListStore, #GtkTreeStore, #GtkCellRenderer, #GtkCellEditable, #GtkCellRendererPixbuf, #GtkCellRendererText, #GtkCellRendererToggle
diff --git a/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml b/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml
index 06994f3dbf..30bbdddde5 100644
--- a/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml
+++ b/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml
@@ -6,7 +6,15 @@ A visible column in a #GtkTreeView widget
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-The GtkTreeViewColumn object is a visible column in a #GtkTreeView widget.
+The GtkTreeViewColumn object represents a visible column in a #GtkTreeView widget.
+It allows to set properties of the column header, and functions as a holding pen for 
+the cell renderers which determine how the data in the column is displayed.
+</para>
+
+<para>
+Please refer to the <link linkend="TreeWidget">tree widget conceptual overview</link> 
+for an overview of all the objects and data types related to the tree widget and how 
+they work together.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->