diff --git a/gio/gfile.c b/gio/gfile.c
index 851be01fb..bbb0abd5d 100644
--- a/gio/gfile.c
+++ b/gio/gfile.c
@@ -512,7 +512,8 @@ g_file_get_basename (GFile *file)
  * g_file_get_path:
  * @file: input #GFile
  *
- * Gets the local pathname for #GFile, if one exists.
+ * Gets the local pathname for #GFile, if one exists. If non-%NULL, this is
+ * guaranteed to be an absolute, canonical path. It might contain symlinks.
  *
  * This call does no blocking I/O.
  *