From ce9729b2fbfccdbff4c68b52a878b5b6d35b3e0d Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Mon, 19 Jan 2009 22:58:38 +0000 Subject: [PATCH] Expand docs svn path=/trunk/; revision=7822 --- gio/ChangeLog | 4 ++++ gio/gdesktopappinfo.c | 14 ++++++++++++-- 2 files changed, 16 insertions(+), 2 deletions(-) diff --git a/gio/ChangeLog b/gio/ChangeLog index dcd5282..4c89223 100644 --- a/gio/ChangeLog +++ b/gio/ChangeLog @@ -1,5 +1,9 @@ 2009-01-19 Matthias Clasen + * gdesktopappinfo.c (g_desktop_app_info_new): Expand the docs. + +2009-01-19 Matthias Clasen + * === Released 2.19.5 === 2009-01-19 Matthias Clasen diff --git a/gio/gdesktopappinfo.c b/gio/gdesktopappinfo.c index 2ea2e81..4cb2154 100644 --- a/gio/gdesktopappinfo.c +++ b/gio/gdesktopappinfo.c @@ -331,10 +331,20 @@ g_desktop_app_info_new_from_filename (const char *filename) * g_desktop_app_info_new: * @desktop_id: the desktop file id * - * Creates a new #GDesktopAppInfo. + * Creates a new #GDesktopAppInfo based on a desktop file id. + * + * A desktop file id is the basename of the desktop file, including the + * .desktop extension. GIO is looking for a desktop file with this name + * in the applications subdirectories of the XDG data + * directories (i.e. the directories specified in the + * XDG_DATA_HOME and XDG_DATA_DIRS environment + * variables). GIO also supports the prefix-to-subdirectory mapping that is + * described in the Menu Spec + * (i.e. a desktop id of kde-foo.desktop will match + * /usr/share/applications/kde/foo.desktop). * * Returns: a new #GDesktopAppInfo, or %NULL if no desktop file with that id - **/ + */ GDesktopAppInfo * g_desktop_app_info_new (const char *desktop_id) { -- 2.7.4