[gtk+/gtk-2-24] Update docs for GtkEntry::activate

[William Jon McCann <mccann src gnome org>]

commit ba2dc987605e51933dcbfc7b4620abca94654302
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 e2999a3..b55bd89 100644
--- a/gtk/gtkentry.c
+++ b/gtk/gtkentry.c
@@ -1298,12 +1298,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.
    */