[gtk+/gtk-3-4] Update docs for GtkEntry::activate

[Matthias Clasen <matthiasc src gnome org>]

commit f81277203711b58f88093ac9c42f0bd9bd6a7a46
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 1ea6b9c..2d6722d 100644
--- a/gtk/gtkentry.c
+++ b/gtk/gtkentry.c
@@ -1440,12 +1440,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.
    */