[glib] gfileutils: Mention g_dir_make_tmp() in g_mkdtemp*() docs



commit 810a6eb1d632b6067dcc3fbb2f61fa2dd66a166a
Author: Bastien Nocera <hadess hadess net>
Date:   Mon Jan 23 05:49:15 2017 +0100

    gfileutils: Mention g_dir_make_tmp() in g_mkdtemp*() docs
    
    https://bugzilla.gnome.org/show_bug.cgi?id=777493

 glib/gfileutils.c |    8 ++++++++
 1 files changed, 8 insertions(+), 0 deletions(-)
---
diff --git a/glib/gfileutils.c b/glib/gfileutils.c
index d0967d2..daac6ed 100644
--- a/glib/gfileutils.c
+++ b/glib/gfileutils.c
@@ -1365,6 +1365,10 @@ wrap_g_open (const gchar *filename,
  * in the GLib file name encoding. Most importantly, on Windows it
  * should be in UTF-8.
  *
+ * If you are going to be creating a temporary directory inside the
+ * directory returned by g_get_tmp_dir(), you might want to use
+ * g_dir_make_tmp() instead.
+ *
  * Returns: (nullable) (type filename): A pointer to @tmpl, which has been
  *     modified to hold the directory name. In case of errors, %NULL is
  *     returned, and %errno will be set.
@@ -1397,6 +1401,10 @@ g_mkdtemp_full (gchar *tmpl,
  * The string should be in the GLib file name encoding. Most importantly,
  * on Windows it should be in UTF-8.
  *
+ * If you are going to be creating a temporary directory inside the
+ * directory returned by g_get_tmp_dir(), you might want to use
+ * g_dir_make_tmp() instead.
+ *
  * Returns: (nullable) (type filename): A pointer to @tmpl, which has been
  *     modified to hold the directory name.  In case of errors, %NULL is
  *     returned and %errno will be set.


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]