After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 566945 - gtk_widget_override_color() documentation should mention non-recursiveness
gtk_widget_override_color() documentation should mention non-recursiveness
Status: RESOLVED FIXED
Product: gtk+
Classification: Platform
Component: Widget: Other
unspecified
Other Linux
: Normal normal
: ---
Assigned To: gtk-bugs
gtk-bugs
Depends on:
Blocks: 551912
 
 
Reported: 2009-01-07 21:25 UTC by Murray Cumming
Modified: 2014-01-28 15:39 UTC
See Also:
GNOME target: ---
GNOME version: ---

Attachments
patch: Improve doc of gtk_widget_override_color() (1.04 KB, patch)
2013-10-07 13:48 UTC, Kjell Ahlstedt 		none Details | Review

Description Murray Cumming 2009-01-07 21:25:55 UTC 
Many people seem to expect gtk_widget_modify_text() to have an effect on widgets such as GtkComboBox or GtkButton, but they actually have to get the child widget and call gtk_widget_modify_text() on that.

If this function can't be made to act on child widgets too then that should at least be documented.

Note that I don't use this function or the style stuff much, so I guess I could be misunderstanding their use.
Comment 1 Murray Cumming 2009-01-07 21:26:23 UTC 
The documentation:
http://library.gnome.org/devel/gtk/unstable/GtkWidget.html#gtk-widget-modify-text
Comment 2 Murray Cumming 2011-05-10 07:21:00 UTC 
Updated the description for the slightly-renamed API in GTK+ 3:
http://developer.gnome.org/gtk3/unstable/GtkWidget.html#gtk-widget-override-color

The documentation still seems to need this improvement.
Comment 3 Kjell Ahlstedt 2013-10-07 13:48:21 UTC 
Created attachment 256623 [details] [review]
patch: Improve doc of gtk_widget_override_color()

Proposed addition to the documentation of gtk_widget_override_color().
Comment 4 Murray Cumming 2014-01-28 15:02:46 UTC 
I pushed this to GTK+ master because it's seems simple and harmless and they are usually OK with me making such docs changes.
Comment 5 Matthias Clasen 2014-01-28 15:39:51 UTC 
'they' are, indeed :-)
Thanks, Murray !