[glib] doc: Clarify documentation regarding g_file_replace and etags
- From: Ross Lagerwall <rossl src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glib] doc: Clarify documentation regarding g_file_replace and etags
- Date: Thu, 30 Oct 2014 20:19:50 +0000 (UTC)
commit 0728e62be8bf247f9d097822efd26312367ff133
Author: Ross Lagerwall <rosslagerwall gmail com>
Date: Mon Sep 8 21:09:08 2014 +0100
doc: Clarify documentation regarding g_file_replace and etags
Clarify that with g_file_replace, a non-NULL etag is only checked if the
file already exists.
https://bugzilla.gnome.org/show_bug.cgi?id=736286
gio/gfile.c | 16 ++++++++--------
1 files changed, 8 insertions(+), 8 deletions(-)
---
diff --git a/gio/gfile.c b/gio/gfile.c
index 2e1e3cb..3e2607c 100644
--- a/gio/gfile.c
+++ b/gio/gfile.c
@@ -1724,14 +1724,14 @@ g_file_create (GFile *file,
* operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
* returned.
*
- * If you pass in a non-%NULL @etag value, then this value is
- * compared to the current entity tag of the file, and if they differ
- * an %G_IO_ERROR_WRONG_ETAG error is returned. This generally means
- * that the file has been changed since you last read it. You can get
- * the new etag from g_file_output_stream_get_etag() after you've
- * finished writing and closed the #GFileOutputStream. When you load
- * a new file you can use g_file_input_stream_query_info() to get
- * the etag of the file.
+ * If you pass in a non-%NULL @etag value and @file already exists, then
+ * this value is compared to the current entity tag of the file, and if
+ * they differ an %G_IO_ERROR_WRONG_ETAG error is returned. This
+ * generally means that the file has been changed since you last read
+ * it. You can get the new etag from g_file_output_stream_get_etag()
+ * after you've finished writing and closed the #GFileOutputStream. When
+ * you load a new file you can use g_file_input_stream_query_info() to
+ * get the etag of the file.
*
* If @make_backup is %TRUE, this function will attempt to make a
* backup of the current file before overwriting it. If this fails
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]