From 13d091f700c4bbaddc3c9cba12746a38838b6f71 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Mon, 2 Nov 2015 12:51:00 -0500
Subject: [PATCH] button: Mention differentiating style classes

There's a lot of button variations out there, lets document
the ones we know about.
---
 gtk/gtkbutton.c | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/gtk/gtkbutton.c b/gtk/gtkbutton.c
index f976194caf..08c0dd31ea 100644
--- a/gtk/gtkbutton.c
+++ b/gtk/gtkbutton.c
@@ -43,6 +43,11 @@
  *
  * Other style classes that are commonly used with GtkButton include
  * .suggested-action and .destructive-action.
+ *
+ * Button-like widgets like #GtkToggleButton, #GtkMenuButton, #GtkVolumeButton,
+ * #GtkLockButton, #GtkColorButton, #GtkFontButton or #GtkFileChooserButton use
+ * style classes such as .toggle, .popup, .scale, .lock, .color, .font, .file
+ * to differentiate themselves from a plain GtkButton.
  */
 
 #include "config.h"