From 85609d124a69ae3be89e50202481beee46ee08bc Mon Sep 17 00:00:00 2001
From: Tristan Van Berkom <tristan.van.berkom@gmail.com>
Date: Fri, 3 Dec 2010 18:55:24 +0900
Subject: [PATCH] Added clarification to the GtkCellView:cell-area-context
 documentation.

---
 gtk/gtkcellview.c | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/gtk/gtkcellview.c b/gtk/gtkcellview.c
index 539554198c..a63b7f5ba8 100644
--- a/gtk/gtkcellview.c
+++ b/gtk/gtkcellview.c
@@ -247,6 +247,15 @@ gtk_cell_view_class_init (GtkCellViewClass *klass)
    *
    * The #GtkCellAreaContext used to compute the geometry of the cell view.
    *
+   * A group of cell views can be assigned the same context in order to
+   * ensure the sizes and cell alignments match across all the views with
+   * the same context.
+   *
+   * #GtkTreeMenu uses this to assign the same context to all cell views
+   * in the menu items for a single menu (each submenu creates it's own
+   * context since the size of each submenu does not depend on parent
+   * or sibling menus).
+   *
    * since 3.0
    */
    g_object_class_install_property (gobject_class,