[glib: 1/2] GFile: Document that G_FILE_CREATE_REPLACE_DESTINATION can only be used with g_file_replace() and va

[Philip Withnall <pwithnall src gnome org>]

commit 63809867bd8d438fe44fc22b3d4780f07cbf48ac
Author: Sebastian Dröge <sebastian centricular com>
Date:   Mon Jul 27 18:35:38 2020 +0300

    GFile: Document that G_FILE_CREATE_REPLACE_DESTINATION can only be used with g_file_replace() and variants
    
    Passing it to e.g. g_file_create() for an already existing file will
    still cause a "file exists" error.

 gio/gioenums.h | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)
---
diff --git a/gio/gioenums.h b/gio/gioenums.h
index c6b525224..2692b746d 100644
--- a/gio/gioenums.h
+++ b/gio/gioenums.h
@@ -199,7 +199,9 @@ typedef enum {
  *    rather than a "save new version of" replace operation.
  *    You can think of it as "unlink destination" before
  *    writing to it, although the implementation may not
- *    be exactly like that. Since 2.20
+ *    be exactly like that. This flag can only be used with
+ *    g_file_replace() and its variants, including g_file_replace_contents().
+ *    Since 2.20
  *
  * Flags used when an operation may create a file.
  */