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

gfile: Clarify docs

Browse Source 
Clarify corner cases that were unclear while reviewing a GTK patch.
This commit is contained in:
Benjamin Otte 2014-10-12 01:57:02 +02:00
parent 6e994d0656
commit e054bbfe16
1 changed files with 4 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
gio/gfile.c
View File

@ -641,7 +641,7 @@ g_file_hash (gconstpointer file)
* @file1: the first #GFile * @file1: the first #GFile
* @file2: the second #GFile * @file2: the second #GFile
* *
* Checks equality of two given #GFiles. * Checks if the two given #GFiles refer to the same file.
* *
* Note that two #GFiles that differ can still refer to the same * Note that two #GFiles that differ can still refer to the same
* file on the filesystem due to various forms of filename * file on the filesystem due to various forms of filename
@ -810,6 +810,9 @@ g_file_get_child_for_display_name (GFile *file,
* so a path like /foo is not considered a prefix of /foobar, only * so a path like /foo is not considered a prefix of /foobar, only
* of /foo/bar. * of /foo/bar.
* *
* A #GFile is not a prefix of itself. If you want to check for
* equality, use g_file_equal().
*
* This call does no I/O, as it works purely on names. As such it can * This call does no I/O, as it works purely on names. As such it can
* sometimes return %FALSE even if @file is inside a @prefix (from a * sometimes return %FALSE even if @file is inside a @prefix (from a
* filesystem point of view), because the prefix of @file is an alias * filesystem point of view), because the prefix of @file is an alias