From: Daniel Boles Date: Mon, 2 Apr 2018 12:18:18 +0000 (+0100) Subject: CellRenderer: Clarify doc of .start_editing() X-Git-Tag: archive/raspbian/4.4.1+ds1-2+rpi1^2~18^2~22^2~471 X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=aaf2e30a483c9c6cddcdcca5c53352d7d7d55b70;p=gtk4.git CellRenderer: Clarify doc of .start_editing() Drop the line copied from .activate(), replace it with a description of what this method actually does, and explain what a NULL result means. https://gitlab.gnome.org/GNOME/gtk/issues/154 --- diff --git a/gtk/gtkcellrenderer.c b/gtk/gtkcellrenderer.c index 46f0189a1b..8abb0bf4d3 100644 --- a/gtk/gtkcellrenderer.c +++ b/gtk/gtkcellrenderer.c @@ -798,9 +798,11 @@ gtk_cell_renderer_activate (GtkCellRenderer *cell, * @cell_area: cell area as passed to gtk_cell_renderer_render() * @flags: render flags * - * Passes an activate event to the cell renderer for possible processing. + * Starts editing the contents of this @cell, through a new #GtkCellEditable + * widget created by the #GtkCellRendererClass.start_editing virtual function. * - * Returns: (nullable) (transfer none): A new #GtkCellEditable, or %NULL + * Returns: (nullable) (transfer none): A new #GtkCellEditable for editing this + * @cell, or %NULL if editing is not possible **/ GtkCellEditable * gtk_cell_renderer_start_editing (GtkCellRenderer *cell,