luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-03-31 04:43:06 +02:00
Code Issues Packages Projects Releases Wiki Activity

doc: Clarify documentation regarding g_file_replace and etags

Browse Source 
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
This commit is contained in:
Ross Lagerwall 2014-09-08 21:09:08 +01:00
parent 226c292b6a
commit 0728e62be8
1 changed files with 8 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
gio/gfile.c
View File

@ -1724,14 +1724,14 @@ g_file_create (GFile *file,
* operation was cancelled, the error %G_IO_ERROR_CANCELLED will be * operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
* returned. * returned.
* *
* If you pass in a non-%NULL @etag value, then this value is * If you pass in a non-%NULL @etag value and @file already exists, then
* compared to the current entity tag of the file, and if they differ * this value is compared to the current entity tag of the file, and if
* an %G_IO_ERROR_WRONG_ETAG error is returned. This generally means * they differ an %G_IO_ERROR_WRONG_ETAG error is returned. This
* that the file has been changed since you last read it. You can get * generally means that the file has been changed since you last read
* the new etag from g_file_output_stream_get_etag() after you've * it. You can get the new etag from g_file_output_stream_get_etag()
* finished writing and closed the #GFileOutputStream. When you load * after you've finished writing and closed the #GFileOutputStream. When
* a new file you can use g_file_input_stream_query_info() to get * you load a new file you can use g_file_input_stream_query_info() to
* the etag of the file. * get the etag of the file.
* *
* If @make_backup is %TRUE, this function will attempt to make a * If @make_backup is %TRUE, this function will attempt to make a
* backup of the current file before overwriting it. If this fails * backup of the current file before overwriting it. If this fails