Improve the docs

svn path=/trunk/; revision=7003

diff --git a/ChangeLog b/ChangeLog
index 9135ccfd893afcad173f4fbab2bf510c060f2968..e8cecfcd776b8d3feb3be8ccf2ea7db0248b9d35 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2008-06-11  Matthias Clasen  <mclasen@redhat.com>
+
+       Bug 455215 – g_get_user_special_dir: no reference about
+       G_USER_DIRECTORY_DOWNLOAD fallback to $HOME/Desktop if 
+       xdg-user-dirs is not in use
+
+       * glib/gutils.c (g_get_user_special_dir): Improve the docs.
+       Proposed by Luca Ferretti
+
 2008-06-11  Matthias Clasen  <mclasen@redhat.com>
 
        Bug 498732 – g_key_file_to_data cannot fail

diff --git a/glib/gutils.c b/glib/gutils.c
index 4654388ff91dd0d3db10090a3327dcd626c054f3..b2b7dc15655a87dadee99e4eef43267febcac599 100644 (file)
--- a/glib/gutils.c
+++ b/glib/gutils.c
@@ -2446,6 +2446,9 @@ load_user_special_dirs (void)
  * Returns the full path of a special directory using its logical id.
  *
  * On Unix this is done using the XDG special user directories.
+ * For compatibility with existing practise, %G_USER_DIRECTORY_DESKTOP
+ * falls back to <filename>$HOME/Desktop</filename> when XDG special
+ * user directories have not been set up. 
  *
  * Depending on the platform, the user might be able to change the path
  * of the special directory without requiring the session to restart; GLib