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
This commit is contained in:
Emmanuele Bassi 2015-06-10 17:16:41 +01:00
parent b493bf091a
commit d11e81257e

View File

@ -1316,7 +1316,11 @@ gtk_settings_class_init (GtkSettingsClass *class)
* *
* Since: 2.4 * 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, result = settings_install_property_parser (class,
g_param_spec_boolean ("gtk-button-images", 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 * 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, result = settings_install_property_parser (class,
g_param_spec_boolean ("gtk-menu-images", g_param_spec_boolean ("gtk-menu-images",