docs: Explain 'icon theme context' better in gtkicontheme.c

Add links from gtk_icon_theme_list_contexts() to
gtk_icon_theme_list_icons(), and from there to the Icon Theme
Specification and the Icon Naming Specification.

https://bugzilla.gnome.org/show_bug.cgi?id=461249
This commit is contained in:
Kjell Ahlstedt
2014-04-11 18:52:39 +02:00
committed by Matthias Clasen
parent f74a75ae7e
commit 5d3aa54a8a

View File

@@ -2548,7 +2548,11 @@ add_key_to_list (gpointer key,
* of the icons can be listed by providing a context string.
* The set of values for the context string is system dependent,
* but will typically include such values as “Applications” and
* “MimeTypes”.
* “MimeTypes”. Contexts are explained in the
* [Icon Theme Specification](http://www.freedesktop.org/wiki/Specifications/icon-theme-spec).
* The standard contexts are listed in the
* [Icon Naming Specification](http://www.freedesktop.org/wiki/Specifications/icon-naming-spec).
* Also see gtk_icon_theme_list_contexts().
*
* Returns: (element-type utf8) (transfer full): a #GList list
* holding the names of all the icons in the theme. You must
@@ -2610,7 +2614,8 @@ gtk_icon_theme_list_icons (GtkIconTheme *icon_theme,
* @icon_theme: a #GtkIconTheme
*
* Gets the list of contexts available within the current
* hierarchy of icon themes
* hierarchy of icon themes.
* See gtk_icon_theme_list_icons() for details about contexts.
*
* Returns: (element-type utf8) (transfer full): a #GList list
* holding the names of all the contexts in the theme. You must first