Drop gtk_icon_theme_get_example_icon_name

This function is not useful. Every icon theme
on my system either does not have that field,
or has it as 'folder'. So, just use 'folder'
when you need an example icon.

diff --git a/docs/reference/gtk/gtk4-sections.txt b/docs/reference/gtk/gtk4-sections.txt
index 93485b2defebf42a11e3feb20fe32661631e44ce..ca90aca5b1c0f859666a4c65aec0f0d0f03502ab 100644 (file)
--- a/docs/reference/gtk/gtk4-sections.txt
+++ b/docs/reference/gtk/gtk4-sections.txt
@@ -5310,7 +5310,6 @@ gtk_icon_theme_load_icon
 gtk_icon_theme_load_icon_for_scale
 gtk_icon_theme_list_icons
 gtk_icon_theme_get_icon_sizes
-gtk_icon_theme_get_example_icon_name
 gtk_icon_theme_rescan_if_needed
 gtk_icon_info_new_for_pixbuf
 gtk_icon_info_get_base_size

diff --git a/gtk/gtkicontheme.c b/gtk/gtkicontheme.c
index bf829c25844f82d28d8710b3612b2c04bf646840..fa25c55f49e5919851ab697d444f323ca10622f8 100644 (file)
--- a/gtk/gtkicontheme.c
+++ b/gtk/gtkicontheme.c
@@ -258,7 +258,6 @@ typedef struct
   gchar *name;
   gchar *display_name;
   gchar *comment;
-  gchar *example;
 
   /* In search order */
   GList *dirs;
@@ -1140,10 +1139,6 @@ insert_theme (GtkIconTheme *self,
     g_key_file_get_locale_string (theme_file, 
                                   "Icon Theme", "Comment",
                                   NULL, NULL);
-  theme->example = 
-    g_key_file_get_string (theme_file, 
-                           "Icon Theme", "Example",
-                           NULL);
 
   theme->dirs = NULL;
   for (i = 0; dirs[i] != NULL; i++)
@@ -2322,41 +2317,6 @@ gtk_icon_theme_list_icons (GtkIconTheme *self,
   return list;
 }
 
-/**
- * gtk_icon_theme_get_example_icon_name:
- * @self: a #GtkIconTheme
- * 
- * Gets the name of an icon that is representative of the
- * current theme (for instance, to use when presenting
- * a list of themes to the user.)
- * 
- * Returns: (nullable): the name of an example icon or %NULL.
- *     Free with g_free().
- */
-gchar *
-gtk_icon_theme_get_example_icon_name (GtkIconTheme *self)
-{
-  GList *l;
-  IconTheme *theme;
-
-  g_return_val_if_fail (GTK_IS_ICON_THEME (self), NULL);
-  
-  ensure_valid_themes (self);
-
-  l = self->themes;
-  while (l != NULL)
-    {
-      theme = l->data;
-      if (theme->example)
-        return g_strdup (theme->example);
-      
-      l = l->next;
-    }
-  
-  return NULL;
-}
-
-
 static gboolean
 rescan_themes (GtkIconTheme *self)
 {
@@ -2422,7 +2382,6 @@ theme_destroy (IconTheme *theme)
   g_free (theme->display_name);
   g_free (theme->comment);
   g_free (theme->name);
-  g_free (theme->example);
 
   g_list_free_full (theme->dirs, (GDestroyNotify) theme_dir_destroy);
   

diff --git a/gtk/gtkicontheme.h b/gtk/gtkicontheme.h
index fbe56bf8a7fc3b5b46ab029fbe2fbace41a808ff..9345af71b001de5d714d48ddcff55a7347911d95 100644 (file)
--- a/gtk/gtkicontheme.h
+++ b/gtk/gtkicontheme.h
@@ -198,8 +198,6 @@ GtkIconInfo * gtk_icon_theme_lookup_by_gicon_for_scale (GtkIconTheme
 GDK_AVAILABLE_IN_ALL
 GList *       gtk_icon_theme_list_icons            (GtkIconTheme                *self,
                                                    const gchar                 *context);
-GDK_AVAILABLE_IN_ALL
-char *        gtk_icon_theme_get_example_icon_name (GtkIconTheme                *self);
 
 GDK_AVAILABLE_IN_ALL
 gboolean      gtk_icon_theme_rescan_if_needed      (GtkIconTheme                *self);