Document several button signals as not useful. `

2005-06-17  Matthias Clasen  <mclasen@redhat.com>

	* gtk/gtkbutton.c (gtk_button_class_init): Document
	several button signals as not useful.
`

diff --git a/ChangeLog b/ChangeLog
index 4c22d3d4aba16e6687db973e7810a22a552b18cd..97f309a7460b3594ade83137a339bc6384504514 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,8 @@
 2005-06-17  Matthias Clasen  <mclasen@redhat.com>
 
+       * gtk/gtkbutton.c (gtk_button_class_init): Document
+       several button signals as not useful.
+
        * gtk/gtkentrycompletion.c (gtk_entry_completion_complete): 
        Resize the popup if necessary.  (#308076, Vincent Noel)
 

diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index 4c22d3d4aba16e6687db973e7810a22a552b18cd..97f309a7460b3594ade83137a339bc6384504514 100644 (file)
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,5 +1,8 @@
 2005-06-17  Matthias Clasen  <mclasen@redhat.com>
 
+       * gtk/gtkbutton.c (gtk_button_class_init): Document
+       several button signals as not useful.
+
        * gtk/gtkentrycompletion.c (gtk_entry_completion_complete): 
        Resize the popup if necessary.  (#308076, Vincent Noel)
 

diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index 4c22d3d4aba16e6687db973e7810a22a552b18cd..97f309a7460b3594ade83137a339bc6384504514 100644 (file)
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,5 +1,8 @@
 2005-06-17  Matthias Clasen  <mclasen@redhat.com>
 
+       * gtk/gtkbutton.c (gtk_button_class_init): Document
+       several button signals as not useful.
+
        * gtk/gtkentrycompletion.c (gtk_entry_completion_complete): 
        Resize the popup if necessary.  (#308076, Vincent Noel)
 

diff --git a/gtk/gtkbutton.c b/gtk/gtkbutton.c
index 732cf8077c7274468ce587f77c6f68d617fbb53f..3a9f2a451a71c8ae61c2456550e87c3849f42ab9 100644 (file)
--- a/gtk/gtkbutton.c
+++ b/gtk/gtkbutton.c
@@ -309,6 +309,14 @@ gtk_button_class_init (GtkButtonClass *klass)
                                                         GTK_TYPE_WIDGET,
                                                         GTK_PARAM_READWRITE));
 
+  /**
+   * GtkButton::pressed:
+   * @button: the object that received the signal
+   *
+   * Emitted when the button is pressed.
+   * 
+   * @Deprecated: Use the GtkWidget::button-press-event signal.
+   */ 
   button_signals[PRESSED] =
     g_signal_new ("pressed",
                  G_OBJECT_CLASS_TYPE (object_class),
@@ -317,6 +325,15 @@ gtk_button_class_init (GtkButtonClass *klass)
                  NULL, NULL,
                  _gtk_marshal_VOID__VOID,
                  G_TYPE_NONE, 0);
+
+  /**
+   * GtkButton::released:
+   * @button: the object that received the signal
+   *
+   * Emitted when the button is released.
+   * 
+   * @Deprecated: Use the GtkWidget::button-release-event signal.
+   */ 
   button_signals[RELEASED] =
     g_signal_new ("released",
                  G_OBJECT_CLASS_TYPE (object_class),
@@ -325,6 +342,13 @@ gtk_button_class_init (GtkButtonClass *klass)
                  NULL, NULL,
                  _gtk_marshal_VOID__VOID,
                  G_TYPE_NONE, 0);
+
+  /**
+   * GtkButton::clicked:
+   * @button: the object that received the signal
+   *
+   * Emitted when the button has been activated (pressed and released).
+   */ 
   button_signals[CLICKED] =
     g_signal_new ("clicked",
                  G_OBJECT_CLASS_TYPE (object_class),
@@ -333,6 +357,15 @@ gtk_button_class_init (GtkButtonClass *klass)
                  NULL, NULL,
                  _gtk_marshal_VOID__VOID,
                  G_TYPE_NONE, 0);
+
+  /**
+   * GtkButton::enter:
+   * @button: the object that received the signal
+   *
+   * Emitted when the pointer enters the button.
+   * 
+   * @Deprecated: Use the GtkWidget::enter-notify-event signal.
+   */ 
   button_signals[ENTER] =
     g_signal_new ("enter",
                  G_OBJECT_CLASS_TYPE (object_class),
@@ -341,6 +374,15 @@ gtk_button_class_init (GtkButtonClass *klass)
                  NULL, NULL,
                  _gtk_marshal_VOID__VOID,
                  G_TYPE_NONE, 0);
+
+  /**
+   * GtkButton::leave:
+   * @button: the object that received the signal
+   *
+   * Emitted when the pointer leaves the button.
+   * 
+   * @Deprecated: Use the GtkWidget::leave-notify-event signal.
+   */ 
   button_signals[LEAVE] =
     g_signal_new ("leave",
                  G_OBJECT_CLASS_TYPE (object_class),