diff --git a/ChangeLog b/ChangeLog
index 4c22d3d4ab..97f309a746 100644
--- 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 4c22d3d4ab..97f309a746 100644
--- 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 4c22d3d4ab..97f309a746 100644
--- 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 732cf8077c..3a9f2a451a 100644
--- 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),