gfile: Document a few nullable vfuncs

`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 <withnall@endlessm.com>
This commit is contained in:
Philip Withnall 2019-09-27 17:31:42 +01:00
parent 7d2bce82e2
commit 674ba78f12

View File

@ -111,10 +111,13 @@ typedef struct _GFileIface GFileIface;
* @make_directory: Makes a directory. * @make_directory: Makes a directory.
* @make_directory_async: Asynchronously makes a directory. * @make_directory_async: Asynchronously makes a directory.
* @make_directory_finish: Finishes making a directory asynchronously. * @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_async: Asynchronously makes a symbolic link
* @_make_symbolic_link_finish: Finishes making a symbolic link asynchronously. * @_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_async: Asynchronously copies a file.
* @copy_finish: Finishes an asynchronous copy operation. * @copy_finish: Finishes an asynchronous copy operation.
* @move: Moves a file. * @move: Moves a file.