gfile: Document usefulness of g_file_dup()

Signed-off-by: Philip Withnall <withnall@endlessm.com>

https://gitlab.gnome.org/GNOME/glib/issues/807
This commit is contained in:
Philip Withnall 2018-06-19 12:36:37 +01:00
parent 40a84b3d1c
commit 6284749487

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 objects
* reference count.
*
* This call does no blocking I/O.
*
* Returns: (transfer full): a new #GFile that is a duplicate