From: Matthias Clasen <mclasen@redhat.com>
Date: Mon, 11 Jun 2012 23:27:25 +0000 (-0400)
Subject: Update docs for GtkEntry::activate
X-Git-Tag: archive/raspbian/4.4.1+ds1-2+rpi1^2~18^2~24^2~19764
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=4a25bac0e7685000fff90a211db6ac60f6b74ab1;p=gtk4.git

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.
---

diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c
index 9d9f5edf1c..2e81fcf521 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.
    */