diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 6f85b72c1a..63ada866df 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,5 +1,8 @@
 2006-08-06  Matthias Clasen  <mclasen@redhat.com>
 
+	* gtk/tmpl/gtkcelllayout.sgml: Add an explanation
+	of attributes.  (#349367, Don Anderson)
+
 	* gtk/tmpl/gtkrecentmanager.sgml: Fix a typo.  (#349120, Vincent Untz) 
 
 2006-07-23  Matthias Clasen  <mclasen@redhat.com>
diff --git a/docs/reference/gtk/tmpl/gtkcelllayout.sgml b/docs/reference/gtk/tmpl/gtkcelllayout.sgml
index ee1481bd58..d292122557 100644
--- a/docs/reference/gtk/tmpl/gtkcelllayout.sgml
+++ b/docs/reference/gtk/tmpl/gtkcelllayout.sgml
@@ -11,6 +11,18 @@ want to provide a #GtkTreeViewColumn-like API for packing cells, setting
 attributes and data funcs. 
 </para>
 
+<para>
+One of the notable features provided by implementations of GtkCellLayout
+are <emphasis>attributes</emphasis>. Attributes let you set the properties
+in flexible ways. They can just be set to constant values like regular
+properties. But they can also be mapped to a column of the underlying 
+tree model with gtk_cell_layout_set_attributes(), which means that the value 
+of the attribute can change from cell to cell as they are rendered by the 
+cell renderer. Finally, it is possible to specify a function with 
+gtk_cell_layout_set_cell_data_func() that is called to determine the value 
+of the attribute for each cell that is rendered.
+</para>
+
 <!-- ##### SECTION See_Also ##### -->
 <para>