[Gnucash-changes] r13442 - gnucash/trunk/src/app-utils - Add clarifying comment to weird directory function, better to be replaced by the appropriate glib function.

[Christian Stimming]

Author: cstim
Date: 2006-03-02 16:59:44 -0500 (Thu, 02 Mar 2006)
New Revision: 13442
Trac: http://svn.gnucash.org/trac/changeset/13442

Modified:
   gnucash/trunk/src/app-utils/gnc-ui-util.h
Log:
Add clarifying comment to weird directory function, better to be replaced by the appropriate glib function.

Modified: gnucash/trunk/src/app-utils/gnc-ui-util.h
===================================================================
--- gnucash/trunk/src/app-utils/gnc-ui-util.h	2006-03-02 21:54:33 UTC (rev 13441)
+++ gnucash/trunk/src/app-utils/gnc-ui-util.h	2006-03-02 21:59:44 UTC (rev 13442)
@@ -67,6 +67,12 @@
  * Again watch out: The caller takes ownership of the char buffer
  * '*dirname', i.e. the caller has to do a g_free(*dirname) when that
  * buffer is no longer in use.
+ *
+ * NOTE: We strongly recommend to use g_path_get_dirname() from glib
+ * instead of this function. (There's one slight functional difference:
+ * If filename is NULL or does not contain a separator,
+ * g_path_get_dirname will return "." whereas this function here will
+ * return NULL. 2006-03-02, cstim)
 */
 void gnc_extract_directory (char **dirname, const char *filename);