From d7829ced532a5ffba4c56772a7a4b24e3e228651 Mon Sep 17 00:00:00 2001 From: Colin Walters Date: Mon, 30 Jul 2012 05:11:08 -0400 Subject: [PATCH] GFile: Note semantics of g_file_delete() Particularly for someone programming on Unix, this helps them understand that we will unlink symbolic links, and not follow them. --- gio/gfile.c | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/gio/gfile.c b/gio/gfile.c index b76939f9f..f66487575 100644 --- a/gio/gfile.c +++ b/gio/gfile.c @@ -3483,7 +3483,7 @@ g_file_make_symbolic_link (GFile *file, * @error: a #GError, or %NULL * * Deletes a file. If the @file is a directory, it will only be deleted if it - * is empty. + * is empty. This has the same semantics as g_unlink(). * * If @cancellable is not %NULL, then the operation can be cancelled by * triggering the cancellable object from another thread. If the operation @@ -3527,7 +3527,8 @@ g_file_delete (GFile *file, * @user_data: the data to pass to callback function * * Asynchronously delete a file. If the @file is a directory, it will - * only be deleted if it is empty. + * only be deleted if it is empty. This has the same semantics as + * g_unlink(). * * Virtual: delete_file_async * Since: 2.34