Merge branch 'desktop-search-docs' into 'master'

gdesktopappinfo: Note that search results are not filtered

See merge request GNOME/glib!1455
This commit is contained in:
Philip Withnall 2020-05-05 09:21:18 +00:00
commit 1e598b98e3

View File

@ -4478,6 +4478,13 @@ g_desktop_app_info_get_implementations (const gchar *interface)
* The algorithm for determining matches is undefined and may change at
* any time.
*
* None of the search results are subjected to the normal validation
* checks performed by g_desktop_app_info_new() (for example, checking that
* the executable referenced by a result exists), and so it is possible for
* g_desktop_app_info_new() to return %NULL when passed an app ID returned by
* this function. It is expected that calling code will do this when
* subsequently creating a #GDesktopAppInfo for each result.
*
* Returns: (array zero-terminated=1) (element-type GStrv) (transfer full): a
* list of strvs. Free each item with g_strfreev() and free the outer
* list with g_free().