diff --git a/gtk/gtkcellrenderertoggle.c b/gtk/gtkcellrenderertoggle.c
index 77174c8774..b1d4d7b65c 100644
--- a/gtk/gtkcellrenderertoggle.c
+++ b/gtk/gtkcellrenderertoggle.c
@@ -183,7 +183,8 @@ gtk_cell_renderer_toggle_class_init (GtkCellRendererToggleClass *class)
    * The ::toggled signal is emitted when the cell is toggled. 
    *
    * It is the responsibility of the application to update the model
-   * and store the "active" property at the position indicated by @path.
+   * with the correct value to store at @path.  Often this is simply the
+   * opposite of the value currently stored at @path.
    **/
   toggle_cell_signals[TOGGLED] =
     g_signal_new (I_("toggled"),