diff options
| author | Emmanuele Bassi <ebassi@gnome.org> | 2015-06-10 17:16:41 +0100 |
|---|---|---|
| committer | Emmanuele Bassi <ebassi@gnome.org> | 2015-06-11 11:45:03 +0100 |
| commit | d11e81257e220c2a78acdcc4fab6f0bee99128c4 (patch) | |
| tree | af55fb3c3a201e237884fd29fecee640cddd7a5f /gtk/gtksettings.c | |
| parent | b493bf091af34d8085cd71c2d6e9fe16ab2a20f2 (diff) | |
| download | gtk+-d11e81257e220c2a78acdcc4fab6f0bee99128c4.tar.gz | |
docs: Improve deprecation notices for GtkSettings
The button and menu item icons settings are deprecated; application
developers should control whether or not a widget should show an icon,
using the existing API.
https://bugzilla.gnome.org/show_bug.cgi?id=750718
Diffstat (limited to 'gtk/gtksettings.c')
| -rw-r--r-- | gtk/gtksettings.c | 12 |
1 files changed, 10 insertions, 2 deletions
diff --git a/gtk/gtksettings.c b/gtk/gtksettings.c index e754e8712f..11f24e3b2e 100644 --- a/gtk/gtksettings.c +++ b/gtk/gtksettings.c @@ -1316,7 +1316,11 @@ gtk_settings_class_init (GtkSettingsClass *class) * * Since: 2.4 * - * Deprecated: 3.10: This setting is deprecated + * Deprecated: 3.10: This setting is deprecated. Application developers + * control whether a button should show an icon or now, on a + * per-button basis. If a #GtkButton should show an icon, use the + * #GtkButton:always-show-image property of #GtkButton, and pack a + * #GtkImage inside the #GtkButton */ result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-button-images", @@ -1360,7 +1364,11 @@ gtk_settings_class_init (GtkSettingsClass *class) * * Whether images should be shown in menu items * - * Deprecated: 3.10: This setting is deprecated + * Deprecated: 3.10: This setting is deprecated. Application developers + * control whether or not a #GtkMenuItem should have an icon or not, + * on a per widget basis. Either use a #GtkMenuItem with a #GtkBox + * containing a #GtkImage and a #GtkAccelLabel, or describe your menus + * using a #GMenu XML description */ result = settings_install_property_parser (class, g_param_spec_boolean ("gtk-menu-images", |