From 674ba78f1277b4781336afde750d6fdbc74f2ace Mon Sep 17 00:00:00 2001 From: Philip Withnall Date: Fri, 27 Sep 2019 17:31:42 +0100 Subject: [PATCH] gfile: Document a few nullable vfuncs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `GFile` always checks whether these vfuncs are `NULL` before calling them, so document that it’s safe for implementations of `GFile` to not implement them. Signed-off-by: Philip Withnall --- gio/gfile.h | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/gio/gfile.h b/gio/gfile.h index 8441d0bd1..8b6d08385 100644 --- a/gio/gfile.h +++ b/gio/gfile.h @@ -111,10 +111,13 @@ typedef struct _GFileIface GFileIface; * @make_directory: Makes a directory. * @make_directory_async: Asynchronously makes a directory. * @make_directory_finish: Finishes making a directory asynchronously. - * @make_symbolic_link: Makes a symbolic link. + * @make_symbolic_link: (nullable): Makes a symbolic link. %NULL if symbolic + * links are unsupported. * @_make_symbolic_link_async: Asynchronously makes a symbolic link * @_make_symbolic_link_finish: Finishes making a symbolic link asynchronously. - * @copy: Copies a file. + * @copy: (nullable): Copies a file. %NULL if copying is unsupported, which will + * cause `GFile` to use a fallback copy method where it reads from the + * source and writes to the destination. * @copy_async: Asynchronously copies a file. * @copy_finish: Finishes an asynchronous copy operation. * @move: Moves a file.