Doc additions.

2004-11-02  Matthias Clasen  <mclasen@redhat.com>

	* gtk/gtkcellrenderercombo.c (gtk_cell_renderer_combo_class_init):
	Doc additions.


2004-11-02  Matthias Clasen  <mclasen@redhat.com>

	* gtk/tmpl/gtkcellrenderercombo.sgml:
	* gtk/tmpl/gtkcellrenderertoggle.sgml:
	* gtk/tmpl/gtkcellrenderertext.sgml: Add introductions.

	* gtk/tmpl/gtkcellrenderer.sgml: Additions.

ChangeLog

@@ -1,5 +1,8 @@
 2004-11-02  Matthias Clasen  <mclasen@redhat.com>
 
+	* gtk/gtkcellrenderercombo.c (gtk_cell_renderer_combo_class_init): 
+	Doc additions.
+
 	* gtk/gtkfilechooserbutton.h: Fix trigraphs in private markers.
 
 	* gtk/gtkfilechooserbutton.c (gtk_file_chooser_button_class_init): 

ChangeLog.pre-2-10

@@ -1,5 +1,8 @@
 2004-11-02  Matthias Clasen  <mclasen@redhat.com>
 
+	* gtk/gtkcellrenderercombo.c (gtk_cell_renderer_combo_class_init): 
+	Doc additions.
+
 	* gtk/gtkfilechooserbutton.h: Fix trigraphs in private markers.
 
 	* gtk/gtkfilechooserbutton.c (gtk_file_chooser_button_class_init): 

ChangeLog.pre-2-6

@@ -1,5 +1,8 @@
 2004-11-02  Matthias Clasen  <mclasen@redhat.com>
 
+	* gtk/gtkcellrenderercombo.c (gtk_cell_renderer_combo_class_init): 
+	Doc additions.
+
 	* gtk/gtkfilechooserbutton.h: Fix trigraphs in private markers.
 
 	* gtk/gtkfilechooserbutton.c (gtk_file_chooser_button_class_init): 

ChangeLog.pre-2-8

@@ -1,5 +1,8 @@
 2004-11-02  Matthias Clasen  <mclasen@redhat.com>
 
+	* gtk/gtkcellrenderercombo.c (gtk_cell_renderer_combo_class_init): 
+	Doc additions.
+
 	* gtk/gtkfilechooserbutton.h: Fix trigraphs in private markers.
 
 	* gtk/gtkfilechooserbutton.c (gtk_file_chooser_button_class_init): 

docs/reference/ChangeLog

@@ -1,5 +1,11 @@
 2004-11-02  Matthias Clasen  <mclasen@redhat.com>
 
+	* gtk/tmpl/gtkcellrenderercombo.sgml: 
+	* gtk/tmpl/gtkcellrenderertoggle.sgml: 
+	* gtk/tmpl/gtkcellrenderertext.sgml: Add introductions.
+	
+	* gtk/tmpl/gtkcellrenderer.sgml: Additions.
+
 	* gtk/gtk-sections.txt: Remove GtkFileChooserEmbed, since
 	it is not in the headers we parse.
 

docs/reference/gtk/tmpl/gtkcellrenderer.sgml

@@ -19,8 +19,8 @@ elements on a #GdkDrawable.  Typically, one cell renderer is used to
 draw many cells on the screen.  To this extent, it isn't expected that a
 CellRenderer keep any permanent state around.  Instead, any state is set
 just prior to use using #GObject<!-- -->s property system.  Then, the
-cell is measured using @gtk_cell_renderer_get_size.  Finally, the cell
+cell is measured using gtk_cell_renderer_get_size().  Finally, the cell
-is rendered in the correct location using @gtk_cell_renderer_render.
+is rendered in the correct location using gtk_cell_renderer_render().
 </para>
 
 <para>
@@ -31,6 +31,17 @@ barring a #GtkStyle change.  The #GtkCellRenderer also has a number of
 generic properties that are expected to be honored by all children.
 </para>
 
+<para>
+Beyond merely rendering a cell, cell renderers can optionally 
+provide active user interface elements. A cell renderer can be 
+<firstterm>activatable</firstterm> like #GtkCellRendererToggle, 
+which toggles when it gets activated by a mouse click, or it can be 
+<firstterm>editable</firstterm> like #GtkCellRendererText, which 
+allows the user to edit the text using a #GtkEntry.
+To make a cell renderer activatable or editable, you have to 
+implement the @activate or @start_editing virtual functions, 
+respectively.
+</para>
 <!-- ##### SECTION See_Also ##### -->
 <para>
 #GtkCellRendererText,#GtkCellRendererPixbuf,#GtkCellRendererToggle

docs/reference/gtk/tmpl/gtkcellrenderercombo.sgml

@@ -2,11 +2,22 @@
 GtkCellRendererCombo
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Renders a combobox in a cell
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
+#GtkCellRendererCombo renders text in a cell like #GtkCellRendererText from which it
+is derived. But while #GtkCellRendererText offers a simple entry to edit the text,
+#GtkCellRendererCombo offers a #GtkComboBox or #GtkComboBoxEntry widget to edit 
+the text. The values to display in the combo box are taken from the tree model 
+specified in the <link linkend="GtkCellRendererCombo--model">model</link> property.
+</para>
 
+<para>
+The combo cell renderer takes care of adding a text cell renderer to the combo box
+and sets it to display the column specified by its 
+<link linkend="GtkCellRendererCombo--text-column">text-column</link> property. Further
+cell renderers can be added in a handler for the editing-started signal.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->

docs/reference/gtk/tmpl/gtkcellrendererpixbuf.sgml

@@ -7,20 +7,22 @@ Renders a pixbuf in a cell
 <!-- ##### SECTION Long_Description ##### -->
 <para>
 A #GtkCellRendererPixbuf can be used to render an image in a cell. It allows to render 
-either a given #GdkPixbuf (set via the <link linkend="GtkCellRendererPixbuf--pixbuf">pixbuf</link>
+either a given #GdkPixbuf (set via the 
-property) or a stock icon (set via the <link linkend="GtkCellRendererPixbuf--stock-id">stock-id</link>
+<link linkend="GtkCellRendererPixbuf--pixbuf">pixbuf</link> property) or a stock icon 
-property).
+(set via the <link linkend="GtkCellRendererPixbuf--stock-id">stock-id</link> property).
 </para>
 
 <para>
-To support the tree view, #GtkCellRendererPixbuf also supports rendering two alternative pixbufs,
+To support the tree view, #GtkCellRendererPixbuf also supports rendering two alternative 
-when the <link linkend="GtkCellRenderer--is-expander">is-expander</link> property is %TRUE.
+pixbufs, when the <link linkend="GtkCellRenderer--is-expander">is-expander</link> property 
-If the <link linkend="GtkCellRenderer--is-expander">is-expander</link> property is %TRUE and
+is %TRUE. If the <link linkend="GtkCellRenderer--is-expanded">is-expanded</link> property 
-the <link linkend="GtkCellRendererPixbuf--pixbuf-expander-open">pixbuf-expander-open</link> property
+is %TRUE and the 
-is set to a pixbuf, it renders that pixbuf, if the 
+<link linkend="GtkCellRendererPixbuf--pixbuf-expander-open">pixbuf-expander-open</link> 
-<link linkend="GtkCellRenderer--is-expander">is-expander</link> property is %FALSE and
+property is set to a pixbuf, it renders that pixbuf, if the 
-the <link linkend="GtkCellRendererPixbuf--pixbuf-expander-closed">pixbuf-expander-closed</link> property
+<link linkend="GtkCellRenderer--is-expanded">is-expanded</link> property is %FALSE and
-is set to a pixbuf, it renders that one. 
+the 
+<link linkend="GtkCellRendererPixbuf--pixbuf-expander-closed">pixbuf-expander-closed</link> 
+property is set to a pixbuf, it renders that one. 
 </para>
 
 <!-- ##### SECTION See_Also ##### -->

docs/reference/gtk/tmpl/gtkcellrenderertext.sgml

@@ -6,7 +6,15 @@ Renders text in a cell
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
+A #GtkCellRendererText renders a given text in its cell, using the font, color and 
+style information provided by its properties. The text will be ellipsized if it is 
+too long and the <link linkend="GtkCellRendererText--ellipsize">ellipsize</link> 
+property allows it.
+</para>
 
+<para>
+If the <link linkend="GtkCellRenderer--mode">mode</link> is %GTK_CELL_RENDERER_MODE_EDITABLE,
+the #GtkCellRendererText allows to edit its text using an entry.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->

docs/reference/gtk/tmpl/gtkcellrenderertoggle.sgml

@@ -6,7 +6,10 @@ Renders a toggle button in a cell
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+#GtkCellRendererToggle renders a toggle button in a cell. The 
+button is drawn as a radio- or checkbutton, depending on the 
+<link linkend="GtkCellRendererToggle--radio">radio</link> 
+property. When activated, it emits the toggled signal.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->

gtk/gtkcellrenderercombo.c

@@ -98,6 +98,9 @@ gtk_cell_renderer_combo_class_init (GtkCellRendererComboClass *klass)
    * <emphasis>not</emphasis> the model backing the tree view to which this cell 
    * renderer is attached.
    * 
+   * #GtkCellRendererCombo automatically adds a text cell renderer for this column
+   * to its combo box.
+   *
    * Since: 2.6
    */
   g_object_class_install_property (object_class,
@@ -140,7 +143,7 @@ gtk_cell_renderer_combo_init (GtkCellRendererCombo *self)
 /**
  * gtk_cell_renderer_combo_new: 
  * 
- * Creates a new #GtkCellRendererCombo 
+ * Creates a new #GtkCellRendererCombo. 
  * Adjust how text is drawn using object properties. 
  * Object properties can be set globally (with g_object_set()). 
  * Also, with #GtkTreeViewColumn, you can bind a property to a value