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 461249 - gtk_icon_theme_list_contexts() documentation: What is a context?
gtk_icon_theme_list_contexts() documentation: What is a context?
Status: RESOLVED FIXED
Product: gtk+
Classification: Platform
Component: Widget: Other
2.11.x
Other Linux
: Normal normal
: ---
Assigned To: gtk-bugs
gtk-bugs
Depends on:
Blocks:
 
 
Reported: 2007-07-28 15:34 UTC by Murray Cumming
Modified: 2014-12-08 04:35 UTC
See Also:
GNOME target: ---
GNOME version: ---

Attachments
patch: docs: Explain 'icon theme context' better in gtkicontheme.c (1.77 KB, patch)
2014-04-11 16:57 UTC, Kjell Ahlstedt 		none Details | Review

Description Murray Cumming 2007-07-28 15:34:30 UTC 
The documentation for gtk_icon_theme_list_contexts()
( http://developer.gnome.org/doc/API/2.0/gtk/GtkIconTheme.html#id2619610 )
does not explain what a context is.

The documentation for gtk_icon_theme_list_icons() describes a context slightly, though I'd like it to be more explicit. One function's documentation could refer to the other.
Comment 1 Murray Cumming 2007-10-27 15:41:30 UTC 
Surely somebody knows?
Comment 2 Kjell Ahlstedt 2014-04-11 16:57:20 UTC 
Created attachment 274118 [details] [review]
patch: docs: Explain 'icon theme context' better in gtkicontheme.c

Is this patch good enough?
Comment 3 Kjell Ahlstedt 2014-04-11 16:57:58 UTC 
I would also like an explanation of what a symbolic icon is, or a working
link to an explanation.

The documentation of gtk_icon_info_load_symbolic() contains a link to
[Symbolic Icons Specification](http://www.freedesktop.org/wiki/SymbolicIcons).
That link is broken. Perhaps that web page has been moved. I can't find it.
The best I can find is https://wiki.gnome.org/Design/HIG/IconsAndArtwork.