[gtk+/combo-refactor: 44/49] Added clarification to the GtkCellView:cell-area-context documentation.

[Tristan Van Berkom <tvb src gnome org>]

commit 1a1cdca1bc020e8460e208ad68e6b94a1e57d99e
Author: Tristan Van Berkom <tristan van berkom gmail com>
Date:   Fri Dec 3 18:55:24 2010 +0900

    Added clarification to the GtkCellView:cell-area-context documentation.

 gtk/gtkcellview.c |    9 +++++++++
 1 files changed, 9 insertions(+), 0 deletions(-)
---
diff --git a/gtk/gtkcellview.c b/gtk/gtkcellview.c
index 4169482..0bea37a 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,