[gtk+/composite-templates] Update docs for GtkEntry::activate



commit 9eab55e0ea28b9b3f2174281ad531a0290330742
Author: Matthias Clasen <mclasen redhat com>
Date:   Mon Jun 11 19:27:25 2012 -0400

    Update docs for GtkEntry::activate
    
    Remove the 'you shall not connect' message from this signal.
    While it is a keybinding signal, using it from applications is
    fine and, in fact, expected.

 gtk/gtkentry.c |   12 ++++++------
 1 files changed, 6 insertions(+), 6 deletions(-)
---
diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c
index 9d9f5ed..2e81fcf 100644
--- a/gtk/gtkentry.c
+++ b/gtk/gtkentry.c
@@ -1441,12 +1441,12 @@ gtk_entry_class_init (GtkEntryClass *class)
    * GtkEntry::activate:
    * @entry: The entry on which the signal is emitted
    *
-   * A  <link linkend="keybinding-signals">keybinding signal</link>
-   * which gets emitted when the user activates the entry.
-   * 
-   * Applications should not connect to it, but may emit it with
-   * g_signal_emit_by_name() if they need to control activation 
-   * programmatically.
+   * The ::activate signal is emitted when the the user hits
+   * the Enter key.
+   *
+   * While this signal is used as a <link linkend="keybinding-signals">keybinding signal</link>,
+   * it is also commonly used by applications to intercept
+   * activation of entries.
    *
    * The default bindings for this signal are all forms of the Enter key.
    */



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]