luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-01-26 05:56:14 +01:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch '807-g-file-dup-docs' into 'master'

Browse Source 
Document why g_file_dup() is useful, instead of g_object_ref()

Closes #807

See merge request GNOME/glib!122
This commit is contained in:
Xavier Claessens 2018-06-19 13:47:37 +00:00
commit 720fc3fadc
1 changed files with 5 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
gio/gfile.c
View File

@ -702,6 +702,11 @@ g_file_get_parse_name (GFile *file)
* the actual file or directory represented by the #GFile; see
* g_file_copy() if attempting to copy a file.
*
* g_file_dup() is useful when a second handle is needed to the same underlying
* file, for use in a separate thread (#GFile is not thread-safe). For use
* within the same thread, use g_object_ref() to increment the existing object’s
* reference count.
*
* This call does no blocking I/O.
*
* Returns: (transfer full): a new #GFile that is a duplicate