summaryrefslogtreecommitdiff
path: root/gtk
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2020-10-15 10:08:03 -0400
committerMatthias Clasen <mclasen@redhat.com>2020-10-15 11:42:50 -0400
commit6d1dcaa92ae7d2d713094cc1f89b509e57d50a75 (patch)
tree7cb09b32ecd0c4a54a427447de6883668c918104 /gtk
parent9c28ecb0da9920e173cb99dc141a4321280c8ffb (diff)
downloadgtk+-6d1dcaa92ae7d2d713094cc1f89b509e57d50a75.tar.gz
docs: Explain the symbolic icon paintable situation
Add a paragraph to the migration guide that explains how to properly render symbolic GtkIconPaintables. Also mention this in the GtkIconPaintable docs. There's a reason you can't spell 'paintable' without 'pain'...
Diffstat (limited to 'gtk')
-rw-r--r--gtk/gtkicontheme.c3
1 files changed, 3 insertions, 0 deletions
diff --git a/gtk/gtkicontheme.c b/gtk/gtkicontheme.c
index cc0cfaa2c5..8792135846 100644
--- a/gtk/gtkicontheme.c
+++ b/gtk/gtkicontheme.c
@@ -3670,6 +3670,9 @@ gtk_icon_paintable_get_icon_name (GtkIconPaintable *icon)
* the file name and not the file contents for determining this.
* This behaviour may change in the future.
*
+ * Note that to render a symbolic #GtkIconPaintable properly (with
+ * recoloring), you have to set its icon name on a #GtkImage.
+ *
* Returns: %TRUE if the icon is symbolic, %FALSE otherwise
*/
gboolean