diff --git a/gio/gappinfo.c b/gio/gappinfo.c index ccaec2083..ec3656fa6 100644 --- a/gio/gappinfo.c +++ b/gio/gappinfo.c @@ -1304,7 +1304,7 @@ g_app_info_can_delete (GAppInfo *appinfo) /** - * g_app_info_delete: + * g_app_info_delete: (virtual do_delete) * @appinfo: a #GAppInfo * * Tries to delete a #GAppInfo. @@ -1313,7 +1313,6 @@ g_app_info_can_delete (GAppInfo *appinfo) * #GAppInfos which can be deleted, and system-wide ones which cannot. * See g_app_info_can_delete(). * - * Virtual: do_delete * Returns: %TRUE if @appinfo has been deleted * * Since: 2.20 diff --git a/gio/gfile.c b/gio/gfile.c index 8c3fc48de..3b4daff0f 100644 --- a/gio/gfile.c +++ b/gio/gfile.c @@ -747,14 +747,13 @@ g_file_dup (GFile *file) } /** - * g_file_hash: + * g_file_hash: (virtual hash) * @file: (type GFile): #gconstpointer to a #GFile * * Creates a hash value for a #GFile. * * This call does no blocking I/O. * - * Virtual: hash * Returns: 0 if @file is not a valid #GFile, otherwise an * integer that can be used as hash value for the #GFile. * This function is intended for easily hashing a #GFile to @@ -939,7 +938,7 @@ g_file_get_child_for_display_name (GFile *file, } /** - * g_file_has_prefix: + * g_file_has_prefix: (virtual prefix_matches) * @file: input #GFile * @prefix: input #GFile * @@ -958,7 +957,6 @@ g_file_get_child_for_display_name (GFile *file, * filesystem point of view), because the prefix of @file is an alias * of @prefix. * - * Virtual: prefix_matches * Returns: %TRUE if the @file's parent, grandparent, etc is @prefix, * %FALSE otherwise. */ @@ -1674,7 +1672,7 @@ g_file_find_enclosing_mount_finish (GFile *file, /** - * g_file_read: + * g_file_read: (virtual read_fn) * @file: #GFile to read * @cancellable: (nullable): a #GCancellable * @error: a #GError, or %NULL @@ -1691,7 +1689,6 @@ g_file_find_enclosing_mount_finish (GFile *file, * error will be returned. Other errors are possible too, and depend * on what kind of filesystem the file is on. * - * Virtual: read_fn * Returns: (transfer full): #GFileInputStream or %NULL on error. * Free the returned object with g_object_unref(). */ @@ -4097,7 +4094,7 @@ g_file_make_directory (GFile *file, } /** - * g_file_make_directory_async: + * g_file_make_directory_async: (virtual make_directory_async) * @file: input #GFile * @io_priority: the [I/O priority][io-priority] of the request * @cancellable: (nullable): optional #GCancellable object, @@ -4108,7 +4105,6 @@ g_file_make_directory (GFile *file, * * Asynchronously creates a directory. * - * Virtual: make_directory_async * Since: 2.38 */ void @@ -4131,7 +4127,7 @@ g_file_make_directory_async (GFile *file, } /** - * g_file_make_directory_finish: + * g_file_make_directory_finish: (virtual make_directory_finish) * @file: input #GFile * @result: a #GAsyncResult * @error: a #GError, or %NULL @@ -4139,7 +4135,6 @@ g_file_make_directory_async (GFile *file, * Finishes an asynchronous directory creation, started with * g_file_make_directory_async(). * - * Virtual: make_directory_finish * Returns: %TRUE on successful directory creation, %FALSE otherwise. * Since: 2.38 */ @@ -4371,7 +4366,7 @@ g_file_real_make_symbolic_link_async (GFile *file, } /** - * g_file_make_symbolic_link_async: + * g_file_make_symbolic_link_async: (virtual make_symbolic_link_async) * @file: a #GFile with the name of the symlink to create * @symlink_value: (type filename): a string with the path for the target * of the new symlink @@ -4385,7 +4380,6 @@ g_file_real_make_symbolic_link_async (GFile *file, * Asynchronously creates a symbolic link named @file which contains the * string @symlink_value. * - * Virtual: make_symbolic_link_async * Since: 2.74 */ void @@ -4422,7 +4416,7 @@ g_file_real_make_symbolic_link_finish (GFile *file, } /** - * g_file_make_symbolic_link_finish: + * g_file_make_symbolic_link_finish: (virtual make_symbolic_link_finish) * @file: input #GFile * @result: a #GAsyncResult * @error: a #GError, or %NULL @@ -4430,7 +4424,6 @@ g_file_real_make_symbolic_link_finish (GFile *file, * Finishes an asynchronous symbolic link creation, started with * g_file_make_symbolic_link_async(). * - * Virtual: make_symbolic_link_finish * Returns: %TRUE on successful directory creation, %FALSE otherwise. * Since: 2.74 */ @@ -4452,7 +4445,7 @@ g_file_make_symbolic_link_finish (GFile *file, } /** - * g_file_delete: + * g_file_delete: (virtual delete_file) * @file: input #GFile * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore @@ -4480,7 +4473,6 @@ g_file_make_symbolic_link_finish (GFile *file, * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * - * Virtual: delete_file * Returns: %TRUE if the file was deleted. %FALSE otherwise. */ gboolean @@ -4509,7 +4501,7 @@ g_file_delete (GFile *file, } /** - * g_file_delete_async: + * g_file_delete_async: (virtual delete_file_async) * @file: input #GFile * @io_priority: the [I/O priority][io-priority] of the request * @cancellable: (nullable): optional #GCancellable object, @@ -4522,7 +4514,6 @@ g_file_delete (GFile *file, * only be deleted if it is empty. This has the same semantics as * g_unlink(). * - * Virtual: delete_file_async * Since: 2.34 */ void @@ -4545,14 +4536,13 @@ g_file_delete_async (GFile *file, } /** - * g_file_delete_finish: + * g_file_delete_finish: (virtual delete_file_finish) * @file: input #GFile * @result: a #GAsyncResult * @error: a #GError, or %NULL * * Finishes deleting a file started with g_file_delete_async(). * - * Virtual: delete_file_finish * Returns: %TRUE if the file was deleted. %FALSE otherwise. * Since: 2.34 **/ @@ -4574,7 +4564,7 @@ g_file_delete_finish (GFile *file, } /** - * g_file_trash: + * g_file_trash: (virtual trash) * @file: #GFile to send to trash * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore @@ -4591,7 +4581,6 @@ g_file_delete_finish (GFile *file, * triggering the cancellable object from another thread. If the operation * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. * - * Virtual: trash * Returns: %TRUE on successful trash, %FALSE otherwise. */ gboolean @@ -4620,7 +4609,7 @@ g_file_trash (GFile *file, } /** - * g_file_trash_async: + * g_file_trash_async: (virtual trash_async) * @file: input #GFile * @io_priority: the [I/O priority][io-priority] of the request * @cancellable: (nullable): optional #GCancellable object, @@ -4631,7 +4620,6 @@ g_file_trash (GFile *file, * * Asynchronously sends @file to the Trash location, if possible. * - * Virtual: trash_async * Since: 2.38 */ void @@ -4654,7 +4642,7 @@ g_file_trash_async (GFile *file, } /** - * g_file_trash_finish: + * g_file_trash_finish: (virtual trash_finish) * @file: input #GFile * @result: a #GAsyncResult * @error: a #GError, or %NULL @@ -4662,7 +4650,6 @@ g_file_trash_async (GFile *file, * Finishes an asynchronous file trashing operation, started with * g_file_trash_async(). * - * Virtual: trash_finish * Returns: %TRUE on successful trash, %FALSE otherwise. * Since: 2.38 */ @@ -5798,7 +5785,7 @@ g_file_eject_mountable_with_operation_finish (GFile *file, } /** - * g_file_monitor_directory: + * g_file_monitor_directory: (virtual monitor_dir) * @file: input #GFile * @flags: a set of #GFileMonitorFlags * @cancellable: (nullable): optional #GCancellable object, @@ -5818,10 +5805,8 @@ g_file_eject_mountable_with_operation_finish (GFile *file, * directory for changes made via hard links; if you want to do this then * you must register individual watches with g_file_monitor(). * - * Virtual: monitor_dir * Returns: (transfer full): a #GFileMonitor for the given @file, - * or %NULL on error. - * Free the returned object with g_object_unref(). + * or %NULL on error. Free the returned object with g_object_unref(). */ GFileMonitor * g_file_monitor_directory (GFile *file, diff --git a/gio/gicon.c b/gio/gicon.c index cd69922f1..48a8d754d 100644 --- a/gio/gicon.c +++ b/gio/gicon.c @@ -84,14 +84,13 @@ g_icon_default_init (GIconInterface *iface) } /** - * g_icon_hash: + * g_icon_hash: (hash) * @icon: (not nullable) (type Gio.Icon): #gconstpointer to an icon object. * * Gets a hash for an icon. * - * Virtual: hash * Returns: a #guint containing a hash for the @icon, suitable for - * use in a #GHashTable or similar data structure. + * use in a #GHashTable or similar data structure. **/ guint g_icon_hash (gconstpointer icon) diff --git a/gio/goutputstream.c b/gio/goutputstream.c index 3674a92dc..1665e4472 100644 --- a/gio/goutputstream.c +++ b/gio/goutputstream.c @@ -171,7 +171,7 @@ g_output_stream_init (GOutputStream *stream) } /** - * g_output_stream_write: + * g_output_stream_write: (virtual write_fn) * @stream: a #GOutputStream. * @buffer: (array length=count) (element-type guint8): the buffer containing the data to write. * @count: the number of bytes to write @@ -199,8 +199,6 @@ g_output_stream_init (GOutputStream *stream) * * On error -1 is returned and @error is set accordingly. * - * Virtual: write_fn - * * Returns: Number of bytes written, or -1 on error **/ gssize @@ -320,7 +318,7 @@ g_output_stream_write_all (GOutputStream *stream, } /** - * g_output_stream_writev: + * g_output_stream_writev: (virtual writev_fn) * @stream: a #GOutputStream. * @vectors: (array length=n_vectors): the buffer containing the #GOutputVectors to write. * @n_vectors: the number of vectors to write @@ -353,8 +351,6 @@ g_output_stream_write_all (GOutputStream *stream, * are exceeded. For example, when writing to a local file on UNIX platforms, * the aggregate buffer size must not exceed %G_MAXSSIZE bytes. * - * Virtual: writev_fn - * * Returns: %TRUE on success, %FALSE if there was an error * * Since: 2.60 diff --git a/gio/gpollableinputstream.c b/gio/gpollableinputstream.c index 3f76cb6d4..28eedbf6a 100644 --- a/gio/gpollableinputstream.c +++ b/gio/gpollableinputstream.c @@ -170,7 +170,7 @@ g_pollable_input_stream_default_read_nonblocking (GPollableInputStream *stream, } /** - * g_pollable_input_stream_read_nonblocking: + * g_pollable_input_stream_read_nonblocking: (virtual read_nonblocking) * @stream: a #GPollableInputStream * @buffer: (array length=count) (element-type guint8) (out caller-allocates): a * buffer to read data into (which should be at least @count bytes long). @@ -193,7 +193,6 @@ g_pollable_input_stream_default_read_nonblocking (GPollableInputStream *stream, * The behaviour of this method is undefined if * g_pollable_input_stream_can_poll() returns %FALSE for @stream. * - * Virtual: read_nonblocking * Returns: the number of bytes read, or -1 on error (including * %G_IO_ERROR_WOULD_BLOCK). */ diff --git a/gio/gpollableoutputstream.c b/gio/gpollableoutputstream.c index f33267aa1..9a85225ef 100644 --- a/gio/gpollableoutputstream.c +++ b/gio/gpollableoutputstream.c @@ -238,7 +238,7 @@ g_pollable_output_stream_default_writev_nonblocking (GPollableOutputStream *str } /** - * g_pollable_output_stream_write_nonblocking: + * g_pollable_output_stream_write_nonblocking: (virtual write_nonblocking) * @stream: a #GPollableOutputStream * @buffer: (array length=count) (element-type guint8): a buffer to write * data from @@ -265,7 +265,6 @@ g_pollable_output_stream_default_writev_nonblocking (GPollableOutputStream *str * The behaviour of this method is undefined if * g_pollable_output_stream_can_poll() returns %FALSE for @stream. * - * Virtual: write_nonblocking * Returns: the number of bytes written, or -1 on error (including * %G_IO_ERROR_WOULD_BLOCK). */ @@ -307,7 +306,7 @@ g_pollable_output_stream_write_nonblocking (GPollableOutputStream *stream, } /** - * g_pollable_output_stream_writev_nonblocking: + * g_pollable_output_stream_writev_nonblocking: (virtual writev_nonblocking) * @stream: a #GPollableOutputStream * @vectors: (array length=n_vectors): the buffer containing the #GOutputVectors to write. * @n_vectors: the number of vectors to write @@ -336,8 +335,6 @@ g_pollable_output_stream_write_nonblocking (GPollableOutputStream *stream, * The behaviour of this method is undefined if * g_pollable_output_stream_can_poll() returns %FALSE for @stream. * - * Virtual: writev_nonblocking - * * Returns: %@G_POLLABLE_RETURN_OK on success, %G_POLLABLE_RETURN_WOULD_BLOCK * if the stream is not currently writable (and @error is *not* set), or * %G_POLLABLE_RETURN_FAILED if there was an error in which case @error will diff --git a/gio/gtlspassword.c b/gio/gtlspassword.c index 586d76155..b3a6f4a94 100644 --- a/gio/gtlspassword.c +++ b/gio/gtlspassword.c @@ -300,7 +300,7 @@ g_tls_password_set_value (GTlsPassword *password, } /** - * g_tls_password_set_value_full: + * g_tls_password_set_value_full: (virtual set_value) * @password: a #GTlsPassword object * @value: (array length=length): the value for the password * @length: the length of the password, or -1 @@ -316,7 +316,6 @@ g_tls_password_set_value (GTlsPassword *password, * calculated automatically. (Note that the terminating nul is not * considered part of the password in this case.) * - * Virtual: set_value * Since: 2.30 */ void diff --git a/gio/gvolume.c b/gio/gvolume.c index ba94b17e8..5a204969a 100644 --- a/gio/gvolume.c +++ b/gio/gvolume.c @@ -330,7 +330,7 @@ g_volume_should_automount (GVolume *volume) /** - * g_volume_mount: + * g_volume_mount: (virtual mount_fn) * @volume: a #GVolume * @flags: flags affecting the operation * @mount_operation: (nullable): a #GMountOperation or %NULL to avoid user interaction @@ -341,8 +341,6 @@ g_volume_should_automount (GVolume *volume) * Mounts a volume. This is an asynchronous operation, and is * finished by calling g_volume_mount_finish() with the @volume * and #GAsyncResult returned in the @callback. - * - * Virtual: mount_fn */ void g_volume_mount (GVolume *volume,