Expand docs

svn path=/trunk/; revision=7822
This commit is contained in:
Matthias Clasen 2009-01-19 22:58:38 +00:00
parent af6a048743
commit ce9729b2fb
2 changed files with 16 additions and 2 deletions

View File

@ -1,3 +1,7 @@
2009-01-19 Matthias Clasen <mclasen@redhat.com>
* gdesktopappinfo.c (g_desktop_app_info_new): Expand the docs.
2009-01-19 Matthias Clasen <mclasen@redhat.com>
* === Released 2.19.5 ===

View File

@ -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 <filename>applications</filename> subdirectories of the XDG data
* directories (i.e. the directories specified in the
* <envar>XDG_DATA_HOME</envar> and <envar>XDG_DATA_DIRS</envar> environment
* variables). GIO also supports the prefix-to-subdirectory mapping that is
* described in the <ulink url="http://standards.freedesktop.org/menu-spec/latest/">Menu Spec</ulink>
* (i.e. a desktop id of kde-foo.desktop will match
* <filename>/usr/share/applications/kde/foo.desktop</filename>).
*
* Returns: a new #GDesktopAppInfo, or %NULL if no desktop file with that id
**/
*/
GDesktopAppInfo *
g_desktop_app_info_new (const char *desktop_id)
{