diff options
author | Rico Tzschichholz <ricotz@ubuntu.com> | 2016-12-05 14:52:18 +0100 |
---|---|---|
committer | Rico Tzschichholz <ricotz@ubuntu.com> | 2016-12-05 14:52:18 +0100 |
commit | 36d1a22eefa5020ba75002a2b0c348017c7ab2e3 (patch) | |
tree | f6d1143de4a75c9468bc3302c359f01773e8b884 /gir | |
parent | 43de9fbadf1a389049cb6e67069c6c16cd0629f2 (diff) | |
download | gobject-introspection-36d1a22eefa5020ba75002a2b0c348017c7ab2e3.tar.gz |
gir: Update annotations from GLib git master
Diffstat (limited to 'gir')
-rw-r--r-- | gir/gio-2.0.c | 1308 | ||||
-rw-r--r-- | gir/glib-2.0.c | 427 | ||||
-rw-r--r-- | gir/gmodule-2.0.c | 4 | ||||
-rw-r--r-- | gir/gobject-2.0.c | 192 |
4 files changed, 973 insertions, 958 deletions
diff --git a/gir/gio-2.0.c b/gir/gio-2.0.c index 77e7e0f3..841cad4b 100644 --- a/gir/gio-2.0.c +++ b/gir/gio-2.0.c @@ -594,7 +594,7 @@ * GDBusAuthObserver::authorize-authenticated-peer: * @observer: The #GDBusAuthObserver emitting the signal. * @stream: A #GIOStream for the #GDBusConnection. - * @credentials: (allow-none): Credentials received from the peer or %NULL. + * @credentials: (nullable): Credentials received from the peer or %NULL. * * Emitted to check if a peer that is successfully authenticated * is authorized. @@ -629,7 +629,7 @@ * @connection: the #GDBusConnection emitting the signal * @remote_peer_vanished: %TRUE if @connection is closed because the * remote peer closed its end of the connection - * @error: (allow-none): a #GError with more details about the event or %NULL + * @error: (nullable): a #GError with more details about the event or %NULL * * Emitted when the connection is closed. * @@ -1192,7 +1192,7 @@ /** * GDBusProxy::g-signal: * @proxy: The #GDBusProxy emitting the signal. - * @sender_name: (allow-none): The sender of the signal or %NULL if the connection is not a bus connection. + * @sender_name: (nullable): The sender of the signal or %NULL if the connection is not a bus connection. * @signal_name: The name of the signal. * @parameters: A #GVariant tuple with parameters for the signal. * @@ -1741,7 +1741,7 @@ * GFileMonitor::changed: * @monitor: a #GFileMonitor. * @file: a #GFile. - * @other_file: (allow-none): a #GFile or #NULL. + * @other_file: (nullable): a #GFile or #NULL. * @event_type: a #GFileMonitorEvent. * * Emitted when @file has been changed. @@ -2700,7 +2700,7 @@ /** * GSettings::change-event: * @settings: the object on which the signal was emitted - * @keys: (array length=n_keys) (element-type GQuark) (allow-none): + * @keys: (array length=n_keys) (element-type GQuark) (nullable): * an array of #GQuarks for the changed keys, or %NULL * @n_keys: the length of the @keys array, or 0 * @@ -2895,7 +2895,7 @@ /** * GSimpleAction::activate: * @simple: the #GSimpleAction - * @parameter: (allow-none): the parameter to the activation + * @parameter: (nullable): the parameter to the activation * * Indicates that the action was just activated. * @@ -2917,7 +2917,7 @@ /** * GSimpleAction::change-state: * @simple: the #GSimpleAction - * @value: (allow-none): the requested value for the state + * @value: (nullable): the requested value for the state * * Indicates that the action just received a request to change its * state. @@ -3232,7 +3232,7 @@ * GSocketService::incoming: * @service: the #GSocketService * @connection: a new #GSocketConnection object - * @source_object: (allow-none): the source_object passed to + * @source_object: (nullable): the source_object passed to * g_socket_listener_add_address() * * The ::incoming signal is emitted when a new incoming connection @@ -11613,9 +11613,9 @@ /** * _g_io_module_get_default: * @extension_point: the name of an extension point - * @envvar: (allow-none): the name of an environment variable to + * @envvar: (nullable): the name of an environment variable to * override the default implementation. - * @verify_func: (allow-none): a function to call to verify that + * @verify_func: (nullable): a function to call to verify that * a given implementation is usable in the current environment. * * Retrieves the default object implementing @extension_point. @@ -11643,7 +11643,7 @@ /** * _g_io_module_get_default_type: * @extension_point: the name of an extension point - * @envvar: (allow-none): the name of an environment variable to + * @envvar: (nullable): the name of an environment variable to * override the default implementation. * @is_supported_offset: a vtable offset, or zero * @@ -11681,7 +11681,7 @@ /** * g_action_activate: * @action: a #GAction - * @parameter: (allow-none): the parameter to the activation + * @parameter: (nullable): the parameter to the activation * * Activates the action. * @@ -11753,7 +11753,7 @@ * In the case that this function returns %NULL, you must not give any * #GVariant, but %NULL instead. * - * Returns: (allow-none): the parameter type + * Returns: (nullable): the parameter type * Since: 2.28 */ @@ -11821,7 +11821,7 @@ * then this function will return %NULL. In that case, g_action_get_state() * will return %NULL and you must not call g_action_change_state(). * - * Returns: (allow-none): the state type, if the action is stateful + * Returns: (nullable): the state type, if the action is stateful * Since: 2.28 */ @@ -11884,7 +11884,7 @@ * g_action_group_activate_action: * @action_group: a #GActionGroup * @action_name: the name of the action to activate - * @parameter: (allow-none): parameters to the activation + * @parameter: (nullable): parameters to the activation * * Activate the named action within @action_group. * @@ -12065,10 +12065,10 @@ * @action_group: a #GActionGroup * @action_name: the name of an action in the group * @enabled: (out): if the action is presently enabled - * @parameter_type: (out) (allow-none): the parameter type, or %NULL if none needed - * @state_type: (out) (allow-none): the state type, or %NULL if stateless - * @state_hint: (out) (allow-none): the state hint, or %NULL if none - * @state: (out) (allow-none): the current state, or %NULL if stateless + * @parameter_type: (out) (optional): the parameter type, or %NULL if none needed + * @state_type: (out) (optional): the state type, or %NULL if stateless + * @state_hint: (out) (optional): the state hint, or %NULL if none + * @state: (out) (optional): the current state, or %NULL if stateless * * Queries all aspects of the named action within an @action_group. * @@ -12253,7 +12253,7 @@ /** * g_action_print_detailed_name: * @action_name: a valid action name - * @target_value: (allow-none): a #GVariant target value, or %NULL + * @target_value: (nullable): a #GVariant target value, or %NULL * * Formats a detailed action name from @action_name and @target_value. * @@ -12310,7 +12310,7 @@ /** * g_app_info_create_from_commandline: * @commandline: the commandline to use - * @application_name: (allow-none): the application name, or %NULL to use @commandline + * @application_name: (nullable): the application name, or %NULL to use @commandline * @flags: flags that can specify details of the created #GAppInfo * @error: a #GError location to store the error occurring, %NULL to ignore. * @@ -12554,8 +12554,8 @@ /** * g_app_info_launch: * @appinfo: a #GAppInfo - * @files: (allow-none) (element-type GFile): a #GList of #GFile objects - * @launch_context: (allow-none): a #GAppLaunchContext or %NULL + * @files: (nullable) (element-type GFile): a #GList of #GFile objects + * @launch_context: (nullable): a #GAppLaunchContext or %NULL * @error: a #GError * * Launches the application. Passes @files to the launched application @@ -12593,7 +12593,7 @@ /** * g_app_info_launch_default_for_uri: * @uri: the uri to show - * @launch_context: (allow-none): an optional #GAppLaunchContext + * @launch_context: (nullable): an optional #GAppLaunchContext * @error: (nullable): return location for an error, or %NULL * * Utility function that launches the default application @@ -12608,10 +12608,10 @@ /** * g_app_info_launch_default_for_uri_async: * @uri: the uri to show - * @context: (allow-none): an optional #GAppLaunchContext - * cancellable: (allow-none): a #GCancellable - * @callback: (allow-none): a #GASyncReadyCallback to call when the request is done - * @user_data: (allow-none): data to pass to @callback + * @context: (nullable): an optional #GAppLaunchContext + * cancellable: (nullable): a #GCancellable + * @callback: (nullable): a #GASyncReadyCallback to call when the request is done + * @user_data: (nullable): data to pass to @callback * * Async version of g_app_info_launch_default_for_uri(). * @@ -12639,8 +12639,8 @@ /** * g_app_info_launch_uris: * @appinfo: a #GAppInfo - * @uris: (allow-none) (element-type utf8): a #GList containing URIs to launch. - * @launch_context: (allow-none): a #GAppLaunchContext or %NULL + * @uris: (nullable) (element-type utf8): a #GList containing URIs to launch. + * @launch_context: (nullable): a #GAppLaunchContext or %NULL * @error: a #GError * * Launches the application. This passes the @uris to the launched application @@ -13045,7 +13045,7 @@ /** * g_application_command_line_get_arguments: * @cmdline: a #GApplicationCommandLine - * @argc: (out) (allow-none): the length of the arguments array, or %NULL + * @argc: (out) (optional): the length of the arguments array, or %NULL * * Gets the list of arguments that was passed on the command line. * @@ -13501,7 +13501,7 @@ /** * g_application_new: - * @application_id: (allow-none): the application id + * @application_id: (nullable): the application id * @flags: the application flags * * Creates a new #GApplication instance. @@ -13563,7 +13563,7 @@ /** * g_application_register: * @application: a #GApplication - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @error: a pointer to a NULL #GError, or %NULL * * Attempts registration of the application. @@ -13619,7 +13619,7 @@ * g_application_run: * @application: a #GApplication * @argc: the argc from main() (or 0 if @argv is %NULL) - * @argv: (array length=argc) (allow-none): the argv from main(), or %NULL + * @argv: (array length=argc) (nullable): the argv from main(), or %NULL * * Runs the application. * @@ -13705,7 +13705,7 @@ /** * g_application_send_notification: * @application: a #GApplication - * @id: (allow-none): id of the notification, or %NULL + * @id: (nullable): id of the notification, or %NULL * @notification: the #GNotification to send * * Sends a notification on behalf of @application to the desktop shell. @@ -13742,7 +13742,7 @@ /** * g_application_set_action_group: * @application: a #GApplication - * @action_group: (allow-none): a #GActionGroup, or %NULL + * @action_group: (nullable): a #GActionGroup, or %NULL * * This used to be how actions were associated with a #GApplication. * Now there is #GActionMap for that. @@ -13759,7 +13759,7 @@ /** * g_application_set_application_id: * @application: a #GApplication - * @application_id: (allow-none): the identifier for @application + * @application_id: (nullable): the identifier for @application * * Sets the unique identifier for @application. * @@ -13775,7 +13775,7 @@ /** * g_application_set_default: - * @application: (allow-none): the application to set as default, or %NULL + * @application: (nullable): the application to set as default, or %NULL * * Sets or unsets the default application for the process, as returned * by g_application_get_default(). @@ -13988,7 +13988,7 @@ * @callback: a #GAsyncReadyCallback to call when the initialization is * finished * @user_data: the data to pass to callback function - * @first_property_name: (allow-none): the name of the first property, or %NULL if no + * @first_property_name: (nullable): the name of the first property, or %NULL if no * properties * @...: the value of the first property, followed by other property * value pairs, and ended by %NULL. @@ -14126,7 +14126,7 @@ * g_buffered_input_stream_fill: * @stream: a #GBufferedInputStream * @count: the number of bytes that will be read from the stream - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore * @error: location to store the error occurring, or %NULL to ignore * * Tries to read @count bytes from the stream into the buffer. @@ -14164,7 +14164,7 @@ * @stream: a #GBufferedInputStream * @count: the number of bytes that will be read from the stream * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object + * @cancellable: (nullable): optional #GCancellable object * @callback: (scope async): a #GAsyncReadyCallback * @user_data: (closure): a #gpointer * @@ -14264,7 +14264,7 @@ /** * g_buffered_input_stream_read_byte: * @stream: a #GBufferedInputStream - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore * @error: location to store the error occurring, or %NULL to ignore * * Tries to read a single byte from the stream or the buffer. Will block @@ -14362,7 +14362,7 @@ /** * g_bus_get: * @bus_type: a #GBusType - * @cancellable: (allow-none): a #GCancellable or %NULL + * @cancellable: (nullable): a #GCancellable or %NULL * @callback: a #GAsyncReadyCallback to call when the request is satisfied * @user_data: the data to pass to @callback * @@ -14404,7 +14404,7 @@ /** * g_bus_get_sync: * @bus_type: a #GBusType - * @cancellable: (allow-none): a #GCancellable or %NULL + * @cancellable: (nullable): a #GCancellable or %NULL * @error: return location for error or %NULL * * Synchronously connects to the message bus specified by @bus_type. @@ -14435,11 +14435,11 @@ * @bus_type: the type of bus to own a name on * @name: the well-known name to own * @flags: a set of flags from the #GBusNameOwnerFlags enumeration - * @bus_acquired_handler: (allow-none): handler to invoke when connected to the bus of type @bus_type or %NULL - * @name_acquired_handler: (allow-none): handler to invoke when @name is acquired or %NULL - * @name_lost_handler: (allow-none): handler to invoke when @name is lost or %NULL + * @bus_acquired_handler: (nullable): handler to invoke when connected to the bus of type @bus_type or %NULL + * @name_acquired_handler: (nullable): handler to invoke when @name is acquired or %NULL + * @name_lost_handler: (nullable): handler to invoke when @name is lost or %NULL * @user_data: user data to pass to handlers - * @user_data_free_func: (allow-none): function for freeing @user_data or %NULL + * @user_data_free_func: (nullable): function for freeing @user_data or %NULL * * Starts acquiring @name on the bus specified by @bus_type and calls * @name_acquired_handler and @name_lost_handler when the name is @@ -14502,10 +14502,10 @@ * @connection: a #GDBusConnection * @name: the well-known name to own * @flags: a set of flags from the #GBusNameOwnerFlags enumeration - * @name_acquired_handler: (allow-none): handler to invoke when @name is acquired or %NULL - * @name_lost_handler: (allow-none): handler to invoke when @name is lost or %NULL + * @name_acquired_handler: (nullable): handler to invoke when @name is acquired or %NULL + * @name_lost_handler: (nullable): handler to invoke when @name is lost or %NULL * @user_data: user data to pass to handlers - * @user_data_free_func: (allow-none): function for freeing @user_data or %NULL + * @user_data_free_func: (nullable): function for freeing @user_data or %NULL * * Like g_bus_own_name() but takes a #GDBusConnection instead of a * #GBusType. @@ -14521,9 +14521,9 @@ * @connection: a #GDBusConnection * @name: the well-known name to own * @flags: a set of flags from the #GBusNameOwnerFlags enumeration - * @name_acquired_closure: (allow-none): #GClosure to invoke when @name is + * @name_acquired_closure: (nullable): #GClosure to invoke when @name is * acquired or %NULL - * @name_lost_closure: (allow-none): #GClosure to invoke when @name is lost + * @name_lost_closure: (nullable): #GClosure to invoke when @name is lost * or %NULL * * Version of g_bus_own_name_on_connection() using closures instead of @@ -14540,11 +14540,11 @@ * @bus_type: the type of bus to own a name on * @name: the well-known name to own * @flags: a set of flags from the #GBusNameOwnerFlags enumeration - * @bus_acquired_closure: (allow-none): #GClosure to invoke when connected to + * @bus_acquired_closure: (nullable): #GClosure to invoke when connected to * the bus of type @bus_type or %NULL - * @name_acquired_closure: (allow-none): #GClosure to invoke when @name is + * @name_acquired_closure: (nullable): #GClosure to invoke when @name is * acquired or %NULL - * @name_lost_closure: (allow-none): #GClosure to invoke when @name is lost or + * @name_lost_closure: (nullable): #GClosure to invoke when @name is lost or * %NULL * * Version of g_bus_own_name() using closures instead of callbacks for @@ -14581,10 +14581,10 @@ * @bus_type: The type of bus to watch a name on. * @name: The name (well-known or unique) to watch. * @flags: Flags from the #GBusNameWatcherFlags enumeration. - * @name_appeared_handler: (allow-none): Handler to invoke when @name is known to exist or %NULL. - * @name_vanished_handler: (allow-none): Handler to invoke when @name is known to not exist or %NULL. + * @name_appeared_handler: (nullable): Handler to invoke when @name is known to exist or %NULL. + * @name_vanished_handler: (nullable): Handler to invoke when @name is known to not exist or %NULL. * @user_data: User data to pass to handlers. - * @user_data_free_func: (allow-none): Function for freeing @user_data or %NULL. + * @user_data_free_func: (nullable): Function for freeing @user_data or %NULL. * * Starts watching @name on the bus specified by @bus_type and calls * @name_appeared_handler and @name_vanished_handler when the name is @@ -14627,10 +14627,10 @@ * @connection: A #GDBusConnection. * @name: The name (well-known or unique) to watch. * @flags: Flags from the #GBusNameWatcherFlags enumeration. - * @name_appeared_handler: (allow-none): Handler to invoke when @name is known to exist or %NULL. - * @name_vanished_handler: (allow-none): Handler to invoke when @name is known to not exist or %NULL. + * @name_appeared_handler: (nullable): Handler to invoke when @name is known to exist or %NULL. + * @name_vanished_handler: (nullable): Handler to invoke when @name is known to not exist or %NULL. * @user_data: User data to pass to handlers. - * @user_data_free_func: (allow-none): Function for freeing @user_data or %NULL. + * @user_data_free_func: (nullable): Function for freeing @user_data or %NULL. * * Like g_bus_watch_name() but takes a #GDBusConnection instead of a * #GBusType. @@ -14646,9 +14646,9 @@ * @connection: A #GDBusConnection. * @name: The name (well-known or unique) to watch. * @flags: Flags from the #GBusNameWatcherFlags enumeration. - * @name_appeared_closure: (allow-none): #GClosure to invoke when @name is known + * @name_appeared_closure: (nullable): #GClosure to invoke when @name is known * to exist or %NULL. - * @name_vanished_closure: (allow-none): #GClosure to invoke when @name is known + * @name_vanished_closure: (nullable): #GClosure to invoke when @name is known * to not exist or %NULL. * * Version of g_bus_watch_name_on_connection() using closures instead of callbacks for @@ -14665,9 +14665,9 @@ * @bus_type: The type of bus to watch a name on. * @name: The name (well-known or unique) to watch. * @flags: Flags from the #GBusNameWatcherFlags enumeration. - * @name_appeared_closure: (allow-none): #GClosure to invoke when @name is known + * @name_appeared_closure: (nullable): #GClosure to invoke when @name is known * to exist or %NULL. - * @name_vanished_closure: (allow-none): #GClosure to invoke when @name is known + * @name_vanished_closure: (nullable): #GClosure to invoke when @name is known * to not exist or %NULL. * * Version of g_bus_watch_name() using closures instead of callbacks for @@ -14730,7 +14730,7 @@ * @cancellable: A #GCancellable. * @callback: The #GCallback to connect. * @data: Data to pass to @callback. - * @data_destroy_func: (allow-none): Free function for @data or %NULL. + * @data_destroy_func: (nullable): Free function for @data or %NULL. * * Convenience function to connect to the #GCancellable::cancelled * signal. Also handles the race condition that may happen @@ -14759,7 +14759,7 @@ /** * g_cancellable_disconnect: - * @cancellable: (allow-none): A #GCancellable or %NULL. + * @cancellable: (nullable): A #GCancellable or %NULL. * @handler_id: Handler id of the handler to be disconnected, or %0. * * Disconnects a handler from a cancellable instance similar to @@ -14816,7 +14816,7 @@ /** * g_cancellable_is_cancelled: - * @cancellable: (allow-none): a #GCancellable or %NULL + * @cancellable: (nullable): a #GCancellable or %NULL * * Checks if a cancellable job has been cancelled. * @@ -14827,7 +14827,7 @@ /** * g_cancellable_make_pollfd: - * @cancellable: (allow-none): a #GCancellable or %NULL + * @cancellable: (nullable): a #GCancellable or %NULL * @pollfd: a pointer to a #GPollFD * * Creates a #GPollFD corresponding to @cancellable; this can be passed @@ -14933,7 +14933,7 @@ /** * g_cancellable_set_error_if_cancelled: - * @cancellable: (allow-none): a #GCancellable or %NULL + * @cancellable: (nullable): a #GCancellable or %NULL * @error: #GError to append error state to * * If the @cancellable is cancelled, sets the error to notify @@ -14945,7 +14945,7 @@ /** * g_cancellable_source_new: (skip) - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * * Creates a source that triggers if @cancellable is cancelled and * calls its callback of type #GCancellableSourceFunc. This is @@ -15065,7 +15065,7 @@ * [shared-mime-info](http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec) * specification for more on the generic icon name. * - * Returns: (allow-none): the registered generic icon name for the given @type, + * Returns: (nullable): the registered generic icon name for the given @type, * or %NULL if unknown. Free with g_free() * Since: 2.34 */ @@ -15107,10 +15107,10 @@ /** * g_content_type_guess: - * @filename: (allow-none): a string, or %NULL - * @data: (allow-none) (array length=data_size): a stream of data, or %NULL + * @filename: (nullable): a string, or %NULL + * @data: (nullable) (array length=data_size): a stream of data, or %NULL * @data_size: the size of @data - * @result_uncertain: (allow-none) (out): return location for the certainty + * @result_uncertain: (out) (optional): return location for the certainty * of the result, or %NULL * * Guesses the content type based on example data. If the function is @@ -15504,7 +15504,7 @@ /** * g_data_input_stream_read_byte: * @stream: a given #GDataInputStream. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: #GError for error reporting. * * Reads an unsigned 8-bit/1-byte value from @stream. @@ -15517,7 +15517,7 @@ /** * g_data_input_stream_read_int16: * @stream: a given #GDataInputStream. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: #GError for error reporting. * * Reads a 16-bit/2-byte value from @stream. @@ -15533,7 +15533,7 @@ /** * g_data_input_stream_read_int32: * @stream: a given #GDataInputStream. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: #GError for error reporting. * * Reads a signed 32-bit/4-byte value from @stream. @@ -15553,7 +15553,7 @@ /** * g_data_input_stream_read_int64: * @stream: a given #GDataInputStream. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: #GError for error reporting. * * Reads a 64-bit/8-byte value from @stream. @@ -15574,7 +15574,7 @@ * g_data_input_stream_read_line: * @stream: a given #GDataInputStream. * @length: (out): a #gsize to get the length of the data read in. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: #GError for error reporting. * * Reads a line from the data input stream. Note that no encoding @@ -15598,7 +15598,7 @@ * g_data_input_stream_read_line_async: * @stream: a given #GDataInputStream. * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @callback: (scope async): callback to call when the request is satisfied. * @user_data: (closure): the data to pass to callback function. * @@ -15659,7 +15659,7 @@ * g_data_input_stream_read_line_utf8: * @stream: a given #GDataInputStream. * @length: (out): a #gsize to get the length of the data read in. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: #GError for error reporting. * * Reads a UTF-8 encoded line from the data input stream. @@ -15682,7 +15682,7 @@ /** * g_data_input_stream_read_uint16: * @stream: a given #GDataInputStream. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: #GError for error reporting. * * Reads an unsigned 16-bit/2-byte value from @stream. @@ -15698,7 +15698,7 @@ /** * g_data_input_stream_read_uint32: * @stream: a given #GDataInputStream. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: #GError for error reporting. * * Reads an unsigned 32-bit/4-byte value from @stream. @@ -15718,7 +15718,7 @@ /** * g_data_input_stream_read_uint64: * @stream: a given #GDataInputStream. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: #GError for error reporting. * * Reads an unsigned 64-bit/8-byte value from @stream. @@ -15740,7 +15740,7 @@ * @stream: a given #GDataInputStream. * @stop_chars: characters to terminate the read. * @length: (out): a #gsize to get the length of the data read in. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: #GError for error reporting. * * Reads a string from the data input stream, up to the first @@ -15767,7 +15767,7 @@ * @stream: a given #GDataInputStream. * @stop_chars: characters to terminate the read. * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @callback: (scope async): callback to call when the request is satisfied. * @user_data: (closure): the data to pass to callback function. * @@ -15816,7 +15816,7 @@ * @stop_chars_len: length of @stop_chars. May be -1 if @stop_chars is * nul-terminated * @length: (out): a #gsize to get the length of the data read in - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore * @error: #GError for error reporting * * Reads a string from the data input stream, up to the first @@ -15845,7 +15845,7 @@ * @stop_chars_len: length of @stop_chars. May be -1 if @stop_chars is * nul-terminated * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore * @callback: (scope async): callback to call when the request is satisfied * @user_data: (closure): the data to pass to callback function * @@ -15937,7 +15937,7 @@ * g_data_output_stream_put_byte: * @stream: a #GDataOutputStream. * @data: a #guchar. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: a #GError, %NULL to ignore. * * Puts a byte into the output stream. @@ -15950,7 +15950,7 @@ * g_data_output_stream_put_int16: * @stream: a #GDataOutputStream. * @data: a #gint16. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: a #GError, %NULL to ignore. * * Puts a signed 16-bit integer into the output stream. @@ -15963,7 +15963,7 @@ * g_data_output_stream_put_int32: * @stream: a #GDataOutputStream. * @data: a #gint32. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: a #GError, %NULL to ignore. * * Puts a signed 32-bit integer into the output stream. @@ -15976,7 +15976,7 @@ * g_data_output_stream_put_int64: * @stream: a #GDataOutputStream. * @data: a #gint64. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: a #GError, %NULL to ignore. * * Puts a signed 64-bit integer into the stream. @@ -15989,7 +15989,7 @@ * g_data_output_stream_put_string: * @stream: a #GDataOutputStream. * @str: a string. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: a #GError, %NULL to ignore. * * Puts a string into the output stream. @@ -16002,7 +16002,7 @@ * g_data_output_stream_put_uint16: * @stream: a #GDataOutputStream. * @data: a #guint16. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: a #GError, %NULL to ignore. * * Puts an unsigned 16-bit integer into the output stream. @@ -16015,7 +16015,7 @@ * g_data_output_stream_put_uint32: * @stream: a #GDataOutputStream. * @data: a #guint32. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: a #GError, %NULL to ignore. * * Puts an unsigned 32-bit integer into the stream. @@ -16028,7 +16028,7 @@ * g_data_output_stream_put_uint64: * @stream: a #GDataOutputStream. * @data: a #guint64. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: a #GError, %NULL to ignore. * * Puts an unsigned 64-bit integer into the stream. @@ -16148,7 +16148,7 @@ * @flags: an int containing #GSocketMsgFlags flags for the overall operation * @timeout: the maximum time (in microseconds) to wait, 0 to not block, or -1 * to block indefinitely - * @cancellable: (allow-none): a %GCancellable + * @cancellable: (nullable): a %GCancellable * @error: return location for a #GError * * Receive one or more data messages from @datagram_based in one go. @@ -16319,7 +16319,7 @@ /** * g_dbus_address_get_for_bus_sync: * @bus_type: a #GBusType - * @cancellable: (allow-none): a #GCancellable or %NULL + * @cancellable: (nullable): a #GCancellable or %NULL * @error: return location for error or %NULL * * Synchronously looks up the D-Bus address for the well-known message @@ -16335,7 +16335,7 @@ /** * g_dbus_address_get_stream: * @address: A valid D-Bus address. - * @cancellable: (allow-none): A #GCancellable or %NULL. + * @cancellable: (nullable): A #GCancellable or %NULL. * @callback: A #GAsyncReadyCallback to call when the request is satisfied. * @user_data: Data to pass to @callback. * @@ -16371,7 +16371,7 @@ * g_dbus_address_get_stream_sync: * @address: A valid D-Bus address. * @out_guid: (optional) (out): %NULL or return location to store the GUID extracted from @address, if any. - * @cancellable: (allow-none): A #GCancellable or %NULL. + * @cancellable: (nullable): A #GCancellable or %NULL. * @error: Return location for error or %NULL. * * Synchronously connects to an endpoint specified by @address and @@ -16388,7 +16388,7 @@ /** * g_dbus_annotation_info_lookup: - * @annotations: (array zero-terminated=1) (allow-none): A %NULL-terminated array of annotations or %NULL. + * @annotations: (array zero-terminated=1) (nullable): A %NULL-terminated array of annotations or %NULL. * @name: The name of the annotation to look up. * * Looks up the value of an annotation. @@ -16464,7 +16464,7 @@ * g_dbus_auth_observer_authorize_authenticated_peer: * @observer: A #GDBusAuthObserver. * @stream: A #GIOStream for the #GDBusConnection. - * @credentials: (allow-none): Credentials received from the peer or %NULL. + * @credentials: (nullable): Credentials received from the peer or %NULL. * * Emits the #GDBusAuthObserver::authorize-authenticated-peer signal on @observer. * @@ -16528,19 +16528,19 @@ /** * g_dbus_connection_call: * @connection: a #GDBusConnection - * @bus_name: (allow-none): a unique or well-known bus name or %NULL if + * @bus_name: (nullable): a unique or well-known bus name or %NULL if * @connection is not a message bus connection * @object_path: path of remote object * @interface_name: D-Bus interface to invoke method on * @method_name: the name of the method to invoke - * @parameters: (allow-none): a #GVariant tuple with parameters for the method + * @parameters: (nullable): a #GVariant tuple with parameters for the method * or %NULL if not passing parameters - * @reply_type: (allow-none): the expected type of the reply, or %NULL + * @reply_type: (nullable): the expected type of the reply, or %NULL * @flags: flags from the #GDBusCallFlags enumeration * @timeout_msec: the timeout in milliseconds, -1 to use the default * timeout or %G_MAXINT for no timeout - * @cancellable: (allow-none): a #GCancellable or %NULL - * @callback: (allow-none): a #GAsyncReadyCallback to call when the request + * @cancellable: (nullable): a #GCancellable or %NULL + * @callback: (nullable): a #GAsyncReadyCallback to call when the request * is satisfied or %NULL if you don't care about the result of the * method invocation * @user_data: the data to pass to @callback @@ -16610,18 +16610,18 @@ /** * g_dbus_connection_call_sync: * @connection: a #GDBusConnection - * @bus_name: (allow-none): a unique or well-known bus name or %NULL if + * @bus_name: (nullable): a unique or well-known bus name or %NULL if * @connection is not a message bus connection * @object_path: path of remote object * @interface_name: D-Bus interface to invoke method on * @method_name: the name of the method to invoke - * @parameters: (allow-none): a #GVariant tuple with parameters for the method + * @parameters: (nullable): a #GVariant tuple with parameters for the method * or %NULL if not passing parameters - * @reply_type: (allow-none): the expected type of the reply, or %NULL + * @reply_type: (nullable): the expected type of the reply, or %NULL * @flags: flags from the #GDBusCallFlags enumeration * @timeout_msec: the timeout in milliseconds, -1 to use the default * timeout or %G_MAXINT for no timeout - * @cancellable: (allow-none): a #GCancellable or %NULL + * @cancellable: (nullable): a #GCancellable or %NULL * @error: return location for error or %NULL * * Synchronously invokes the @method_name method on the @@ -16670,20 +16670,20 @@ /** * g_dbus_connection_call_with_unix_fd_list: * @connection: a #GDBusConnection - * @bus_name: (allow-none): a unique or well-known bus name or %NULL if + * @bus_name: (nullable): a unique or well-known bus name or %NULL if * @connection is not a message bus connection * @object_path: path of remote object * @interface_name: D-Bus interface to invoke method on * @method_name: the name of the method to invoke - * @parameters: (allow-none): a #GVariant tuple with parameters for the method + * @parameters: (nullable): a #GVariant tuple with parameters for the method * or %NULL if not passing parameters - * @reply_type: (allow-none): the expected type of the reply, or %NULL + * @reply_type: (nullable): the expected type of the reply, or %NULL * @flags: flags from the #GDBusCallFlags enumeration * @timeout_msec: the timeout in milliseconds, -1 to use the default * timeout or %G_MAXINT for no timeout - * @fd_list: (allow-none): a #GUnixFDList or %NULL - * @cancellable: (allow-none): a #GCancellable or %NULL - * @callback: (allow-none): a #GAsyncReadyCallback to call when the request is + * @fd_list: (nullable): a #GUnixFDList or %NULL + * @cancellable: (nullable): a #GCancellable or %NULL + * @callback: (nullable): a #GAsyncReadyCallback to call when the request is * satisfied or %NULL if you don't * care about the result of the * method invocation * @user_data: The data to pass to @callback. @@ -16699,7 +16699,7 @@ /** * g_dbus_connection_call_with_unix_fd_list_finish: * @connection: a #GDBusConnection - * @out_fd_list: (out) (allow-none): return location for a #GUnixFDList or %NULL + * @out_fd_list: (out) (optional): return location for a #GUnixFDList or %NULL * @res: a #GAsyncResult obtained from the #GAsyncReadyCallback passed to * g_dbus_connection_call_with_unix_fd_list() * @error: return location for error or %NULL @@ -16715,20 +16715,20 @@ /** * g_dbus_connection_call_with_unix_fd_list_sync: * @connection: a #GDBusConnection - * @bus_name: (allow-none): a unique or well-known bus name or %NULL + * @bus_name: (nullable): a unique or well-known bus name or %NULL * if @connection is not a message bus connection * @object_path: path of remote object * @interface_name: D-Bus interface to invoke method on * @method_name: the name of the method to invoke - * @parameters: (allow-none): a #GVariant tuple with parameters for + * @parameters: (nullable): a #GVariant tuple with parameters for * the method or %NULL if not passing parameters - * @reply_type: (allow-none): the expected type of the reply, or %NULL + * @reply_type: (nullable): the expected type of the reply, or %NULL * @flags: flags from the #GDBusCallFlags enumeration * @timeout_msec: the timeout in milliseconds, -1 to use the default * timeout or %G_MAXINT for no timeout - * @fd_list: (allow-none): a #GUnixFDList or %NULL - * @out_fd_list: (out) (allow-none): return location for a #GUnixFDList or %NULL - * @cancellable: (allow-none): a #GCancellable or %NULL + * @fd_list: (nullable): a #GUnixFDList or %NULL + * @out_fd_list: (out) (optional): return location for a #GUnixFDList or %NULL + * @cancellable: (nullable): a #GCancellable or %NULL * @error: return location for error or %NULL * * Like g_dbus_connection_call_sync() but also takes and returns #GUnixFDList objects. @@ -16744,8 +16744,8 @@ /** * g_dbus_connection_close: * @connection: a #GDBusConnection - * @cancellable: (allow-none): a #GCancellable or %NULL - * @callback: (allow-none): a #GAsyncReadyCallback to call when the request is + * @cancellable: (nullable): a #GCancellable or %NULL + * @callback: (nullable): a #GAsyncReadyCallback to call when the request is * satisfied or %NULL if you don't care about the result * @user_data: The data to pass to @callback * @@ -16795,7 +16795,7 @@ /** * g_dbus_connection_close_sync: * @connection: a #GDBusConnection - * @cancellable: (allow-none): a #GCancellable or %NULL + * @cancellable: (nullable): a #GCancellable or %NULL * @error: return location for error or %NULL * * Synchronously closees @connection. The calling thread is blocked @@ -16811,12 +16811,12 @@ /** * g_dbus_connection_emit_signal: * @connection: a #GDBusConnection - * @destination_bus_name: (allow-none): the unique bus name for the destination + * @destination_bus_name: (nullable): the unique bus name for the destination * for the signal or %NULL to emit to all listeners * @object_path: path of remote object * @interface_name: D-Bus interface to emit a signal on * @signal_name: the name of the signal to emit - * @parameters: (allow-none): a #GVariant tuple with parameters for the signal + * @parameters: (nullable): a #GVariant tuple with parameters for the signal * or %NULL if not passing parameters * @error: Return location for error or %NULL * @@ -16893,8 +16893,8 @@ /** * g_dbus_connection_flush: * @connection: a #GDBusConnection - * @cancellable: (allow-none): a #GCancellable or %NULL - * @callback: (allow-none): a #GAsyncReadyCallback to call when the + * @cancellable: (nullable): a #GCancellable or %NULL + * @callback: (nullable): a #GAsyncReadyCallback to call when the * request is satisfied or %NULL if you don't care about the result * @user_data: The data to pass to @callback * @@ -16934,7 +16934,7 @@ /** * g_dbus_connection_flush_sync: * @connection: a #GDBusConnection - * @cancellable: (allow-none): a #GCancellable or %NULL + * @cancellable: (nullable): a #GCancellable or %NULL * @error: return location for error or %NULL * * Synchronously flushes @connection. The calling thread is blocked @@ -17065,10 +17065,10 @@ /** * g_dbus_connection_new: * @stream: a #GIOStream - * @guid: (allow-none): the GUID to use if a authenticating as a server or %NULL + * @guid: (nullable): the GUID to use if a authenticating as a server or %NULL * @flags: flags describing how to make the connection - * @observer: (allow-none): a #GDBusAuthObserver or %NULL - * @cancellable: (allow-none): a #GCancellable or %NULL + * @observer: (nullable): a #GDBusAuthObserver or %NULL + * @cancellable: (nullable): a #GCancellable or %NULL * @callback: a #GAsyncReadyCallback to call when the request is satisfied * @user_data: the data to pass to @callback * @@ -17115,8 +17115,8 @@ * g_dbus_connection_new_for_address: * @address: a D-Bus address * @flags: flags describing how to make the connection - * @observer: (allow-none): a #GDBusAuthObserver or %NULL - * @cancellable: (allow-none): a #GCancellable or %NULL + * @observer: (nullable): a #GDBusAuthObserver or %NULL + * @cancellable: (nullable): a #GCancellable or %NULL * @callback: a #GAsyncReadyCallback to call when the request is satisfied * @user_data: the data to pass to @callback * @@ -17163,8 +17163,8 @@ * g_dbus_connection_new_for_address_sync: * @address: a D-Bus address * @flags: flags describing how to make the connection - * @observer: (allow-none): a #GDBusAuthObserver or %NULL - * @cancellable: (allow-none): a #GCancellable or %NULL + * @observer: (nullable): a #GDBusAuthObserver or %NULL + * @cancellable: (nullable): a #GCancellable or %NULL * @error: return location for error or %NULL * * Synchronously connects and sets up a D-Bus client connection for @@ -17192,10 +17192,10 @@ /** * g_dbus_connection_new_sync: * @stream: a #GIOStream - * @guid: (allow-none): the GUID to use if a authenticating as a server or %NULL + * @guid: (nullable): the GUID to use if a authenticating as a server or %NULL * @flags: flags describing how to make the connection - * @observer: (allow-none): a #GDBusAuthObserver or %NULL - * @cancellable: (allow-none): a #GCancellable or %NULL + * @observer: (nullable): a #GDBusAuthObserver or %NULL + * @cancellable: (nullable): a #GCancellable or %NULL * @error: return location for error or %NULL * * Synchronously sets up a D-Bus connection for exchanging D-Bus messages @@ -17224,8 +17224,8 @@ * @connection: a #GDBusConnection * @object_path: the object path to register at * @interface_info: introspection data for the interface - * @vtable: (allow-none): a #GDBusInterfaceVTable to call into or %NULL - * @user_data: (allow-none): data to pass to functions in @vtable + * @vtable: (nullable): a #GDBusInterfaceVTable to call into or %NULL + * @user_data: (nullable): data to pass to functions in @vtable * @user_data_free_func: function to call when the object path is unregistered * @error: return location for error or %NULL * @@ -17368,7 +17368,7 @@ * @connection: a #GDBusConnection * @message: a #GDBusMessage * @flags: flags affecting how the message is sent - * @out_serial: (out) (allow-none): return location for serial number assigned + * @out_serial: (out) (optional): return location for serial number assigned * to @message when sending it or %NULL * @error: Return location for error or %NULL * @@ -17405,10 +17405,10 @@ * @flags: flags affecting how the message is sent * @timeout_msec: the timeout in milliseconds, -1 to use the default * timeout or %G_MAXINT for no timeout - * @out_serial: (out) (allow-none): return location for serial number assigned + * @out_serial: (out) (optional): return location for serial number assigned * to @message when sending it or %NULL - * @cancellable: (allow-none): a #GCancellable or %NULL - * @callback: (allow-none): a #GAsyncReadyCallback to call when the request + * @cancellable: (nullable): a #GCancellable or %NULL + * @callback: (nullable): a #GAsyncReadyCallback to call when the request * is satisfied or %NULL if you don't care about the result * @user_data: The data to pass to @callback * @@ -17474,9 +17474,9 @@ * @flags: flags affecting how the message is sent. * @timeout_msec: the timeout in milliseconds, -1 to use the default * timeout or %G_MAXINT for no timeout - * @out_serial: (out) (allow-none): return location for serial number + * @out_serial: (out) (optional): return location for serial number * assigned to @message when sending it or %NULL - * @cancellable: (allow-none): a #GCancellable or %NULL + * @cancellable: (nullable): a #GCancellable or %NULL * @error: return location for error or %NULL * * Synchronously sends @message to the peer represented by @connection @@ -17538,21 +17538,21 @@ /** * g_dbus_connection_signal_subscribe: * @connection: a #GDBusConnection - * @sender: (allow-none): sender name to match on (unique or well-known name) + * @sender: (nullable): sender name to match on (unique or well-known name) * or %NULL to listen from all senders - * @interface_name: (allow-none): D-Bus interface name to match on or %NULL to + * @interface_name: (nullable): D-Bus interface name to match on or %NULL to * match on all interfaces - * @member: (allow-none): D-Bus signal name to match on or %NULL to match on + * @member: (nullable): D-Bus signal name to match on or %NULL to match on * all signals - * @object_path: (allow-none): object path to match on or %NULL to match on + * @object_path: (nullable): object path to match on or %NULL to match on * all object paths - * @arg0: (allow-none): contents of first string argument to match on or %NULL + * @arg0: (nullable): contents of first string argument to match on or %NULL * to match on all kinds of arguments * @flags: #GDBusSignalFlags describing how arg0 is used in subscribing to the * signal * @callback: callback to invoke when there is a signal matching the requested data * @user_data: user data to pass to @callback - * @user_data_free_func: (allow-none): function to free @user_data with when + * @user_data_free_func: (nullable): function to free @user_data with when * subscription is removed or %NULL * * Subscribes to signals on @connection and invokes @callback with a whenever @@ -17794,7 +17794,7 @@ * @error: A pointer to a #GError or %NULL. * @dbus_error_name: D-Bus error name. * @dbus_error_message: D-Bus error message. - * @format: (allow-none): printf()-style format to prepend to @dbus_error_message or %NULL. + * @format: (nullable): printf()-style format to prepend to @dbus_error_message or %NULL. * @...: Arguments for @format. * * Does nothing if @error is %NULL. Otherwise sets *@error to @@ -17810,7 +17810,7 @@ * @error: A pointer to a #GError or %NULL. * @dbus_error_name: D-Bus error name. * @dbus_error_message: D-Bus error message. - * @format: (allow-none): printf()-style format to prepend to @dbus_error_message or %NULL. + * @format: (nullable): printf()-style format to prepend to @dbus_error_message or %NULL. * @var_args: Arguments for @format. * * Like g_dbus_error_set_dbus_error() but intended for language bindings. @@ -18080,7 +18080,7 @@ /** * g_dbus_interface_set_object: * @interface_: An exported D-Bus interface. - * @object: (allow-none): A #GDBusObject or %NULL. + * @object: (nullable): A #GDBusObject or %NULL. * * Sets the #GDBusObject for @interface_ to @object. * @@ -18667,9 +18667,9 @@ /** * g_dbus_message_new_method_call: - * @name: (allow-none): A valid D-Bus name or %NULL. + * @name: (nullable): A valid D-Bus name or %NULL. * @path: A valid object path. - * @interface_: (allow-none): A valid D-Bus interface name or %NULL. + * @interface_: (nullable): A valid D-Bus interface name or %NULL. * @method: A valid method name. * * Creates a new #GDBusMessage for a method call. @@ -18853,7 +18853,7 @@ * g_dbus_message_set_header: * @message: A #GDBusMessage. * @header_field: A 8-bit unsigned integer (typically a value from the #GDBusMessageHeaderField enumeration) - * @value: (allow-none): A #GVariant to set the header field or %NULL to clear the header field. + * @value: (nullable): A #GVariant to set the header field or %NULL to clear the header field. * * Sets a header field on @message. * @@ -18965,7 +18965,7 @@ /** * g_dbus_message_set_unix_fd_list: * @message: A #GDBusMessage. - * @fd_list: (allow-none): A #GUnixFDList or %NULL. + * @fd_list: (nullable): A #GUnixFDList or %NULL. * * Sets the UNIX file descriptors associated with @message. As a * side-effect the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header @@ -19183,7 +19183,9 @@ * * Finishes handling a D-Bus method call by returning an error. * - * This method will free @invocation, you cannot use it afterwards. + * This method will take ownership of @invocation. See + * #GDBusInterfaceVTable for more information about the ownership of + * @invocation. * * Since: 2.26 */ @@ -19210,7 +19212,9 @@ * always register errors with g_dbus_error_register_error() * or use g_dbus_method_invocation_return_dbus_error(). * - * This method will free @invocation, you cannot use it afterwards. + * This method will take ownership of @invocation. See + * #GDBusInterfaceVTable for more information about the ownership of + * @invocation. * * Since 2.48, if the method call requested for a reply not to be sent * then this call will free @invocation but otherwise do nothing (as per @@ -19229,7 +19233,9 @@ * * Like g_dbus_method_invocation_return_error() but without printf()-style formatting. * - * This method will free @invocation, you cannot use it afterwards. + * This method will take ownership of @invocation. See + * #GDBusInterfaceVTable for more information about the ownership of + * @invocation. * * Since: 2.26 */ @@ -19246,7 +19252,9 @@ * Like g_dbus_method_invocation_return_error() but intended for * language bindings. * - * This method will free @invocation, you cannot use it afterwards. + * This method will take ownership of @invocation. See + * #GDBusInterfaceVTable for more information about the ownership of + * @invocation. * * Since: 2.26 */ @@ -19260,7 +19268,9 @@ * Like g_dbus_method_invocation_return_error() but takes a #GError * instead of the error domain, error code and message. * - * This method will free @invocation, you cannot use it afterwards. + * This method will take ownership of @invocation. See + * #GDBusInterfaceVTable for more information about the ownership of + * @invocation. * * Since: 2.26 */ @@ -19269,14 +19279,16 @@ /** * g_dbus_method_invocation_return_value: * @invocation: (transfer full): A #GDBusMethodInvocation. - * @parameters: (allow-none): A #GVariant tuple with out parameters for the method or %NULL if not passing any parameters. + * @parameters: (nullable): A #GVariant tuple with out parameters for the method or %NULL if not passing any parameters. * * Finishes handling a D-Bus method call by returning @parameters. * If the @parameters GVariant is floating, it is consumed. * * It is an error if @parameters is not of the right format. * - * This method will free @invocation, you cannot use it afterwards. + * This method will take ownership of @invocation. See + * #GDBusInterfaceVTable for more information about the ownership of + * @invocation. * * Since 2.48, if the method call requested for a reply not to be sent * then this call will sink @parameters and free @invocation, but @@ -19290,14 +19302,16 @@ /** * g_dbus_method_invocation_return_value_with_unix_fd_list: * @invocation: (transfer full): A #GDBusMethodInvocation. - * @parameters: (allow-none): A #GVariant tuple with out parameters for the method or %NULL if not passing any parameters. - * @fd_list: (allow-none): A #GUnixFDList or %NULL. + * @parameters: (nullable): A #GVariant tuple with out parameters for the method or %NULL if not passing any parameters. + * @fd_list: (nullable): A #GUnixFDList or %NULL. * * Like g_dbus_method_invocation_return_value() but also takes a #GUnixFDList. * * This method is only available on UNIX. * - * This method will free @invocation, you cannot use it afterwards. + * This method will take ownership of @invocation. See + * #GDBusInterfaceVTable for more information about the ownership of + * @invocation. * * Since: 2.30 */ @@ -19311,7 +19325,9 @@ * Like g_dbus_method_invocation_return_gerror() but takes ownership * of @error so the caller does not need to free it. * - * This method will free @invocation, you cannot use it afterwards. + * This method will take ownership of @invocation. See + * #GDBusInterfaceVTable for more information about the ownership of + * @invocation. * * Since: 2.30 */ @@ -19486,10 +19502,10 @@ * @flags: Zero or more flags from the #GDBusObjectManagerClientFlags enumeration. * @name: The owner of the control object (unique or well-known name). * @object_path: The object path of the control object. - * @get_proxy_type_func: (allow-none): A #GDBusProxyTypeFunc function or %NULL to always construct #GDBusProxy proxies. + * @get_proxy_type_func: (nullable): A #GDBusProxyTypeFunc function or %NULL to always construct #GDBusProxy proxies. * @get_proxy_type_user_data: User data to pass to @get_proxy_type_func. - * @get_proxy_type_destroy_notify: (allow-none): Free function for @get_proxy_type_user_data or %NULL. - * @cancellable: (allow-none): A #GCancellable or %NULL + * @get_proxy_type_destroy_notify: (nullable): Free function for @get_proxy_type_user_data or %NULL. + * @cancellable: (nullable): A #GCancellable or %NULL * @callback: A #GAsyncReadyCallback to call when the request is satisfied. * @user_data: The data to pass to @callback. * @@ -19526,10 +19542,10 @@ * @flags: Zero or more flags from the #GDBusObjectManagerClientFlags enumeration. * @name: The owner of the control object (unique or well-known name). * @object_path: The object path of the control object. - * @get_proxy_type_func: (allow-none): A #GDBusProxyTypeFunc function or %NULL to always construct #GDBusProxy proxies. + * @get_proxy_type_func: (nullable): A #GDBusProxyTypeFunc function or %NULL to always construct #GDBusProxy proxies. * @get_proxy_type_user_data: User data to pass to @get_proxy_type_func. - * @get_proxy_type_destroy_notify: (allow-none): Free function for @get_proxy_type_user_data or %NULL. - * @cancellable: (allow-none): A #GCancellable or %NULL + * @get_proxy_type_destroy_notify: (nullable): Free function for @get_proxy_type_user_data or %NULL. + * @cancellable: (nullable): A #GCancellable or %NULL * @callback: A #GAsyncReadyCallback to call when the request is satisfied. * @user_data: The data to pass to @callback. * @@ -19567,10 +19583,10 @@ * @flags: Zero or more flags from the #GDBusObjectManagerClientFlags enumeration. * @name: The owner of the control object (unique or well-known name). * @object_path: The object path of the control object. - * @get_proxy_type_func: (allow-none): A #GDBusProxyTypeFunc function or %NULL to always construct #GDBusProxy proxies. + * @get_proxy_type_func: (nullable): A #GDBusProxyTypeFunc function or %NULL to always construct #GDBusProxy proxies. * @get_proxy_type_user_data: User data to pass to @get_proxy_type_func. - * @get_proxy_type_destroy_notify: (allow-none): Free function for @get_proxy_type_user_data or %NULL. - * @cancellable: (allow-none): A #GCancellable or %NULL + * @get_proxy_type_destroy_notify: (nullable): Free function for @get_proxy_type_user_data or %NULL. + * @cancellable: (nullable): A #GCancellable or %NULL * @error: Return location for error or %NULL. * * Like g_dbus_object_manager_client_new_sync() but takes a #GBusType instead @@ -19591,12 +19607,12 @@ * g_dbus_object_manager_client_new_sync: * @connection: A #GDBusConnection. * @flags: Zero or more flags from the #GDBusObjectManagerClientFlags enumeration. - * @name: (allow-none): The owner of the control object (unique or well-known name), or %NULL when not using a message bus connection. + * @name: (nullable): The owner of the control object (unique or well-known name), or %NULL when not using a message bus connection. * @object_path: The object path of the control object. - * @get_proxy_type_func: (allow-none): A #GDBusProxyTypeFunc function or %NULL to always construct #GDBusProxy proxies. + * @get_proxy_type_func: (nullable): A #GDBusProxyTypeFunc function or %NULL to always construct #GDBusProxy proxies. * @get_proxy_type_user_data: User data to pass to @get_proxy_type_func. - * @get_proxy_type_destroy_notify: (allow-none): Free function for @get_proxy_type_user_data or %NULL. - * @cancellable: (allow-none): A #GCancellable or %NULL + * @get_proxy_type_destroy_notify: (nullable): Free function for @get_proxy_type_user_data or %NULL. + * @cancellable: (nullable): A #GCancellable or %NULL * @error: Return location for error or %NULL. * * Creates a new #GDBusObjectManagerClient object. @@ -19744,7 +19760,7 @@ /** * g_dbus_object_manager_server_set_connection: * @manager: A #GDBusObjectManagerServer. - * @connection: (allow-none): A #GDBusConnection or %NULL. + * @connection: (nullable): A #GDBusConnection or %NULL. * * Exports all objects managed by @manager on @connection. If * @connection is %NULL, stops exporting objects. @@ -19896,12 +19912,12 @@ * g_dbus_proxy_call: * @proxy: A #GDBusProxy. * @method_name: Name of method to invoke. - * @parameters: (allow-none): A #GVariant tuple with parameters for the signal or %NULL if not passing parameters. + * @parameters: (nullable): A #GVariant tuple with parameters for the signal or %NULL if not passing parameters. * @flags: Flags from the #GDBusCallFlags enumeration. * @timeout_msec: The timeout in milliseconds (with %G_MAXINT meaning * "infinite") or -1 to use the proxy default timeout. - * @cancellable: (allow-none): A #GCancellable or %NULL. - * @callback: (allow-none): A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't + * @cancellable: (nullable): A #GCancellable or %NULL. + * @callback: (nullable): A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't * care about the result of the method invocation. * @user_data: The data to pass to @callback. * @@ -19970,12 +19986,12 @@ * g_dbus_proxy_call_sync: * @proxy: A #GDBusProxy. * @method_name: Name of method to invoke. - * @parameters: (allow-none): A #GVariant tuple with parameters for the signal + * @parameters: (nullable): A #GVariant tuple with parameters for the signal * or %NULL if not passing parameters. * @flags: Flags from the #GDBusCallFlags enumeration. * @timeout_msec: The timeout in milliseconds (with %G_MAXINT meaning * "infinite") or -1 to use the proxy default timeout. - * @cancellable: (allow-none): A #GCancellable or %NULL. + * @cancellable: (nullable): A #GCancellable or %NULL. * @error: Return location for error or %NULL. * * Synchronously invokes the @method_name method on @proxy. @@ -20023,13 +20039,13 @@ * g_dbus_proxy_call_with_unix_fd_list: * @proxy: A #GDBusProxy. * @method_name: Name of method to invoke. - * @parameters: (allow-none): A #GVariant tuple with parameters for the signal or %NULL if not passing parameters. + * @parameters: (nullable): A #GVariant tuple with parameters for the signal or %NULL if not passing parameters. * @flags: Flags from the #GDBusCallFlags enumeration. * @timeout_msec: The timeout in milliseconds (with %G_MAXINT meaning * "infinite") or -1 to use the proxy default timeout. - * @fd_list: (allow-none): A #GUnixFDList or %NULL. - * @cancellable: (allow-none): A #GCancellable or %NULL. - * @callback: (allow-none): A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't + * @fd_list: (nullable): A #GUnixFDList or %NULL. + * @cancellable: (nullable): A #GCancellable or %NULL. + * @callback: (nullable): A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't * care about the result of the method invocation. * @user_data: The data to pass to @callback. * @@ -20044,7 +20060,7 @@ /** * g_dbus_proxy_call_with_unix_fd_list_finish: * @proxy: A #GDBusProxy. - * @out_fd_list: (out) (allow-none): Return location for a #GUnixFDList or %NULL. + * @out_fd_list: (out) (optional): Return location for a #GUnixFDList or %NULL. * @res: A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_proxy_call_with_unix_fd_list(). * @error: Return location for error or %NULL. * @@ -20060,14 +20076,14 @@ * g_dbus_proxy_call_with_unix_fd_list_sync: * @proxy: A #GDBusProxy. * @method_name: Name of method to invoke. - * @parameters: (allow-none): A #GVariant tuple with parameters for the signal + * @parameters: (nullable): A #GVariant tuple with parameters for the signal * or %NULL if not passing parameters. * @flags: Flags from the #GDBusCallFlags enumeration. * @timeout_msec: The timeout in milliseconds (with %G_MAXINT meaning * "infinite") or -1 to use the proxy default timeout. - * @fd_list: (allow-none): A #GUnixFDList or %NULL. - * @out_fd_list: (out) (allow-none): Return location for a #GUnixFDList or %NULL. - * @cancellable: (allow-none): A #GCancellable or %NULL. + * @fd_list: (nullable): A #GUnixFDList or %NULL. + * @out_fd_list: (out) (optional): Return location for a #GUnixFDList or %NULL. + * @cancellable: (nullable): A #GCancellable or %NULL. * @error: Return location for error or %NULL. * * Like g_dbus_proxy_call_sync() but also takes and returns #GUnixFDList objects. @@ -20214,11 +20230,11 @@ * g_dbus_proxy_new: * @connection: A #GDBusConnection. * @flags: Flags used when constructing the proxy. - * @info: (allow-none): A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL. - * @name: (allow-none): A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. + * @info: (nullable): A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL. + * @name: (nullable): A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. * @object_path: An object path. * @interface_name: A D-Bus interface name. - * @cancellable: (allow-none): A #GCancellable or %NULL. + * @cancellable: (nullable): A #GCancellable or %NULL. * @callback: Callback function to invoke when the proxy is ready. * @user_data: User data to pass to @callback. * @@ -20266,11 +20282,11 @@ * g_dbus_proxy_new_for_bus: * @bus_type: A #GBusType. * @flags: Flags used when constructing the proxy. - * @info: (allow-none): A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL. + * @info: (nullable): A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL. * @name: A bus name (well-known or unique). * @object_path: An object path. * @interface_name: A D-Bus interface name. - * @cancellable: (allow-none): A #GCancellable or %NULL. + * @cancellable: (nullable): A #GCancellable or %NULL. * @callback: Callback function to invoke when the proxy is ready. * @user_data: User data to pass to @callback. * @@ -20298,12 +20314,12 @@ * g_dbus_proxy_new_for_bus_sync: * @bus_type: A #GBusType. * @flags: Flags used when constructing the proxy. - * @info: (allow-none): A #GDBusInterfaceInfo specifying the minimal interface + * @info: (nullable): A #GDBusInterfaceInfo specifying the minimal interface * that @proxy conforms to or %NULL. * @name: A bus name (well-known or unique). * @object_path: An object path. * @interface_name: A D-Bus interface name. - * @cancellable: (allow-none): A #GCancellable or %NULL. + * @cancellable: (nullable): A #GCancellable or %NULL. * @error: Return location for error or %NULL. * * Like g_dbus_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection. @@ -20319,12 +20335,12 @@ * g_dbus_proxy_new_sync: * @connection: A #GDBusConnection. * @flags: Flags used when constructing the proxy. - * @info: (allow-none): A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL. - * @name: (allow-none): A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. + * @info: (nullable): A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL. + * @name: (nullable): A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. * @object_path: An object path. * @interface_name: A D-Bus interface name. - * @cancellable: (allow-none): A #GCancellable or %NULL. - * @error: (allow-none): Return location for error or %NULL. + * @cancellable: (nullable): A #GCancellable or %NULL. + * @error: (nullable): Return location for error or %NULL. * * Creates a proxy for accessing @interface_name on the remote object * at @object_path owned by @name at @connection and synchronously @@ -20354,7 +20370,7 @@ * g_dbus_proxy_set_cached_property: * @proxy: A #GDBusProxy * @property_name: Property name. - * @value: (allow-none): Value for the property or %NULL to remove it from the cache. + * @value: (nullable): Value for the property or %NULL to remove it from the cache. * * If @value is not %NULL, sets the cached value for the property with * name @property_name to the value in @value. @@ -20412,7 +20428,7 @@ /** * g_dbus_proxy_set_interface_info: * @proxy: A #GDBusProxy - * @info: (allow-none): Minimum interface this proxy conforms to or %NULL to unset. + * @info: (nullable): Minimum interface this proxy conforms to or %NULL to unset. * * Ensure that interactions with @proxy conform to the given * interface. See the #GDBusProxy:g-interface-info property for more @@ -20473,8 +20489,8 @@ * @address: A D-Bus address. * @flags: Flags from the #GDBusServerFlags enumeration. * @guid: A D-Bus GUID. - * @observer: (allow-none): A #GDBusAuthObserver or %NULL. - * @cancellable: (allow-none): A #GCancellable or %NULL. + * @observer: (nullable): A #GDBusAuthObserver or %NULL. + * @cancellable: (nullable): A #GCancellable or %NULL. * @error: Return location for server or %NULL. * * Creates a new D-Bus server that listens on the first address in @@ -20732,7 +20748,7 @@ * @info: a #GDesktopAppInfo * @action_name: the name of the action as from * g_desktop_app_info_list_actions() - * @launch_context: (allow-none): a #GAppLaunchContext + * @launch_context: (nullable): a #GAppLaunchContext * * Activates the named application action. * @@ -20758,13 +20774,13 @@ * g_desktop_app_info_launch_uris_as_manager: * @appinfo: a #GDesktopAppInfo * @uris: (element-type utf8): List of URIs - * @launch_context: (allow-none): a #GAppLaunchContext + * @launch_context: (nullable): a #GAppLaunchContext * @spawn_flags: #GSpawnFlags, used for each process - * @user_setup: (scope call) (allow-none): a #GSpawnChildSetupFunc, used once + * @user_setup: (scope call) (nullable): a #GSpawnChildSetupFunc, used once * for each process. - * @user_setup_data: (closure user_setup) (allow-none): User data for @user_setup - * @pid_callback: (scope call) (allow-none): Callback for child processes - * @pid_callback_data: (closure pid_callback) (allow-none): User data for @callback + * @user_setup_data: (closure user_setup) (nullable): User data for @user_setup + * @pid_callback: (scope call) (nullable): Callback for child processes + * @pid_callback_data: (closure pid_callback) (nullable): User data for @callback * @error: return location for a #GError, or %NULL * * This function performs the equivalent of g_app_info_launch_uris(), @@ -20956,8 +20972,8 @@ * g_drive_eject: * @drive: a #GDrive. * @flags: flags affecting the unmount if required for eject - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @callback: (allow-none): a #GAsyncReadyCallback, or %NULL. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. + * @callback: (nullable): a #GAsyncReadyCallback, or %NULL. * @user_data: user data to pass to @callback * * Asynchronously ejects a drive. @@ -20988,10 +21004,10 @@ * g_drive_eject_with_operation: * @drive: a #GDrive. * @flags: flags affecting the unmount if required for eject - * @mount_operation: (allow-none): a #GMountOperation or %NULL to avoid + * @mount_operation: (nullable): a #GMountOperation or %NULL to avoid * user interaction. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @callback: (allow-none): a #GAsyncReadyCallback, or %NULL. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. + * @callback: (nullable): a #GAsyncReadyCallback, or %NULL. * @user_data: user data passed to @callback. * * Ejects a drive. This is an asynchronous operation, and is @@ -21171,8 +21187,8 @@ /** * g_drive_poll_for_media: * @drive: a #GDrive. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @callback: (allow-none): a #GAsyncReadyCallback, or %NULL. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. + * @callback: (nullable): a #GAsyncReadyCallback, or %NULL. * @user_data: user data to pass to @callback * * Asynchronously polls @drive to see if media has been inserted or removed. @@ -21200,10 +21216,10 @@ * g_drive_start: * @drive: a #GDrive. * @flags: flags affecting the start operation. - * @mount_operation: (allow-none): a #GMountOperation or %NULL to avoid + * @mount_operation: (nullable): a #GMountOperation or %NULL to avoid * user interaction. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @callback: (allow-none): a #GAsyncReadyCallback, or %NULL. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. + * @callback: (nullable): a #GAsyncReadyCallback, or %NULL. * @user_data: user data to pass to @callback * * Asynchronously starts a drive. @@ -21234,10 +21250,10 @@ * g_drive_stop: * @drive: a #GDrive. * @flags: flags affecting the unmount if required for stopping. - * @mount_operation: (allow-none): a #GMountOperation or %NULL to avoid + * @mount_operation: (nullable): a #GMountOperation or %NULL to avoid * user interaction. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @callback: (allow-none): a #GAsyncReadyCallback, or %NULL. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. + * @callback: (nullable): a #GAsyncReadyCallback, or %NULL. * @user_data: user data to pass to @callback * * Asynchronously stops a drive. @@ -21310,7 +21326,7 @@ /** * g_dtls_client_connection_new: * @base_socket: the #GDatagramBased to wrap - * @server_identity: (allow-none): the expected identity of the server + * @server_identity: (nullable): the expected identity of the server * @error: #GError for error reporting, or %NULL to ignore. * * Creates a new #GDtlsClientConnection wrapping @base_socket which is @@ -21516,7 +21532,7 @@ /** * g_dtls_connection_handshake: * @conn: a #GDtlsConnection - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @error: a #GError, or %NULL * * Attempts a TLS handshake on @conn. @@ -21551,7 +21567,7 @@ * g_dtls_connection_handshake_async: * @conn: a #GDtlsConnection * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: callback to call when the handshake is complete * @user_data: the data to pass to the callback function * @@ -21626,7 +21642,7 @@ /** * g_dtls_connection_set_interaction: * @conn: a connection - * @interaction: (allow-none): an interaction object, or %NULL + * @interaction: (nullable): an interaction object, or %NULL * * Set the object that will be used to interact with the user. It will be used * for things like prompting the user for passwords. @@ -21769,7 +21785,7 @@ /** * g_dtls_server_connection_new: * @base_socket: the #GDatagramBased to wrap - * @certificate: (allow-none): the default server certificate, or %NULL + * @certificate: (nullable): the default server certificate, or %NULL * @error: #GError for error reporting, or %NULL to ignore * * Creates a new #GDtlsServerConnection wrapping @base_socket. @@ -21873,7 +21889,7 @@ /** * g_emblemed_icon_new: * @icon: a #GIcon - * @emblem: (allow-none): a #GEmblem, or %NULL + * @emblem: (nullable): a #GEmblem, or %NULL * * Creates a new emblemed icon for @icon with the emblem @emblem. * @@ -21886,7 +21902,7 @@ * g_file_append_to: * @file: input #GFile * @flags: a set of #GFileCreateFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -21918,7 +21934,7 @@ * @file: input #GFile * @flags: a set of #GFileCreateFlags * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async): a #GAsyncReadyCallback to call * when the request is satisfied @@ -22124,7 +22140,7 @@ /** * g_file_attribute_matcher_to_string: - * @matcher: (allow-none): a #GFileAttributeMatcher. + * @matcher: (nullable): a #GFileAttributeMatcher. * * Prints what the matcher is matching against. The format will be * equal to the format passed to g_file_attribute_matcher_new(). @@ -22170,9 +22186,9 @@ * @source: input #GFile * @destination: destination #GFile * @flags: set of #GFileCopyFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore - * @progress_callback: (allow-none) (scope call): function to callback with + * @progress_callback: (nullable) (scope call): function to callback with * progress information, or %NULL if progress information is not needed * @progress_callback_data: (closure): user data to pass to @progress_callback * @error: #GError to set on error, or %NULL @@ -22224,9 +22240,9 @@ * @destination: destination #GFile * @flags: set of #GFileCopyFlags * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore - * @progress_callback: (allow-none): function to callback with progress + * @progress_callback: (nullable): function to callback with progress * information, or %NULL if progress information is not needed * @progress_callback_data: (closure): user data to pass to @progress_callback * @callback: a #GAsyncReadyCallback to call when the request is satisfied @@ -22250,7 +22266,7 @@ * @source: a #GFile with attributes * @destination: a #GFile to copy attributes to * @flags: a set of #GFileCopyFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, %NULL to ignore * @@ -22284,7 +22300,7 @@ * g_file_create: * @file: input #GFile * @flags: a set of #GFileCreateFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -22319,7 +22335,7 @@ * @file: input #GFile * @flags: a set of #GFileCreateFlags * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async): a #GAsyncReadyCallback to call * when the request is satisfied @@ -22355,7 +22371,7 @@ * g_file_create_readwrite: * @file: a #GFile * @flags: a set of #GFileCreateFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: return location for a #GError, or %NULL * @@ -22395,7 +22411,7 @@ * @file: input #GFile * @flags: a set of #GFileCreateFlags * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async): a #GAsyncReadyCallback to call * when the request is satisfied @@ -22433,7 +22449,7 @@ /** * g_file_delete: (virtual delete_file) * @file: input #GFile - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -22452,7 +22468,7 @@ * g_file_delete_async: (virtual delete_file_async) * @file: input #GFile * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: a #GAsyncReadyCallback to call * when the request is satisfied @@ -22509,9 +22525,9 @@ * g_file_eject_mountable: * @file: input #GFile * @flags: flags affecting the operation - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore - * @callback: (scope async) (allow-none): a #GAsyncReadyCallback to call + * @callback: (scope async) (nullable): a #GAsyncReadyCallback to call * when the request is satisfied, or %NULL * @user_data: (closure): the data to pass to callback function * @@ -22548,11 +22564,11 @@ * g_file_eject_mountable_with_operation: * @file: input #GFile * @flags: flags affecting the operation - * @mount_operation: (allow-none): a #GMountOperation, + * @mount_operation: (nullable): a #GMountOperation, * or %NULL to avoid user interaction - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore - * @callback: (scope async) (allow-none): a #GAsyncReadyCallback to call + * @callback: (scope async) (nullable): a #GAsyncReadyCallback to call * when the request is satisfied, or %NULL * @user_data: (closure): the data to pass to callback function * @@ -22589,7 +22605,7 @@ * @file: input #GFile * @attributes: an attribute query string * @flags: a set of #GFileQueryInfoFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: #GError for error reporting * @@ -22628,7 +22644,7 @@ * @attributes: an attribute query string * @flags: a set of #GFileQueryInfoFlags * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async): a #GAsyncReadyCallback to call when the * request is satisfied @@ -22665,7 +22681,7 @@ /** * g_file_enumerator_close: * @enumerator: a #GFileEnumerator. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: location to store the error occurring, or %NULL to ignore * * Releases all resources used by this enumerator, making the @@ -22683,7 +22699,7 @@ * g_file_enumerator_close_async: * @enumerator: a #GFileEnumerator. * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @callback: (scope async): a #GAsyncReadyCallback to call when the request is satisfied * @user_data: (closure): the data to pass to callback function * @@ -22774,8 +22790,8 @@ /** * g_file_enumerator_iterate: * @direnum: an open #GFileEnumerator - * @out_info: (out) (transfer none) (allow-none): Output location for the next #GFileInfo, or %NULL - * @out_child: (out) (transfer none) (allow-none): Output location for the next #GFile, or %NULL + * @out_info: (out) (transfer none) (optional): Output location for the next #GFileInfo, or %NULL + * @out_child: (out) (transfer none) (optional): Output location for the next #GFile, or %NULL * @cancellable: a #GCancellable * @error: a #GError * @@ -22825,7 +22841,7 @@ /** * g_file_enumerator_next_file: * @enumerator: a #GFileEnumerator. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: location to store the error occurring, or %NULL to ignore * * Returns information for the next file in the enumerated object. @@ -22851,7 +22867,7 @@ * @enumerator: a #GFileEnumerator. * @num_files: the number of file info objects to request * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @callback: (scope async): a #GAsyncReadyCallback to call when the request is satisfied * @user_data: (closure): the data to pass to callback function * @@ -22921,7 +22937,7 @@ /** * g_file_find_enclosing_mount: * @file: input #GFile - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError * @@ -22945,7 +22961,7 @@ * g_file_find_enclosing_mount_async: * @file: a #GFile * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async): a #GAsyncReadyCallback to call * when the request is satisfied @@ -23147,7 +23163,7 @@ /** * g_file_has_parent: * @file: input #GFile - * @parent: (allow-none): the parent to check for, or %NULL + * @parent: (nullable): the parent to check for, or %NULL * * Checks if @file has a parent, and optionally, if it is @parent. * @@ -23946,7 +23962,7 @@ * g_file_input_stream_query_info: * @stream: a #GFileInputStream. * @attributes: a file attribute query string. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: a #GError location to store the error occurring, or %NULL to * ignore. * @@ -23965,7 +23981,7 @@ * @stream: a #GFileInputStream. * @attributes: a file attribute query string. * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @callback: (scope async): callback to call when the request is satisfied * @user_data: (closure): the data to pass to callback function * @@ -24013,7 +24029,7 @@ * g_file_io_stream_query_info: * @stream: a #GFileIOStream. * @attributes: a file attribute query string. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: a #GError, %NULL to ignore. * * Queries a file io stream for the given @attributes. @@ -24044,7 +24060,7 @@ * @stream: a #GFileIOStream. * @attributes: a file attribute query string. * @io_priority: the [I/O priority][gio-GIOScheduler] of the request - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @callback: (scope async): callback to call when the request is satisfied * @user_data: (closure): the data to pass to callback function * @@ -24098,9 +24114,9 @@ * @file: input #GFile * @cancellable: optional #GCancellable object, %NULL to ignore * @contents: (out) (transfer full) (element-type guint8) (array length=length): a location to place the contents of the file - * @length: (out) (allow-none): a location to place the length of the contents of the file, + * @length: (out) (optional): a location to place the length of the contents of the file, * or %NULL if the length is not needed - * @etag_out: (out) (allow-none): a location to place the current entity tag for the file, + * @etag_out: (out) (optional): a location to place the current entity tag for the file, * or %NULL if the entity tag is not needed * @error: a #GError, or %NULL * @@ -24146,9 +24162,9 @@ * @file: input #GFile * @res: a #GAsyncResult * @contents: (out) (transfer full) (element-type guint8) (array length=length): a location to place the contents of the file - * @length: (out) (allow-none): a location to place the length of the contents of the file, + * @length: (out) (optional): a location to place the length of the contents of the file, * or %NULL if the length is not needed - * @etag_out: (out) (allow-none): a location to place the current entity tag for the file, + * @etag_out: (out) (optional): a location to place the current entity tag for the file, * or %NULL if the entity tag is not needed * @error: a #GError, or %NULL * @@ -24191,9 +24207,9 @@ * @file: input #GFile * @res: a #GAsyncResult * @contents: (out) (transfer full) (element-type guint8) (array length=length): a location to place the contents of the file - * @length: (out) (allow-none): a location to place the length of the contents of the file, + * @length: (out) (optional): a location to place the length of the contents of the file, * or %NULL if the length is not needed - * @etag_out: (out) (allow-none): a location to place the current entity tag for the file, + * @etag_out: (out) (optional): a location to place the current entity tag for the file, * or %NULL if the entity tag is not needed * @error: a #GError, or %NULL * @@ -24211,7 +24227,7 @@ /** * g_file_make_directory: * @file: input #GFile - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -24238,7 +24254,7 @@ * g_file_make_directory_async: (virtual make_directory_async) * @file: input #GFile * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: a #GAsyncReadyCallback to call * when the request is satisfied @@ -24267,7 +24283,7 @@ /** * g_file_make_directory_with_parents: * @file: input #GFile - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -24296,7 +24312,7 @@ * @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 - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError * @@ -24315,13 +24331,13 @@ * g_file_measure_disk_usage: * @file: a #GFile * @flags: #GFileMeasureFlags - * @cancellable: (allow-none): optional #GCancellable - * @progress_callback: (allow-none): a #GFileMeasureProgressCallback + * @cancellable: (nullable): optional #GCancellable + * @progress_callback: (nullable): a #GFileMeasureProgressCallback * @progress_data: user_data for @progress_callback - * @disk_usage: (allow-none) (out): the number of bytes of disk space used - * @num_dirs: (allow-none) (out): the number of directories encountered - * @num_files: (allow-none) (out): the number of non-directories encountered - * @error: (allow-none): %NULL, or a pointer to a %NULL #GError pointer + * @disk_usage: (out) (optional): the number of bytes of disk space used + * @num_dirs: (out) (optional): the number of directories encountered + * @num_files: (out) (optional): the number of non-directories encountered + * @error: (nullable): %NULL, or a pointer to a %NULL #GError pointer * * Recursively measures the disk usage of @file. * @@ -24353,10 +24369,10 @@ * @file: a #GFile * @flags: #GFileMeasureFlags * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable - * @progress_callback: (allow-none): a #GFileMeasureProgressCallback + * @cancellable: (nullable): optional #GCancellable + * @progress_callback: (nullable): a #GFileMeasureProgressCallback * @progress_data: user_data for @progress_callback - * @callback: (allow-none): a #GAsyncReadyCallback to call when complete + * @callback: (nullable): a #GAsyncReadyCallback to call when complete * @user_data: the data to pass to callback function * * Recursively measures the disk usage of @file. @@ -24372,10 +24388,10 @@ * g_file_measure_disk_usage_finish: * @file: a #GFile * @result: the #GAsyncResult passed to your #GAsyncReadyCallback - * @disk_usage: (allow-none) (out): the number of bytes of disk space used - * @num_dirs: (allow-none) (out): the number of directories encountered - * @num_files: (allow-none) (out): the number of non-directories encountered - * @error: (allow-none): %NULL, or a pointer to a %NULL #GError pointer + * @disk_usage: (out) (optional): the number of bytes of disk space used + * @num_dirs: (out) (optional): the number of directories encountered + * @num_files: (out) (optional): the number of non-directories encountered + * @error: (nullable): %NULL, or a pointer to a %NULL #GError pointer * * Collects the results from an earlier call to * g_file_measure_disk_usage_async(). See g_file_measure_disk_usage() for @@ -24391,7 +24407,7 @@ * g_file_monitor: * @file: input #GFile * @flags: a set of #GFileMonitorFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -24423,7 +24439,7 @@ * g_file_monitor_directory: (virtual monitor_dir) * @file: input #GFile * @flags: a set of #GFileMonitorFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -24467,7 +24483,7 @@ * g_file_monitor_file: * @file: input #GFile * @flags: a set of #GFileMonitorFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -24517,11 +24533,11 @@ * g_file_mount_enclosing_volume: * @location: input #GFile * @flags: flags affecting the operation - * @mount_operation: (allow-none): a #GMountOperation + * @mount_operation: (nullable): a #GMountOperation * or %NULL to avoid user interaction - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore - * @callback: (allow-none): a #GAsyncReadyCallback to call + * @callback: (nullable): a #GAsyncReadyCallback to call * when the request is satisfied, or %NULL * @user_data: the data to pass to callback function * @@ -24556,11 +24572,11 @@ * g_file_mount_mountable: * @file: input #GFile * @flags: flags affecting the operation - * @mount_operation: (allow-none): a #GMountOperation, + * @mount_operation: (nullable): a #GMountOperation, * or %NULL to avoid user interaction - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore - * @callback: (scope async) (allow-none): a #GAsyncReadyCallback to call + * @callback: (scope async) (nullable): a #GAsyncReadyCallback to call * when the request is satisfied, or %NULL * @user_data: (closure): the data to pass to callback function * @@ -24599,9 +24615,9 @@ * @source: #GFile pointing to the source location * @destination: #GFile pointing to the destination location * @flags: set of #GFileCopyFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore - * @progress_callback: (allow-none) (scope call): #GFileProgressCallback + * @progress_callback: (nullable) (scope call): #GFileProgressCallback * function for updates * @progress_callback_data: (closure): gpointer to user data for * the callback function @@ -24725,7 +24741,7 @@ /** * g_file_new_tmp: - * @tmpl: (type filename) (allow-none): Template for the file + * @tmpl: (type filename) (nullable): Template for the file * name, as in g_file_open_tmp(), or %NULL for a default template * @iostream: (out): on return, a #GFileIOStream for the created file * @error: a #GError, or %NULL @@ -24750,7 +24766,7 @@ /** * g_file_open_readwrite: * @file: #GFile to open - * @cancellable: (allow-none): a #GCancellable + * @cancellable: (nullable): a #GCancellable * @error: a #GError, or %NULL * * Opens an existing file for reading and writing. The result is @@ -24780,7 +24796,7 @@ * g_file_open_readwrite_async: * @file: input #GFile * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async): a #GAsyncReadyCallback to call * when the request is satisfied @@ -24903,7 +24919,7 @@ * g_file_poll_mountable: * @file: input #GFile * @cancellable: optional #GCancellable object, %NULL to ignore - * @callback: (allow-none): a #GAsyncReadyCallback to call + * @callback: (nullable): a #GAsyncReadyCallback to call * when the request is satisfied, or %NULL * @user_data: the data to pass to callback function * @@ -24960,7 +24976,7 @@ /** * g_file_query_exists: * @file: input #GFile - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * * Utility function to check if a particular file exists. This is @@ -24995,7 +25011,7 @@ * g_file_query_file_type: * @file: input #GFile * @flags: a set of #GFileQueryInfoFlags passed to g_file_query_info() - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * * Utility function to inspect the #GFileType of a file. This is @@ -25014,7 +25030,7 @@ * g_file_query_filesystem_info: * @file: input #GFile * @attributes: an attribute query string - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError * @@ -25054,7 +25070,7 @@ * @file: input #GFile * @attributes: an attribute query string * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async): a #GAsyncReadyCallback to call * when the request is satisfied @@ -25094,7 +25110,7 @@ * @file: input #GFile * @attributes: an attribute query string * @flags: a set of #GFileQueryInfoFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError * @@ -25140,7 +25156,7 @@ * @attributes: an attribute query string * @flags: a set of #GFileQueryInfoFlags * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async): a #GAsyncReadyCallback to call when the * request is satisfied @@ -25176,7 +25192,7 @@ /** * g_file_query_settable_attributes: * @file: input #GFile - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -25200,7 +25216,7 @@ /** * g_file_query_writable_namespaces: * @file: input #GFile - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -25221,7 +25237,7 @@ /** * g_file_read: (virtual read_fn) * @file: #GFile to read - * @cancellable: (allow-none): a #GCancellable + * @cancellable: (nullable): a #GCancellable * @error: a #GError, or %NULL * * Opens a file for reading. The result is a #GFileInputStream that @@ -25245,7 +25261,7 @@ * g_file_read_async: * @file: input #GFile * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async): a #GAsyncReadyCallback to call * when the request is satisfied @@ -25279,11 +25295,11 @@ /** * g_file_replace: * @file: input #GFile - * @etag: (allow-none): an optional [entity tag][gfile-etag] + * @etag: (nullable): an optional [entity tag][gfile-etag] * for the current #GFile, or #NULL to ignore * @make_backup: %TRUE if a backup should be created * @flags: a set of #GFileCreateFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -25337,12 +25353,12 @@ /** * g_file_replace_async: * @file: input #GFile - * @etag: (allow-none): an [entity tag][gfile-etag] for the current #GFile, + * @etag: (nullable): an [entity tag][gfile-etag] for the current #GFile, * or %NULL to ignore * @make_backup: %TRUE if a backup should be created * @flags: a set of #GFileCreateFlags * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async): a #GAsyncReadyCallback to call * when the request is satisfied @@ -25365,11 +25381,11 @@ * @file: input #GFile * @contents: (element-type guint8) (array length=length): a string containing the new contents for @file * @length: the length of @contents in bytes - * @etag: (allow-none): the old [entity-tag][gfile-etag] for the document, + * @etag: (nullable): the old [entity-tag][gfile-etag] for the document, * or %NULL * @make_backup: %TRUE if a backup should be created * @flags: a set of #GFileCreateFlags - * @new_etag: (allow-none) (out): a location to a new [entity tag][gfile-etag] + * @new_etag: (out) (optional): a location to a new [entity tag][gfile-etag] * for the document. This should be freed with g_free() when no longer * needed, or %NULL * @cancellable: optional #GCancellable object, %NULL to ignore @@ -25402,7 +25418,7 @@ * @file: input #GFile * @contents: (element-type guint8) (array length=length): string of contents to replace the file with * @length: the length of @contents in bytes - * @etag: (allow-none): a new [entity tag][gfile-etag] for the @file, or %NULL + * @etag: (nullable): a new [entity tag][gfile-etag] for the @file, or %NULL * @make_backup: %TRUE if a backup should be created * @flags: a set of #GFileCreateFlags * @cancellable: optional #GCancellable object, %NULL to ignore @@ -25435,7 +25451,7 @@ * g_file_replace_contents_bytes_async: * @file: input #GFile * @contents: a #GBytes - * @etag: (allow-none): a new [entity tag][gfile-etag] for the @file, or %NULL + * @etag: (nullable): a new [entity tag][gfile-etag] for the @file, or %NULL * @make_backup: %TRUE if a backup should be created * @flags: a set of #GFileCreateFlags * @cancellable: optional #GCancellable object, %NULL to ignore @@ -25459,7 +25475,7 @@ * g_file_replace_contents_finish: * @file: input #GFile * @res: a #GAsyncResult - * @new_etag: (out) (allow-none): a location of a new [entity tag][gfile-etag] + * @new_etag: (out) (optional): a location of a new [entity tag][gfile-etag] * for the document. This should be freed with g_free() when it is no * longer needed, or %NULL * @error: a #GError, or %NULL @@ -25489,11 +25505,11 @@ /** * g_file_replace_readwrite: * @file: a #GFile - * @etag: (allow-none): an optional [entity tag][gfile-etag] + * @etag: (nullable): an optional [entity tag][gfile-etag] * for the current #GFile, or #NULL to ignore * @make_backup: %TRUE if a backup should be created * @flags: a set of #GFileCreateFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: return location for a #GError, or %NULL * @@ -25517,12 +25533,12 @@ /** * g_file_replace_readwrite_async: * @file: input #GFile - * @etag: (allow-none): an [entity tag][gfile-etag] for the current #GFile, + * @etag: (nullable): an [entity tag][gfile-etag] for the current #GFile, * or %NULL to ignore * @make_backup: %TRUE if a backup should be created * @flags: a set of #GFileCreateFlags * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async): a #GAsyncReadyCallback to call * when the request is satisfied @@ -25578,10 +25594,10 @@ * @file: input #GFile * @attribute: a string containing the attribute's name * @type: The type of the attribute - * @value_p: (allow-none): a pointer to the value (or the pointer + * @value_p: (nullable): a pointer to the value (or the pointer * itself if the type is a pointer type) * @flags: a set of #GFileQueryInfoFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -25604,7 +25620,7 @@ * @attribute: a string containing the attribute's name * @value: a string containing the attribute's new value * @flags: a #GFileQueryInfoFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -25627,7 +25643,7 @@ * @attribute: a string containing the attribute's name * @value: a #gint32 containing the attribute's new value * @flags: a #GFileQueryInfoFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -25649,7 +25665,7 @@ * @attribute: a string containing the attribute's name * @value: a #guint64 containing the attribute's new value * @flags: a #GFileQueryInfoFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -25670,7 +25686,7 @@ * @attribute: a string containing the attribute's name * @value: a string containing the attribute's value * @flags: #GFileQueryInfoFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -25691,7 +25707,7 @@ * @attribute: a string containing the attribute's name * @value: a #guint32 containing the attribute's new value * @flags: a #GFileQueryInfoFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -25713,7 +25729,7 @@ * @attribute: a string containing the attribute's name * @value: a #guint64 containing the attribute's new value * @flags: a #GFileQueryInfoFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -25735,7 +25751,7 @@ * @info: a #GFileInfo * @flags: a #GFileQueryInfoFlags * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async): a #GAsyncReadyCallback * @user_data: (closure): a #gpointer @@ -25769,7 +25785,7 @@ * @file: input #GFile * @info: a #GFileInfo * @flags: #GFileQueryInfoFlags - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -25794,7 +25810,7 @@ * g_file_set_display_name: * @file: input #GFile * @display_name: a string - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -25825,7 +25841,7 @@ * @file: input #GFile * @display_name: a string * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: (scope async): a #GAsyncReadyCallback to call * when the request is satisfied @@ -25860,9 +25876,9 @@ * g_file_start_mountable: * @file: input #GFile * @flags: flags affecting the operation - * @start_operation: (allow-none): a #GMountOperation, or %NULL to avoid user interaction - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore - * @callback: (allow-none): a #GAsyncReadyCallback to call when the request is satisfied, or %NULL + * @start_operation: (nullable): a #GMountOperation, or %NULL to avoid user interaction + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore + * @callback: (nullable): a #GAsyncReadyCallback to call when the request is satisfied, or %NULL * @user_data: the data to pass to callback function * * Starts a file of type #G_FILE_TYPE_MOUNTABLE. @@ -25902,11 +25918,11 @@ * g_file_stop_mountable: * @file: input #GFile * @flags: flags affecting the operation - * @mount_operation: (allow-none): a #GMountOperation, + * @mount_operation: (nullable): a #GMountOperation, * or %NULL to avoid user interaction. - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore - * @callback: (allow-none): a #GAsyncReadyCallback to call + * @callback: (nullable): a #GAsyncReadyCallback to call * when the request is satisfied, or %NULL * @user_data: the data to pass to callback function * @@ -25958,7 +25974,7 @@ /** * g_file_trash: (virtual trash) * @file: #GFile to send to trash - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @error: a #GError, or %NULL * @@ -25979,7 +25995,7 @@ * g_file_trash_async: (virtual trash_async) * @file: input #GFile * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore * @callback: a #GAsyncReadyCallback to call * when the request is satisfied @@ -26009,9 +26025,9 @@ * g_file_unmount_mountable: * @file: input #GFile * @flags: flags affecting the operation - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore - * @callback: (scope async) (allow-none): a #GAsyncReadyCallback to call + * @callback: (scope async) (nullable): a #GAsyncReadyCallback to call * when the request is satisfied, or %NULL * @user_data: (closure): the data to pass to callback function * @@ -26051,11 +26067,11 @@ * g_file_unmount_mountable_with_operation: * @file: input #GFile * @flags: flags affecting the operation - * @mount_operation: (allow-none): a #GMountOperation, + * @mount_operation: (nullable): a #GMountOperation, * or %NULL to avoid user interaction - * @cancellable: (allow-none): optional #GCancellable object, + * @cancellable: (nullable): optional #GCancellable object, * %NULL to ignore - * @callback: (scope async) (allow-none): a #GAsyncReadyCallback to call + * @callback: (scope async) (nullable): a #GAsyncReadyCallback to call * when the request is satisfied, or %NULL * @user_data: (closure): the data to pass to callback function * @@ -26208,8 +26224,8 @@ /** * g_icon_equal: - * @icon1: (allow-none): pointer to the first #GIcon. - * @icon2: (allow-none): pointer to the second #GIcon. + * @icon1: (nullable): pointer to the first #GIcon. + * @icon2: (nullable): pointer to the second #GIcon. * * Checks if two icons are equal. * @@ -26734,7 +26750,7 @@ * @cancellable: optional #GCancellable object, %NULL to ignore. * @error: a #GError location to store the error occurring, or %NULL to * ignore. - * @first_property_name: (allow-none): the name of the first property, or %NULL if no + * @first_property_name: (nullable): the name of the first property, or %NULL if no * properties * @...: the value if the first property, followed by and other property * value pairs, and ended by %NULL. @@ -26799,7 +26815,7 @@ /** * g_input_stream_close: * @stream: A #GInputStream. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: location to store the error occurring, or %NULL to ignore * * Closes the stream, releasing resources related to it. @@ -26834,7 +26850,7 @@ * g_input_stream_close_async: * @stream: A #GInputStream. * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional cancellable object + * @cancellable: (nullable): optional cancellable object * @callback: (scope async): callback to call when the request is satisfied * @user_data: (closure): the data to pass to callback function * @@ -26890,7 +26906,7 @@ * @buffer: (array length=count) (element-type guint8): a buffer to * read data into (which should be at least count bytes long). * @count: the number of bytes that will be read from the stream - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: location to store the error occurring, or %NULL to ignore * * Tries to read @count bytes from the stream into the buffer starting at @@ -26926,7 +26942,7 @@ * read data into (which should be at least count bytes long). * @count: the number of bytes that will be read from the stream * @bytes_read: (out): location to store the number of bytes that was read from the stream - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: location to store the error occurring, or %NULL to ignore * * Tries to read @count bytes from the stream into the buffer starting at @@ -26960,7 +26976,7 @@ * read data into (which should be at least count bytes long) * @count: the number of bytes that will be read from the stream * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore * @callback: (scope async): callback to call when the request is satisfied * @user_data: (closure): the data to pass to callback function * @@ -27009,7 +27025,7 @@ * @count: the number of bytes that will be read from the stream * @io_priority: the [I/O priority][io-priority] * of the request. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @callback: (scope async): callback to call when the request is satisfied * @user_data: (closure): the data to pass to callback function * @@ -27044,7 +27060,7 @@ * @stream: a #GInputStream. * @count: maximum number of bytes that will be read from the stream. Common * values include 4096 and 8192. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: location to store the error occurring, or %NULL to ignore * * Like g_input_stream_read(), this tries to read @count bytes from @@ -27081,7 +27097,7 @@ * @stream: A #GInputStream. * @count: the number of bytes that will be read from the stream * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @callback: (scope async): callback to call when the request is satisfied * @user_data: (closure): the data to pass to callback function * @@ -27155,7 +27171,7 @@ * g_input_stream_skip: * @stream: a #GInputStream. * @count: the number of bytes that will be skipped from the stream - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: location to store the error occurring, or %NULL to ignore * * Tries to skip @count bytes from the stream. Will block during the operation. @@ -27182,7 +27198,7 @@ * @stream: A #GInputStream. * @count: the number of bytes that will be skipped from the stream * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @callback: (scope async): callback to call when the request is satisfied * @user_data: (closure): the data to pass to callback function * @@ -27550,7 +27566,7 @@ * @job: a #GIOSchedulerJob * @func: a #GSourceFunc callback that will be called in the original thread * @user_data: data to pass to @func - * @notify: (allow-none): a #GDestroyNotify for @user_data, or %NULL + * @notify: (nullable): a #GDestroyNotify for @user_data, or %NULL * * Used from an I/O job to send a callback to be run in the thread * that the job was started from, waiting for the result (and thus @@ -27566,7 +27582,7 @@ * @job: a #GIOSchedulerJob * @func: a #GSourceFunc callback that will be called in the original thread * @user_data: data to pass to @func - * @notify: (allow-none): a #GDestroyNotify for @user_data, or %NULL + * @notify: (nullable): a #GDestroyNotify for @user_data, or %NULL * * Used from an I/O job to send a callback to be run asynchronously in * the thread that the job was started from. The callback will be run @@ -27586,7 +27602,7 @@ * g_io_scheduler_push_job: * @job_func: a #GIOSchedulerJobFunc. * @user_data: data to pass to @job_func - * @notify: (allow-none): a #GDestroyNotify for @user_data, or %NULL + * @notify: (nullable): a #GDestroyNotify for @user_data, or %NULL * @io_priority: the [I/O priority][io-priority] * of the request. * @cancellable: optional #GCancellable object, %NULL to ignore. @@ -27617,7 +27633,7 @@ /** * g_io_stream_close: * @stream: a #GIOStream - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore * @error: location to store the error occurring, or %NULL to ignore * * Closes the stream, releasing resources related to it. This will also @@ -27663,7 +27679,7 @@ * g_io_stream_close_async: * @stream: a #GIOStream * @io_priority: the io priority of the request - * @cancellable: (allow-none): optional cancellable object + * @cancellable: (nullable): optional cancellable object * @callback: (scope async): callback to call when the request is satisfied * @user_data: (closure): the data to pass to callback function * @@ -27765,7 +27781,7 @@ * @stream2: a #GIOStream. * @flags: a set of #GIOStreamSpliceFlags. * @io_priority: the io priority of the request. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @callback: (scope async): a #GAsyncReadyCallback. * @user_data: (closure): user data passed to @callback. * @@ -27798,7 +27814,7 @@ * g_keyfile_settings_backend_new: * @filename: the filename of the keyfile * @root_path: the path under which all settings keys appear - * @root_group: (allow-none): the group name corresponding to + * @root_group: (nullable): the group name corresponding to * @root_path, or %NULL * * Creates a keyfile-backed #GSettingsBackend. @@ -28082,7 +28098,7 @@ * @size: an integer. * @type: (out) (optional): a location to store the type of the loaded * icon, %NULL to ignore. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to + * @cancellable: (nullable): optional #GCancellable object, %NULL to * ignore. * @error: a #GError location to store the error occurring, or %NULL * to ignore. @@ -28098,7 +28114,7 @@ * g_loadable_icon_load_async: * @icon: a #GLoadableIcon. * @size: an integer. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @callback: (scope async): a #GAsyncReadyCallback to call when the * request is satisfied * @user_data: (closure): the data to pass to callback function @@ -28149,7 +28165,7 @@ * @stream: a #GMemoryInputStream * @data: (array length=len) (element-type guint8) (transfer full): input data * @len: length of the data, may be -1 if @data is a nul-terminated string - * @destroy: (allow-none): function that is called to free @data, or %NULL + * @destroy: (nullable): function that is called to free @data, or %NULL * * Appends @data to data that can be read from the input stream */ @@ -28179,7 +28195,7 @@ * g_memory_input_stream_new_from_data: * @data: (array length=len) (element-type guint8) (transfer full): input data * @len: length of the data, may be -1 if @data is a nul-terminated string - * @destroy: (allow-none): function that is called to free @data, or %NULL + * @destroy: (nullable): function that is called to free @data, or %NULL * * Creates a new #GMemoryInputStream with data in memory of a given size. * @@ -28239,11 +28255,11 @@ /** * g_memory_output_stream_new: (skip) - * @data: (allow-none): pointer to a chunk of memory to use, or %NULL + * @data: (nullable): pointer to a chunk of memory to use, or %NULL * @size: the size of @data - * @realloc_function: (allow-none): a function with realloc() semantics (like g_realloc()) + * @realloc_function: (nullable): a function with realloc() semantics (like g_realloc()) * to be called when @data needs to be grown, or %NULL - * @destroy_function: (allow-none): a function to be called on @data when the stream is + * @destroy_function: (nullable): a function to be called on @data when the stream is * finalized, or %NULL * * Creates a new #GMemoryOutputStream. @@ -28348,8 +28364,8 @@ /** * g_menu_append: * @menu: a #GMenu - * @label: (allow-none): the section label, or %NULL - * @detailed_action: (allow-none): the detailed action string, or %NULL + * @label: (nullable): the section label, or %NULL + * @detailed_action: (nullable): the detailed action string, or %NULL * * Convenience function for appending a normal menu item to the end of * @menu. Combine g_menu_item_new() and g_menu_insert_item() for a more @@ -28375,7 +28391,7 @@ /** * g_menu_append_section: * @menu: a #GMenu - * @label: (allow-none): the section label, or %NULL + * @label: (nullable): the section label, or %NULL * @section: a #GMenuModel with the items of the section * * Convenience function for appending a section menu item to the end of @@ -28389,7 +28405,7 @@ /** * g_menu_append_submenu: * @menu: a #GMenu - * @label: (allow-none): the section label, or %NULL + * @label: (nullable): the section label, or %NULL * @submenu: a #GMenuModel with the items of the submenu * * Convenience function for appending a submenu menu item to the end of @@ -28417,8 +28433,8 @@ /** * g_menu_attribute_iter_get_next: * @iter: a #GMenuAttributeIter - * @out_name: (out) (allow-none) (transfer none): the type of the attribute - * @value: (out) (allow-none) (transfer full): the attribute value + * @out_name: (out) (optional) (transfer none): the type of the attribute + * @value: (out) (optional) (transfer full): the attribute value * * This function combines g_menu_attribute_iter_next() with * g_menu_attribute_iter_get_name() and g_menu_attribute_iter_get_value(). @@ -28495,8 +28511,8 @@ * g_menu_insert: * @menu: a #GMenu * @position: the position at which to insert the item - * @label: (allow-none): the section label, or %NULL - * @detailed_action: (allow-none): the detailed action string, or %NULL + * @label: (nullable): the section label, or %NULL + * @detailed_action: (nullable): the detailed action string, or %NULL * * Convenience function for inserting a normal menu item into @menu. * Combine g_menu_item_new() and g_menu_insert_item() for a more flexible @@ -28538,7 +28554,7 @@ * g_menu_insert_section: * @menu: a #GMenu * @position: the position at which to insert the item - * @label: (allow-none): the section label, or %NULL + * @label: (nullable): the section label, or %NULL * @section: a #GMenuModel with the items of the section * * Convenience function for inserting a section menu item into @menu. @@ -28553,7 +28569,7 @@ * g_menu_insert_submenu: * @menu: a #GMenu * @position: the position at which to insert the item - * @label: (allow-none): the section label, or %NULL + * @label: (nullable): the section label, or %NULL * @submenu: a #GMenuModel with the items of the submenu * * Convenience function for inserting a submenu menu item into @menu. @@ -28591,7 +28607,7 @@ * g_menu_item_get_attribute_value: * @menu_item: a #GMenuItem * @attribute: the attribute name to query - * @expected_type: (allow-none): the expected type of the attribute + * @expected_type: (nullable): the expected type of the attribute * * Queries the named @attribute on @menu_item. * @@ -28618,8 +28634,8 @@ /** * g_menu_item_new: - * @label: (allow-none): the section label, or %NULL - * @detailed_action: (allow-none): the detailed action string, or %NULL + * @label: (nullable): the section label, or %NULL + * @detailed_action: (nullable): the detailed action string, or %NULL * * Creates a new #GMenuItem. * @@ -28653,7 +28669,7 @@ /** * g_menu_item_new_section: - * @label: (allow-none): the section label, or %NULL + * @label: (nullable): the section label, or %NULL * @section: a #GMenuModel with the items of the section * * Creates a new #GMenuItem representing a section. @@ -28724,7 +28740,7 @@ /** * g_menu_item_new_submenu: - * @label: (allow-none): the section label, or %NULL + * @label: (nullable): the section label, or %NULL * @submenu: a #GMenuModel with the items of the submenu * * Creates a new #GMenuItem representing a submenu. @@ -28740,8 +28756,8 @@ /** * g_menu_item_set_action_and_target: * @menu_item: a #GMenuItem - * @action: (allow-none): the name of the action for this item - * @format_string: (allow-none): a GVariant format string + * @action: (nullable): the name of the action for this item + * @format_string: (nullable): a GVariant format string * @...: positional parameters, as per @format_string * * Sets or unsets the "action" and "target" attributes of @menu_item. @@ -28771,8 +28787,8 @@ /** * g_menu_item_set_action_and_target_value: * @menu_item: a #GMenuItem - * @action: (allow-none): the name of the action for this item - * @target_value: (allow-none): a #GVariant to use as the action target + * @action: (nullable): the name of the action for this item + * @target_value: (nullable): a #GVariant to use as the action target * * Sets or unsets the "action" and "target" attributes of @menu_item. * @@ -28819,7 +28835,7 @@ * g_menu_item_set_attribute: * @menu_item: a #GMenuItem * @attribute: the attribute to set - * @format_string: (allow-none): a #GVariant format string, or %NULL + * @format_string: (nullable): a #GVariant format string, or %NULL * @...: positional parameters, as per @format_string * * Sets or unsets an attribute on @menu_item. @@ -28848,7 +28864,7 @@ * g_menu_item_set_attribute_value: * @menu_item: a #GMenuItem * @attribute: the attribute to set - * @value: (allow-none): a #GVariant to use as the value, or %NULL + * @value: (nullable): a #GVariant to use as the value, or %NULL * * Sets or unsets an attribute on @menu_item. * @@ -28920,7 +28936,7 @@ /** * g_menu_item_set_label: * @menu_item: a #GMenuItem - * @label: (allow-none): the label to set, or %NULL to unset + * @label: (nullable): the label to set, or %NULL to unset * * Sets or unsets the "label" attribute of @menu_item. * @@ -28935,7 +28951,7 @@ * g_menu_item_set_link: * @menu_item: a #GMenuItem * @link: type of link to establish or unset - * @model: (allow-none): the #GMenuModel to link to (or %NULL to unset) + * @model: (nullable): the #GMenuModel to link to (or %NULL to unset) * * Creates a link from @menu_item to @model if non-%NULL, or unsets it. * @@ -28955,7 +28971,7 @@ /** * g_menu_item_set_section: * @menu_item: a #GMenuItem - * @section: (allow-none): a #GMenuModel, or %NULL + * @section: (nullable): a #GMenuModel, or %NULL * * Sets or unsets the "section" link of @menu_item to @section. * @@ -28972,7 +28988,7 @@ /** * g_menu_item_set_submenu: * @menu_item: a #GMenuItem - * @submenu: (allow-none): a #GMenuModel, or %NULL + * @submenu: (nullable): a #GMenuModel, or %NULL * * Sets or unsets the "submenu" link of @menu_item to @submenu. * @@ -29002,8 +29018,8 @@ /** * g_menu_link_iter_get_next: * @iter: a #GMenuLinkIter - * @out_link: (out) (allow-none) (transfer none): the name of the link - * @value: (out) (allow-none) (transfer full): the linked #GMenuModel + * @out_link: (out) (optional) (transfer none): the name of the link + * @value: (out) (optional) (transfer full): the linked #GMenuModel * * This function combines g_menu_link_iter_next() with * g_menu_link_iter_get_name() and g_menu_link_iter_get_value(). @@ -29092,7 +29108,7 @@ * @model: a #GMenuModel * @item_index: the index of the item * @attribute: the attribute to query - * @expected_type: (allow-none): the expected type of the attribute, or + * @expected_type: (nullable): the expected type of the attribute, or * %NULL * * Queries the item at position @item_index in @model for the attribute @@ -29227,8 +29243,8 @@ /** * g_menu_prepend: * @menu: a #GMenu - * @label: (allow-none): the section label, or %NULL - * @detailed_action: (allow-none): the detailed action string, or %NULL + * @label: (nullable): the section label, or %NULL + * @detailed_action: (nullable): the detailed action string, or %NULL * * Convenience function for prepending a normal menu item to the start * of @menu. Combine g_menu_item_new() and g_menu_insert_item() for a more @@ -29254,7 +29270,7 @@ /** * g_menu_prepend_section: * @menu: a #GMenu - * @label: (allow-none): the section label, or %NULL + * @label: (nullable): the section label, or %NULL * @section: a #GMenuModel with the items of the section * * Convenience function for prepending a section menu item to the start @@ -29268,7 +29284,7 @@ /** * g_menu_prepend_submenu: * @menu: a #GMenu - * @label: (allow-none): the section label, or %NULL + * @label: (nullable): the section label, or %NULL * @submenu: a #GMenuModel with the items of the submenu * * Convenience function for prepending a submenu menu item to the start @@ -29333,8 +29349,8 @@ * g_mount_eject: * @mount: a #GMount. * @flags: flags affecting the unmount if required for eject - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @callback: (allow-none): a #GAsyncReadyCallback, or %NULL. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. + * @callback: (nullable): a #GAsyncReadyCallback, or %NULL. * @user_data: user data passed to @callback. * * Ejects a mount. This is an asynchronous operation, and is @@ -29364,10 +29380,10 @@ * g_mount_eject_with_operation: * @mount: a #GMount. * @flags: flags affecting the unmount if required for eject - * @mount_operation: (allow-none): a #GMountOperation or %NULL to avoid + * @mount_operation: (nullable): a #GMountOperation or %NULL to avoid * user interaction. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @callback: (allow-none): a #GAsyncReadyCallback, or %NULL. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. + * @callback: (nullable): a #GAsyncReadyCallback, or %NULL. * @user_data: user data passed to @callback. * * Ejects a mount. This is an asynchronous operation, and is @@ -29514,7 +29530,7 @@ * @mount: a #GMount * @force_rescan: Whether to force a rescan of the content. * Otherwise a cached result will be used if available - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore * @callback: a #GAsyncReadyCallback * @user_data: user data passed to @callback * @@ -29558,7 +29574,7 @@ * @mount: a #GMount * @force_rescan: Whether to force a rescan of the content. * Otherwise a cached result will be used if available - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore * @error: a #GError location to store the error occurring, or %NULL to * ignore * @@ -29749,10 +29765,10 @@ * g_mount_remount: * @mount: a #GMount. * @flags: flags affecting the operation - * @mount_operation: (allow-none): a #GMountOperation or %NULL to avoid + * @mount_operation: (nullable): a #GMountOperation or %NULL to avoid * user interaction. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @callback: (allow-none): a #GAsyncReadyCallback, or %NULL. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. + * @callback: (nullable): a #GAsyncReadyCallback, or %NULL. * @user_data: user data passed to @callback. * * Remounts a mount. This is an asynchronous operation, and is @@ -29798,8 +29814,8 @@ * g_mount_unmount: * @mount: a #GMount. * @flags: flags affecting the operation - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @callback: (allow-none): a #GAsyncReadyCallback, or %NULL. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. + * @callback: (nullable): a #GAsyncReadyCallback, or %NULL. * @user_data: user data passed to @callback. * * Unmounts a mount. This is an asynchronous operation, and is @@ -29829,10 +29845,10 @@ * g_mount_unmount_with_operation: * @mount: a #GMount. * @flags: flags affecting the operation - * @mount_operation: (allow-none): a #GMountOperation or %NULL to avoid + * @mount_operation: (nullable): a #GMountOperation or %NULL to avoid * user interaction. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @callback: (allow-none): a #GAsyncReadyCallback, or %NULL. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. + * @callback: (nullable): a #GAsyncReadyCallback, or %NULL. * @user_data: user data passed to @callback. * * Unmounts a mount. This is an asynchronous operation, and is @@ -30048,7 +30064,7 @@ * g_network_monitor_can_reach: * @monitor: a #GNetworkMonitor * @connectable: a #GSocketConnectable - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @error: return location for a #GError, or %NULL * * Attempts to determine whether or not the host pointed to by @@ -30078,7 +30094,7 @@ * g_network_monitor_can_reach_async: * @monitor: a #GNetworkMonitor * @connectable: a #GSocketConnectable - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: (scope async): a #GAsyncReadyCallback to call when the * request is satisfied * @user_data: (closure): the data to pass to callback function @@ -30282,7 +30298,7 @@ * @notification: a #GNotification * @label: label of the button * @action: an action name - * @target_format: (allow-none): a #GVariant format string, or %NULL + * @target_format: (nullable): a #GVariant format string, or %NULL * @...: positional parameters, as determined by @target_format * * Adds a button to @notification that activates @action when clicked. @@ -30302,7 +30318,7 @@ * @notification: a #GNotification * @label: label of the button * @action: an action name - * @target: (allow-none): a #GVariant to use as @action's parameter, or %NULL + * @target: (nullable): a #GVariant to use as @action's parameter, or %NULL * * Adds a button to @notification that activates @action when clicked. * @action must be an application-wide action (it must start with "app."). @@ -30333,7 +30349,7 @@ /** * g_notification_set_body: * @notification: a #GNotification - * @body: (allow-none): the new body for @notification, or %NULL + * @body: (nullable): the new body for @notification, or %NULL * * Sets the body of @notification to @body. * @@ -30366,7 +30382,7 @@ * g_notification_set_default_action_and_target: (skip) * @notification: a #GNotification * @action: an action name - * @target_format: (allow-none): a #GVariant format string, or %NULL + * @target_format: (nullable): a #GVariant format string, or %NULL * @...: positional parameters, as determined by @target_format * * Sets the default action of @notification to @action. This action is @@ -30389,7 +30405,7 @@ * g_notification_set_default_action_and_target_value: (rename-to g_notification_set_default_action_and_target) * @notification: a #GNotification * @action: an action name - * @target: (allow-none): a #GVariant to use as @action's parameter, or %NULL + * @target: (nullable): a #GVariant to use as @action's parameter, or %NULL * * Sets the default action of @notification to @action. This action is * activated when the notification is clicked on. It must be an @@ -30472,7 +30488,7 @@ /** * g_output_stream_close: * @stream: A #GOutputStream. - * @cancellable: (allow-none): optional cancellable object + * @cancellable: (nullable): optional cancellable object * @error: location to store the error occurring, or %NULL to ignore * * Closes the stream, releasing resources related to it. @@ -30513,7 +30529,7 @@ * g_output_stream_close_async: * @stream: A #GOutputStream. * @io_priority: the io priority of the request. - * @cancellable: (allow-none): optional cancellable object + * @cancellable: (nullable): optional cancellable object * @callback: (scope async): callback to call when the request is satisfied * @user_data: (closure): the data to pass to callback function * @@ -30546,7 +30562,7 @@ /** * g_output_stream_flush: * @stream: a #GOutputStream. - * @cancellable: (allow-none): optional cancellable object + * @cancellable: (nullable): optional cancellable object * @error: location to store the error occurring, or %NULL to ignore * * Forces a write of all user-space buffered data for the given @@ -30567,7 +30583,7 @@ * g_output_stream_flush_async: * @stream: a #GOutputStream. * @io_priority: the io priority of the request. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @callback: (scope async): a #GAsyncReadyCallback to call when the request is satisfied * @user_data: (closure): the data to pass to callback function * @@ -30633,7 +30649,7 @@ * @stream: a #GOutputStream. * @bytes_written: (out): location to store the number of bytes that was * written to the stream - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: location to store the error occurring, or %NULL to ignore * @format: the format string. See the printf() documentation * @...: the parameters to insert into the format string @@ -30675,7 +30691,7 @@ * @stream: a #GOutputStream. * @source: a #GInputStream. * @flags: a set of #GOutputStreamSpliceFlags. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: a #GError location to store the error occurring, or %NULL to * ignore. * @@ -30695,7 +30711,7 @@ * @source: a #GInputStream. * @flags: a set of #GOutputStreamSpliceFlags. * @io_priority: the io priority of the request. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @callback: (scope async): a #GAsyncReadyCallback. * @user_data: (closure): user data passed to @callback. * @@ -30730,7 +30746,7 @@ * @stream: a #GOutputStream. * @bytes_written: (out): location to store the number of bytes that was * written to the stream - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: location to store the error occurring, or %NULL to ignore * @format: the format string. See the printf() documentation * @args: the parameters to insert into the format string @@ -30758,7 +30774,7 @@ * @stream: a #GOutputStream. * @buffer: (array length=count) (element-type guint8): the buffer containing the data to write. * @count: the number of bytes to write - * @cancellable: (allow-none): optional cancellable object + * @cancellable: (nullable): optional cancellable object * @error: location to store the error occurring, or %NULL to ignore * * Tries to write @count bytes from @buffer into the stream. Will block @@ -30793,7 +30809,7 @@ * @count: the number of bytes to write * @bytes_written: (out): location to store the number of bytes that was * written to the stream - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: location to store the error occurring, or %NULL to ignore * * Tries to write @count bytes from @buffer into the stream. Will block @@ -30826,7 +30842,7 @@ * @buffer: (array length=count) (element-type guint8): the buffer containing the data to write * @count: the number of bytes to write * @io_priority: the io priority of the request - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore * @callback: (scope async): callback to call when the request is satisfied * @user_data: (closure): the data to pass to callback function * @@ -30879,7 +30895,7 @@ * @buffer: (array length=count) (element-type guint8): the buffer containing the data to write. * @count: the number of bytes to write * @io_priority: the io priority of the request. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @callback: (scope async): callback to call when the request is satisfied * @user_data: (closure): the data to pass to callback function * @@ -30925,7 +30941,7 @@ * g_output_stream_write_bytes: * @stream: a #GOutputStream. * @bytes: the #GBytes to write - * @cancellable: (allow-none): optional cancellable object + * @cancellable: (nullable): optional cancellable object * @error: location to store the error occurring, or %NULL to ignore * * A wrapper function for g_output_stream_write() which takes a @@ -30949,7 +30965,7 @@ * @stream: A #GOutputStream. * @bytes: The bytes to write * @io_priority: the io priority of the request. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @callback: (scope async): callback to call when the request is satisfied * @user_data: (closure): the data to pass to callback function * @@ -30998,7 +31014,7 @@ /** * g_permission_acquire: * @permission: a #GPermission instance - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @error: a pointer to a %NULL #GError, or %NULL * * Attempts to acquire the permission represented by @permission. @@ -31025,7 +31041,7 @@ /** * g_permission_acquire_async: * @permission: a #GPermission instance - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: the #GAsyncReadyCallback to call when done * @user_data: the user data to pass to @callback * @@ -31114,7 +31130,7 @@ /** * g_permission_release: * @permission: a #GPermission instance - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @error: a pointer to a %NULL #GError, or %NULL * * Attempts to release the permission represented by @permission. @@ -31141,7 +31157,7 @@ /** * g_permission_release_async: * @permission: a #GPermission instance - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: the #GAsyncReadyCallback to call when done * @user_data: the user data to pass to @callback * @@ -31191,7 +31207,7 @@ /** * g_pollable_input_stream_create_source: * @stream: a #GPollableInputStream. - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * * Creates a #GSource that triggers when @stream can be read, or * @cancellable is triggered or an error occurs. The callback on the @@ -31234,7 +31250,7 @@ * @buffer: (array length=count) (element-type guint8): a buffer to * read data into (which should be at least @count bytes long). * @count: the number of bytes you want to read - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @error: #GError for error reporting, or %NULL to ignore. * * Attempts to read up to @count bytes from @stream into @buffer, as @@ -31274,7 +31290,7 @@ /** * g_pollable_output_stream_create_source: * @stream: a #GPollableOutputStream. - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * * Creates a #GSource that triggers when @stream can be written, or * @cancellable is triggered or an error occurs. The callback on the @@ -31317,7 +31333,7 @@ * @buffer: (array length=count) (element-type guint8): a buffer to write * data from * @count: the number of bytes you want to write - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @error: #GError for error reporting, or %NULL to ignore. * * Attempts to write up to @count bytes from @buffer to @stream, as @@ -31356,8 +31372,8 @@ * g_pollable_source_new_full: * @pollable_stream: (type GObject): the stream associated with the * new source - * @child_source: (allow-none): optional child source to attach - * @cancellable: (allow-none): optional #GCancellable to attach + * @child_source: (nullable): optional child source to attach + * @cancellable: (nullable): optional #GCancellable to attach * * Utility method for #GPollableInputStream and #GPollableOutputStream * implementations. Creates a new #GSource, as with @@ -31376,7 +31392,7 @@ * read data into * @count: the number of bytes to read * @blocking: whether to do blocking I/O - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: location to store the error occurring, or %NULL to ignore * * Tries to read from @stream, as with g_input_stream_read() (if @@ -31401,7 +31417,7 @@ * containing the data to write. * @count: the number of bytes to write * @blocking: whether to do blocking I/O - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: location to store the error occurring, or %NULL to ignore * * Tries to write to @stream, as with g_output_stream_write() (if @@ -31429,7 +31445,7 @@ * @blocking: whether to do blocking I/O * @bytes_written: (out): location to store the number of bytes that was * written to the stream - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: location to store the error occurring, or %NULL to ignore * * Tries to write @count bytes to @stream, as with @@ -31566,9 +31582,9 @@ * @protocol: The proxy protocol to support, in lower case (e.g. socks, http). * @dest_hostname: The destination hostname the proxy should tunnel to. * @dest_port: The destination port to tunnel to. - * @username: (allow-none): The username to authenticate to the proxy server + * @username: (nullable): The username to authenticate to the proxy server * (or %NULL). - * @password: (allow-none): The password to authenticate to the proxy server + * @password: (nullable): The password to authenticate to the proxy server * (or %NULL). * * Creates a new #GProxyAddress for @inetaddr with @protocol that should @@ -31588,7 +31604,7 @@ * @proxy: a #GProxy * @connection: a #GIOStream * @proxy_address: a #GProxyAddress - * @cancellable: (allow-none): a #GCancellable + * @cancellable: (nullable): a #GCancellable * @error: return #GError * * Given @connection to communicate with a proxy (eg, a @@ -31608,7 +31624,7 @@ * @proxy: a #GProxy * @connection: a #GIOStream * @proxy_address: a #GProxyAddress - * @cancellable: (allow-none): a #GCancellable + * @cancellable: (nullable): a #GCancellable * @callback: (scope async): a #GAsyncReadyCallback * @user_data: (closure): callback data * @@ -31671,7 +31687,7 @@ * g_proxy_resolver_lookup: * @resolver: a #GProxyResolver * @uri: a URI representing the destination to connect to - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @error: return location for a #GError, or %NULL * * Looks into the system proxy configuration to determine what proxy, @@ -31701,7 +31717,7 @@ * g_proxy_resolver_lookup_async: * @resolver: a #GProxyResolver * @uri: a URI representing the destination to connect to - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: (scope async): callback to call after resolution completes * @user_data: (closure): data for @callback * @@ -31750,7 +31766,7 @@ * g_remote_action_group_activate_action_full: * @remote: a #GDBusActionGroup * @action_name: the name of the action to activate - * @parameter: (allow-none): the optional parameter to the activation + * @parameter: (nullable): the optional parameter to the activation * @platform_data: the platform data to send * * Activates the remote action. @@ -31840,7 +31856,7 @@ * g_resolver_lookup_by_address: * @resolver: a #GResolver * @address: the address to reverse-resolve - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @error: return location for a #GError, or %NULL * * Synchronously reverse-resolves @address to determine its @@ -31863,7 +31879,7 @@ * g_resolver_lookup_by_address_async: * @resolver: a #GResolver * @address: the address to reverse-resolve - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: (scope async): callback to call after resolution completes * @user_data: (closure): data for @callback * @@ -31898,7 +31914,7 @@ * g_resolver_lookup_by_name: * @resolver: a #GResolver * @hostname: the hostname to look up - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @error: return location for a #GError, or %NULL * * Synchronously resolves @hostname to determine its associated IP @@ -31937,7 +31953,7 @@ * g_resolver_lookup_by_name_async: * @resolver: a #GResolver * @hostname: the hostname to look up the address of - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: (scope async): callback to call after resolution completes * @user_data: (closure): data for @callback * @@ -31975,7 +31991,7 @@ * @resolver: a #GResolver * @rrname: the DNS name to lookup the record for * @record_type: the type of DNS record to lookup - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @error: return location for a #GError, or %NULL * * Synchronously performs a DNS record lookup for the given @rrname and returns @@ -32002,7 +32018,7 @@ * @resolver: a #GResolver * @rrname: the DNS name to lookup the record for * @record_type: the type of DNS record to lookup - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: (scope async): callback to call after resolution completes * @user_data: (closure): data for @callback * @@ -32044,7 +32060,7 @@ * @service: the service type to look up (eg, "ldap") * @protocol: the networking protocol to use for @service (eg, "tcp") * @domain: the DNS domain to look up the service in - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @error: return location for a #GError, or %NULL * * Synchronously performs a DNS SRV lookup for the given @service and @@ -32083,7 +32099,7 @@ * @service: the service type to look up (eg, "ldap") * @protocol: the networking protocol to use for @service (eg, "tcp") * @domain: the DNS domain to look up the service in - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: (scope async): callback to call after resolution completes * @user_data: (closure): data for @callback * @@ -32171,9 +32187,9 @@ * @resource: A #GResource * @path: A pathname inside the resource * @lookup_flags: A #GResourceLookupFlags - * @size: (out) (allow-none): a location to place the length of the contents of the file, + * @size: (out) (optional): a location to place the length of the contents of the file, * or %NULL if the length is not needed - * @flags: (out) (allow-none): a location to place the flags about the file, + * @flags: (out) (optional): a location to place the flags about the file, * or %NULL if the length is not needed * @error: return location for a #GError, or %NULL * @@ -32313,9 +32329,9 @@ * g_resources_get_info: * @path: A pathname inside the resource * @lookup_flags: A #GResourceLookupFlags - * @size: (out) (allow-none): a location to place the length of the contents of the file, + * @size: (out) (optional): a location to place the length of the contents of the file, * or %NULL if the length is not needed - * @flags: (out) (allow-none): a location to place the flags about the file, + * @flags: (out) (optional): a location to place the flags about the file, * or %NULL if the length is not needed * @error: return location for a #GError, or %NULL * @@ -32421,7 +32437,7 @@ * @seekable: a #GSeekable. * @offset: a #goffset. * @type: a #GSeekType. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: a #GError location to store the error occurring, or %NULL to * ignore. * @@ -32460,7 +32476,7 @@ * g_seekable_truncate: (virtual truncate_fn) * @seekable: a #GSeekable. * @offset: a #goffset. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: a #GError location to store the error occurring, or %NULL to * ignore. * @@ -32542,7 +32558,7 @@ * @path: (out): the location to save the path * @keys: (out) (transfer container) (array zero-terminated=1): the * location to save the relative keys - * @values: (out) (allow-none) (transfer container) (array zero-terminated=1): + * @values: (out) (optional) (transfer container) (array zero-terminated=1): * the location to save the values, or %NULL * * Calculate the longest common prefix of all keys in a tree and write @@ -32875,7 +32891,7 @@ * It is a programmer error to give a @key that isn't contained in the * schema for @settings. * - * Returns: (allow-none) (transfer full): the default value + * Returns: (nullable) (transfer full): the default value * Since: 2.40 */ @@ -33135,7 +33151,7 @@ * It is a programmer error to give a @key that isn't contained in the * schema for @settings. * - * Returns: (allow-none) (transfer full): the user's value, if set + * Returns: (nullable) (transfer full): the user's value, if set * Since: 2.40 */ @@ -33261,8 +33277,8 @@ /** * g_settings_new_full: * @schema: a #GSettingsSchema - * @backend: (allow-none): a #GSettingsBackend - * @path: (allow-none): the path to use + * @backend: (nullable): a #GSettingsBackend + * @path: (nullable): the path to use * * Creates a new #GSettings object with a given schema, backend and * path. @@ -33730,7 +33746,7 @@ /** * g_settings_schema_source_new_from_directory: * @directory: (type filename): the filename of a directory - * @parent: (allow-none): a #GSettingsSchemaSource, or %NULL + * @parent: (nullable): a #GSettingsSchemaSource, or %NULL * @trusted: %TRUE, if the directory is trusted * @error: a pointer to a #GError pointer set to %NULL, or %NULL * @@ -33962,7 +33978,7 @@ * g_settings_set_strv: * @settings: a #GSettings object * @key: the name of the key to set - * @value: (allow-none) (array zero-terminated=1): the value to set it to, or %NULL + * @value: (nullable) (array zero-terminated=1): the value to set it to, or %NULL * * Sets @key in @settings to @value. * @@ -34145,7 +34161,7 @@ /** * g_simple_action_new: * @name: the name of the action - * @parameter_type: (allow-none): the type of parameter to the activate function + * @parameter_type: (nullable): the type of parameter to the activate function * * Creates a new action. * @@ -34159,7 +34175,7 @@ /** * g_simple_action_new_stateful: * @name: the name of the action - * @parameter_type: (allow-none): the type of the parameter to the activate function + * @parameter_type: (nullable): the type of the parameter to the activate function * @state: the initial state of the action * * Creates a new stateful action. @@ -34214,7 +34230,7 @@ /** * g_simple_action_set_state_hint: * @simple: a #GSimpleAction - * @state_hint: (allow-none): a #GVariant representing the state hint + * @state_hint: (nullable): a #GVariant representing the state hint * * Sets the state hint for the action. * @@ -34227,7 +34243,7 @@ /** * g_simple_async_report_error_in_idle: (skip) - * @object: (allow-none): a #GObject, or %NULL. + * @object: (nullable): a #GObject, or %NULL. * @callback: a #GAsyncReadyCallback. * @user_data: user data passed to @callback. * @domain: a #GQuark containing the error domain (usually #G_IO_ERROR). @@ -34245,7 +34261,7 @@ /** * g_simple_async_report_gerror_in_idle: - * @object: (allow-none): a #GObject, or %NULL + * @object: (nullable): a #GObject, or %NULL * @callback: (scope async): a #GAsyncReadyCallback. * @user_data: (closure): user data passed to @callback. * @error: the #GError to report @@ -34260,7 +34276,7 @@ /** * g_simple_async_report_take_gerror_in_idle: (skip) - * @object: (allow-none): a #GObject, or %NULL + * @object: (nullable): a #GObject, or %NULL * @callback: a #GAsyncReadyCallback. * @user_data: user data passed to @callback. * @error: the #GError to report @@ -34354,8 +34370,8 @@ /** * g_simple_async_result_is_valid: * @result: the #GAsyncResult passed to the _finish function. - * @source: (allow-none): the #GObject passed to the _finish function. - * @source_tag: (allow-none): the asynchronous function. + * @source: (nullable): the #GObject passed to the _finish function. + * @source_tag: (nullable): the asynchronous function. * * Ensures that the data passed to the _finish function of an async * operation is consistent. Three checks are performed. @@ -34378,7 +34394,7 @@ /** * g_simple_async_result_new: - * @source_object: (allow-none): a #GObject, or %NULL. + * @source_object: (nullable): a #GObject, or %NULL. * @callback: (scope async): a #GAsyncReadyCallback. * @user_data: (closure): user data passed to @callback. * @source_tag: the asynchronous function. @@ -34401,7 +34417,7 @@ /** * g_simple_async_result_new_error: - * @source_object: (allow-none): a #GObject, or %NULL. + * @source_object: (nullable): a #GObject, or %NULL. * @callback: (scope async): a #GAsyncReadyCallback. * @user_data: (closure): user data passed to @callback. * @domain: a #GQuark. @@ -34418,7 +34434,7 @@ /** * g_simple_async_result_new_from_error: - * @source_object: (allow-none): a #GObject, or %NULL. + * @source_object: (nullable): a #GObject, or %NULL. * @callback: (scope async): a #GAsyncReadyCallback. * @user_data: (closure): user data passed to @callback. * @error: a #GError @@ -34432,7 +34448,7 @@ /** * g_simple_async_result_new_take_error: (skip) - * @source_object: (allow-none): a #GObject, or %NULL + * @source_object: (nullable): a #GObject, or %NULL * @callback: (scope async): a #GAsyncReadyCallback * @user_data: (closure): user data passed to @callback * @error: a #GError @@ -34468,7 +34484,7 @@ * @simple: a #GSimpleAsyncResult. * @func: a #GSimpleAsyncThreadFunc. * @io_priority: the io priority of the request. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * * Runs the asynchronous job in a separate thread and then calls * g_simple_async_result_complete_in_idle() on @simple to return @@ -34484,7 +34500,7 @@ /** * g_simple_async_result_set_check_cancellable: * @simple: a #GSimpleAsyncResult - * @check_cancellable: (allow-none): a #GCancellable to check, or %NULL to unset + * @check_cancellable: (nullable): a #GCancellable to check, or %NULL to unset * * Sets a #GCancellable to check before dispatching results. * @@ -34637,9 +34653,9 @@ /** * g_simple_proxy_resolver_new: - * @default_proxy: (allow-none): the default proxy to use, eg + * @default_proxy: (nullable): the default proxy to use, eg * "socks://192.168.1.1" - * @ignore_hosts: (allow-none): an optional list of hosts/IP addresses + * @ignore_hosts: (nullable): an optional list of hosts/IP addresses * to not use a proxy for. * * Creates a new #GSimpleProxyResolver. See @@ -34706,7 +34722,7 @@ /** * g_socket_accept: * @socket: a #GSocket. - * @cancellable: (allow-none): a %GCancellable or %NULL + * @cancellable: (nullable): a %GCancellable or %NULL * @error: #GError for error reporting, or %NULL to ignore. * * Accept incoming connections on a connection-based socket. This removes @@ -34729,7 +34745,7 @@ /** * g_socket_address_enumerator_next: * @enumerator: a #GSocketAddressEnumerator - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: a #GError. * * Retrieves the next #GSocketAddress from @enumerator. Note that this @@ -34755,7 +34771,7 @@ /** * g_socket_address_enumerator_next_async: * @enumerator: a #GSocketAddressEnumerator - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @callback: (scope async): a #GAsyncReadyCallback to call when the request * is satisfied * @user_data: (closure): the data to pass to callback function @@ -34924,7 +34940,7 @@ * g_socket_client_connect: * @client: a #GSocketClient. * @connectable: a #GSocketConnectable specifying the remote address. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: #GError for error reporting, or %NULL to ignore. * * Tries to resolve the @connectable and make a network connection to it. @@ -34955,7 +34971,7 @@ * g_socket_client_connect_async: * @client: a #GSocketClient * @connectable: a #GSocketConnectable specifying the remote address. - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: (scope async): a #GAsyncReadyCallback * @user_data: (closure): user data for the callback * @@ -34988,7 +35004,7 @@ * @client: a #GSocketClient * @host_and_port: the name and optionally port of the host to connect to * @default_port: the default port to connect to - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @error: a pointer to a #GError, or %NULL * * This is a helper function for g_socket_client_connect(). @@ -35032,7 +35048,7 @@ * @client: a #GSocketClient * @host_and_port: the name and optionally the port of the host to connect to * @default_port: the default port to connect to - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: (scope async): a #GAsyncReadyCallback * @user_data: (closure): user data for the callback * @@ -35065,7 +35081,7 @@ * @client: a #GSocketConnection * @domain: a domain name * @service: the name of the service to connect to - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @error: a pointer to a #GError, or %NULL * * Attempts to create a TCP connection to a service. @@ -35092,7 +35108,7 @@ * @client: a #GSocketClient * @domain: a domain name * @service: the name of the service to connect to - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: (scope async): a #GAsyncReadyCallback * @user_data: (closure): user data for the callback * @@ -35122,7 +35138,7 @@ * @client: a #GSocketClient * @uri: A network URI * @default_port: the default port to connect to - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @error: a pointer to a #GError, or %NULL * * This is a helper function for g_socket_client_connect(). @@ -35157,7 +35173,7 @@ * @client: a #GSocketClient * @uri: a network uri * @default_port: the default port to connect to - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: (scope async): a #GAsyncReadyCallback * @user_data: (closure): user data for the callback * @@ -35347,7 +35363,7 @@ /** * g_socket_client_set_local_address: * @client: a #GSocketClient. - * @address: (allow-none): a #GSocketAddress, or %NULL + * @address: (nullable): a #GSocketAddress, or %NULL * * Sets the local address of the socket client. * The sockets created by this object will bound to the @@ -35380,7 +35396,7 @@ /** * g_socket_client_set_proxy_resolver: * @client: a #GSocketClient. - * @proxy_resolver: (allow-none): a #GProxyResolver, or %NULL for the + * @proxy_resolver: (nullable): a #GProxyResolver, or %NULL for the * default. * * Overrides the #GProxyResolver used by @client. You can call this if @@ -35540,7 +35556,7 @@ * @socket: a #GSocket * @condition: a #GIOCondition mask to wait for * @timeout: the maximum time (in microseconds) to wait, or -1 - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @error: a #GError pointer, or %NULL * * Waits for up to @timeout microseconds for @condition to become true @@ -35569,7 +35585,7 @@ * g_socket_condition_wait: * @socket: a #GSocket * @condition: a #GIOCondition mask to wait for - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @error: a #GError pointer, or %NULL * * Waits for @condition to become true on @socket. When the condition @@ -35592,7 +35608,7 @@ * g_socket_connect: * @socket: a #GSocket. * @address: a #GSocketAddress specifying the remote address. - * @cancellable: (allow-none): a %GCancellable or %NULL + * @cancellable: (nullable): a %GCancellable or %NULL * @error: #GError for error reporting, or %NULL to ignore. * * Connect the socket to the specified remote address. @@ -35666,7 +35682,7 @@ * g_socket_connection_connect: * @connection: a #GSocketConnection * @address: a #GSocketAddress specifying the remote address. - * @cancellable: (allow-none): a %GCancellable or %NULL + * @cancellable: (nullable): a %GCancellable or %NULL * @error: #GError for error reporting, or %NULL to ignore. * * Connect @connection to the specified remote address. @@ -35680,7 +35696,7 @@ * g_socket_connection_connect_async: * @connection: a #GSocketConnection * @address: a #GSocketAddress specifying the remote address. - * @cancellable: (allow-none): a %GCancellable or %NULL + * @cancellable: (nullable): a %GCancellable or %NULL * @callback: (scope async): a #GAsyncReadyCallback * @user_data: (closure): user data for the callback * @@ -35886,7 +35902,7 @@ * g_socket_create_source: (skip) * @socket: a #GSocket * @condition: a #GIOCondition mask to monitor - * @cancellable: (allow-none): a %GCancellable or %NULL + * @cancellable: (nullable): a %GCancellable or %NULL * * Creates a #GSource that can be attached to a %GMainContext to monitor * for the availability of the specified @condition on the socket. The #GSource @@ -36198,7 +36214,7 @@ * g_socket_join_multicast_group: * @socket: a #GSocket. * @group: a #GInetAddress specifying the group address to join. - * @iface: (allow-none): Name of the interface to use, or %NULL + * @iface: (nullable): Name of the interface to use, or %NULL * @source_specific: %TRUE if source-specific multicast should be used * @error: #GError for error reporting, or %NULL to ignore. * @@ -36223,7 +36239,7 @@ * g_socket_leave_multicast_group: * @socket: a #GSocket. * @group: a #GInetAddress specifying the group address to leave. - * @iface: (allow-none): Interface used + * @iface: (nullable): Interface used * @source_specific: %TRUE if source-specific multicast was used * @error: #GError for error reporting, or %NULL to ignore. * @@ -36261,8 +36277,8 @@ /** * g_socket_listener_accept: * @listener: a #GSocketListener - * @source_object: (out) (transfer none) (allow-none): location where #GObject pointer will be stored, or %NULL - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @source_object: (out) (transfer none) (optional): location where #GObject pointer will be stored, or %NULL + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: #GError for error reporting, or %NULL to ignore. * * Blocks waiting for a client to connect to any of the sockets added @@ -36285,7 +36301,7 @@ /** * g_socket_listener_accept_async: * @listener: a #GSocketListener - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: (scope async): a #GAsyncReadyCallback * @user_data: (closure): user data for the callback * @@ -36303,7 +36319,7 @@ * g_socket_listener_accept_finish: * @listener: a #GSocketListener * @result: a #GAsyncResult. - * @source_object: (out) (transfer none) (allow-none): Optional #GObject identifying this source + * @source_object: (out) (transfer none) (optional): Optional #GObject identifying this source * @error: a #GError location to store the error occurring, or %NULL to * ignore. * @@ -36317,8 +36333,8 @@ /** * g_socket_listener_accept_socket: * @listener: a #GSocketListener - * @source_object: (out) (transfer none) (allow-none): location where #GObject pointer will be stored, or %NULL. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @source_object: (out) (transfer none) (optional): location where #GObject pointer will be stored, or %NULL. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @error: #GError for error reporting, or %NULL to ignore. * * Blocks waiting for a client to connect to any of the sockets added @@ -36344,7 +36360,7 @@ /** * g_socket_listener_accept_socket_async: * @listener: a #GSocketListener - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: (scope async): a #GAsyncReadyCallback * @user_data: (closure): user data for the callback * @@ -36362,7 +36378,7 @@ * g_socket_listener_accept_socket_finish: * @listener: a #GSocketListener * @result: a #GAsyncResult. - * @source_object: (out) (transfer none) (allow-none): Optional #GObject identifying this source + * @source_object: (out) (transfer none) (optional): Optional #GObject identifying this source * @error: a #GError location to store the error occurring, or %NULL to * ignore. * @@ -36379,8 +36395,8 @@ * @address: a #GSocketAddress * @type: a #GSocketType * @protocol: a #GSocketProtocol - * @source_object: (allow-none): Optional #GObject identifying this source - * @effective_address: (out) (allow-none): location to store the address that was bound to, or %NULL. + * @source_object: (nullable): Optional #GObject identifying this source + * @effective_address: (out) (optional): location to store the address that was bound to, or %NULL. * @error: #GError for error reporting, or %NULL to ignore. * * Creates a socket of type @type and protocol @protocol, binds @@ -36411,7 +36427,7 @@ /** * g_socket_listener_add_any_inet_port: * @listener: a #GSocketListener - * @source_object: (allow-none): Optional #GObject identifying this source + * @source_object: (nullable): Optional #GObject identifying this source * @error: a #GError location to store the error occurring, or %NULL to * ignore. * @@ -36435,7 +36451,7 @@ * g_socket_listener_add_inet_port: * @listener: a #GSocketListener * @port: an IP port number (non-zero) - * @source_object: (allow-none): Optional #GObject identifying this source + * @source_object: (nullable): Optional #GObject identifying this source * @error: #GError for error reporting, or %NULL to ignore. * * Helper function for g_socket_listener_add_address() that @@ -36456,7 +36472,7 @@ * g_socket_listener_add_socket: * @listener: a #GSocketListener * @socket: a listening #GSocket - * @source_object: (allow-none): Optional #GObject identifying this source + * @source_object: (nullable): Optional #GObject identifying this source * @error: #GError for error reporting, or %NULL to ignore. * * Adds @socket to the set of sockets that we try to accept @@ -36571,7 +36587,7 @@ * @buffer: (array length=size) (element-type guint8): a buffer to * read data into (which should be at least @size bytes long). * @size: the number of bytes you want to read from the socket - * @cancellable: (allow-none): a %GCancellable or %NULL + * @cancellable: (nullable): a %GCancellable or %NULL * @error: #GError for error reporting, or %NULL to ignore. * * Receive data (up to @size bytes) from a socket. This is mainly used by @@ -36607,12 +36623,12 @@ /** * g_socket_receive_from: * @socket: a #GSocket - * @address: (out) (allow-none): a pointer to a #GSocketAddress + * @address: (out) (optional): a pointer to a #GSocketAddress * pointer, or %NULL * @buffer: (array length=size) (element-type guint8): a buffer to * read data into (which should be at least @size bytes long). * @size: the number of bytes you want to read from the socket - * @cancellable: (allow-none): a %GCancellable or %NULL + * @cancellable: (nullable): a %GCancellable or %NULL * @error: #GError for error reporting, or %NULL to ignore. * * Receive data (up to @size bytes) from a socket. @@ -36632,11 +36648,11 @@ /** * g_socket_receive_message: * @socket: a #GSocket - * @address: (out) (nullable): a pointer to a #GSocketAddress + * @address: (out) (optional): a pointer to a #GSocketAddress * pointer, or %NULL * @vectors: (array length=num_vectors): an array of #GInputVector structs * @num_vectors: the number of elements in @vectors, or -1 - * @messages: (array length=num_messages) (out) (nullable): a pointer which + * @messages: (array length=num_messages) (out) (optional): a pointer which * may be filled with an array of #GSocketControlMessages, or %NULL * @num_messages: (out): a pointer which will be filled with the number of * elements in @messages, or %NULL @@ -36716,7 +36732,7 @@ * @messages: (array length=num_messages): an array of #GInputMessage structs * @num_messages: the number of elements in @messages * @flags: an int containing #GSocketMsgFlags flags for the overall operation - * @cancellable: (allow-none): a %GCancellable or %NULL + * @cancellable: (nullable): a %GCancellable or %NULL * @error: #GError for error reporting, or %NULL to ignore * * Receive multiple data messages from @socket in one go. This is the most @@ -36784,7 +36800,7 @@ * read data into (which should be at least @size bytes long). * @size: the number of bytes you want to read from the socket * @blocking: whether to do blocking or non-blocking I/O - * @cancellable: (allow-none): a %GCancellable or %NULL + * @cancellable: (nullable): a %GCancellable or %NULL * @error: #GError for error reporting, or %NULL to ignore. * * This behaves exactly the same as g_socket_receive(), except that @@ -36803,7 +36819,7 @@ * @buffer: (array length=size) (element-type guint8): the buffer * containing the data to send. * @size: the number of bytes to send - * @cancellable: (allow-none): a %GCancellable or %NULL + * @cancellable: (nullable): a %GCancellable or %NULL * @error: #GError for error reporting, or %NULL to ignore. * * Tries to send @size bytes from @buffer on the socket. This is @@ -36830,14 +36846,14 @@ /** * g_socket_send_message: * @socket: a #GSocket - * @address: (allow-none): a #GSocketAddress, or %NULL + * @address: (nullable): a #GSocketAddress, or %NULL * @vectors: (array length=num_vectors): an array of #GOutputVector structs * @num_vectors: the number of elements in @vectors, or -1 - * @messages: (array length=num_messages) (allow-none): a pointer to an + * @messages: (array length=num_messages) (nullable): a pointer to an * array of #GSocketControlMessages, or %NULL. * @num_messages: number of elements in @messages, or -1. * @flags: an int containing #GSocketMsgFlags flags - * @cancellable: (allow-none): a %GCancellable or %NULL + * @cancellable: (nullable): a %GCancellable or %NULL * @error: #GError for error reporting, or %NULL to ignore. * * Send data to @address on @socket. For sending multiple messages see @@ -36890,7 +36906,7 @@ * @messages: (array length=num_messages): an array of #GOutputMessage structs * @num_messages: the number of elements in @messages * @flags: an int containing #GSocketMsgFlags flags - * @cancellable: (allow-none): a %GCancellable or %NULL + * @cancellable: (nullable): a %GCancellable or %NULL * @error: #GError for error reporting, or %NULL to ignore. * * Send multiple data messages from @socket in one go. This is the most @@ -36939,11 +36955,11 @@ /** * g_socket_send_to: * @socket: a #GSocket - * @address: (allow-none): a #GSocketAddress, or %NULL + * @address: (nullable): a #GSocketAddress, or %NULL * @buffer: (array length=size) (element-type guint8): the buffer * containing the data to send. * @size: the number of bytes to send - * @cancellable: (allow-none): a %GCancellable or %NULL + * @cancellable: (nullable): a %GCancellable or %NULL * @error: #GError for error reporting, or %NULL to ignore. * * Tries to send @size bytes from @buffer to @address. If @address is @@ -36965,7 +36981,7 @@ * containing the data to send. * @size: the number of bytes to send * @blocking: whether to do blocking or non-blocking I/O - * @cancellable: (allow-none): a %GCancellable or %NULL + * @cancellable: (nullable): a %GCancellable or %NULL * @error: #GError for error reporting, or %NULL to ignore. * * This behaves exactly the same as g_socket_send(), except that @@ -37409,7 +37425,7 @@ /** * g_subprocess_communicate: * @subprocess: a #GSubprocess - * @stdin_buf: (allow-none): data to send to the stdin of the subprocess, or %NULL + * @stdin_buf: (nullable): data to send to the stdin of the subprocess, or %NULL * @cancellable: a #GCancellable * @stdout_buf: (out): data read from the subprocess stdout * @stderr_buf: (out): data read from the subprocess stderr @@ -37465,8 +37481,8 @@ /** * g_subprocess_communicate_async: * @subprocess: Self - * @stdin_buf: (allow-none): Input data, or %NULL - * @cancellable: (allow-none): Cancellable + * @stdin_buf: (nullable): Input data, or %NULL + * @cancellable: (nullable): Cancellable * @callback: Callback * @user_data: User data * @@ -37490,7 +37506,7 @@ /** * g_subprocess_communicate_utf8: * @subprocess: a #GSubprocess - * @stdin_buf: (allow-none): data to send to the stdin of the subprocess, or %NULL + * @stdin_buf: (nullable): data to send to the stdin of the subprocess, or %NULL * @cancellable: a #GCancellable * @stdout_buf: (out): data read from the subprocess stdout * @stderr_buf: (out): data read from the subprocess stderr @@ -37504,7 +37520,7 @@ /** * g_subprocess_communicate_utf8_async: * @subprocess: Self - * @stdin_buf: (allow-none): Input data, or %NULL + * @stdin_buf: (nullable): Input data, or %NULL * @cancellable: Cancellable * @callback: Callback * @user_data: User data @@ -38045,7 +38061,7 @@ /** * g_subprocess_new: (skip) * @flags: flags that define the behaviour of the subprocess - * @error: (allow-none): return location for an error, or %NULL + * @error: (nullable): return location for an error, or %NULL * @argv0: first commandline argument to pass to the subprocess * @...: more commandline arguments, followed by %NULL * @@ -38067,7 +38083,7 @@ * g_subprocess_newv: (rename-to g_subprocess_new) * @argv: (array zero-terminated=1) (element-type utf8): commandline arguments for the subprocess * @flags: flags that define the behaviour of the subprocess - * @error: (allow-none): return location for an error, or %NULL + * @error: (nullable): return location for an error, or %NULL * * Create a new process with the given flags and argument list. * @@ -38330,7 +38346,7 @@ /** * g_task_is_valid: * @result: (type Gio.AsyncResult): A #GAsyncResult - * @source_object: (allow-none) (type GObject): the source object + * @source_object: (nullable) (type GObject): the source object * expected to be associated with the task * * Checks that @result is a #GTask, and that @source_object is its @@ -38345,9 +38361,9 @@ /** * g_task_new: - * @source_object: (allow-none) (type GObject): the #GObject that owns + * @source_object: (nullable) (type GObject): the #GObject that owns * this task, or %NULL. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @callback: (scope async): a #GAsyncReadyCallback. * @callback_data: (closure): user data passed to @callback. * @@ -38430,7 +38446,7 @@ /** * g_task_report_error: - * @source_object: (allow-none) (type GObject): the #GObject that owns + * @source_object: (nullable) (type GObject): the #GObject that owns * this task, or %NULL. * @callback: (scope async): a #GAsyncReadyCallback. * @callback_data: (closure): user data passed to @callback. @@ -38452,7 +38468,7 @@ /** * g_task_report_new_error: - * @source_object: (allow-none) (type GObject): the #GObject that owns + * @source_object: (nullable) (type GObject): the #GObject that owns * this task, or %NULL. * @callback: (scope async): a #GAsyncReadyCallback. * @callback_data: (closure): user data passed to @callback. @@ -38559,9 +38575,9 @@ /** * g_task_return_pointer: * @task: a #GTask - * @result: (allow-none) (transfer full): the pointer result of a task + * @result: (nullable) (transfer full): the pointer result of a task * function - * @result_destroy: (allow-none): a #GDestroyNotify function. + * @result_destroy: (nullable): a #GDestroyNotify function. * * Sets @task's result to @result and completes the task. If @result * is not %NULL, then @result_destroy will be used to free @result if @@ -38737,8 +38753,8 @@ /** * g_task_set_task_data: * @task: the #GTask - * @task_data: (allow-none): task-specific data - * @task_data_destroy: (allow-none): #GDestroyNotify for @task_data + * @task_data: (nullable): task-specific data + * @task_data_destroy: (nullable): #GDestroyNotify for @task_data * * Sets @task's task data (freeing the existing task data, if any). * @@ -38829,7 +38845,7 @@ * been called yet, %NULL is returned. This can be used with * g_dbus_connection_new_for_address(). * - * Returns: (allow-none): the address of the bus, or %NULL. + * Returns: (nullable): the address of the bus, or %NULL. */ @@ -39233,8 +39249,8 @@ /** * g_tls_certificate_verify: * @cert: a #GTlsCertificate - * @identity: (allow-none): the expected peer identity - * @trusted_ca: (allow-none): the certificate of a trusted authority + * @identity: (nullable): the expected peer identity + * @trusted_ca: (nullable): the certificate of a trusted authority * * This verifies @cert and returns a set of #GTlsCertificateFlags * indicating any problems found with it. This can be used to verify a @@ -39336,7 +39352,7 @@ /** * g_tls_client_connection_new: * @base_io_stream: the #GIOStream to wrap - * @server_identity: (allow-none): the expected identity of the server + * @server_identity: (nullable): the expected identity of the server * @error: #GError for error reporting, or %NULL to ignore. * * Creates a new #GTlsClientConnection wrapping @base_io_stream (which @@ -39514,7 +39530,7 @@ /** * g_tls_connection_handshake: * @conn: a #GTlsConnection - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @error: a #GError, or %NULL * * Attempts a TLS handshake on @conn. @@ -39549,7 +39565,7 @@ * g_tls_connection_handshake_async: * @conn: a #GTlsConnection * @io_priority: the [I/O priority][io-priority] of the request - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: callback to call when the handshake is complete * @user_data: the data to pass to the callback function * @@ -39624,7 +39640,7 @@ /** * g_tls_connection_set_interaction: * @conn: a connection - * @interaction: (allow-none): an interaction object, or %NULL + * @interaction: (nullable): an interaction object, or %NULL * * Set the object that will be used to interact with the user. It will be used * for things like prompting the user for passwords. @@ -39745,10 +39761,10 @@ * g_tls_database_lookup_certificate_for_handle: * @self: a #GTlsDatabase * @handle: a certificate handle - * @interaction: (allow-none): used to interact with the user if necessary + * @interaction: (nullable): used to interact with the user if necessary * @flags: Flags which affect the lookup. - * @cancellable: (allow-none): a #GCancellable, or %NULL - * @error: (allow-none): a #GError, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL + * @error: (nullable): a #GError, or %NULL * * Lookup a certificate by its handle. * @@ -39763,7 +39779,7 @@ * This function can block, use g_tls_database_lookup_certificate_for_handle_async() to perform * the lookup operation asynchronously. * - * Returns: (transfer full) (allow-none): a newly allocated + * Returns: (transfer full) (nullable): a newly allocated * #GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate. * Since: 2.30 */ @@ -39773,9 +39789,9 @@ * g_tls_database_lookup_certificate_for_handle_async: * @self: a #GTlsDatabase * @handle: a certificate handle - * @interaction: (allow-none): used to interact with the user if necessary + * @interaction: (nullable): used to interact with the user if necessary * @flags: Flags which affect the lookup. - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: callback to call when the operation completes * @user_data: the data to pass to the callback function * @@ -39808,10 +39824,10 @@ * g_tls_database_lookup_certificate_issuer: * @self: a #GTlsDatabase * @certificate: a #GTlsCertificate - * @interaction: (allow-none): used to interact with the user if necessary + * @interaction: (nullable): used to interact with the user if necessary * @flags: flags which affect the lookup operation - * @cancellable: (allow-none): a #GCancellable, or %NULL - * @error: (allow-none): a #GError, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL + * @error: (nullable): a #GError, or %NULL * * Lookup the issuer of @certificate in the database. * @@ -39832,9 +39848,9 @@ * g_tls_database_lookup_certificate_issuer_async: * @self: a #GTlsDatabase * @certificate: a #GTlsCertificate - * @interaction: (allow-none): used to interact with the user if necessary + * @interaction: (nullable): used to interact with the user if necessary * @flags: flags which affect the lookup operation - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: callback to call when the operation completes * @user_data: the data to pass to the callback function * @@ -39864,10 +39880,10 @@ * g_tls_database_lookup_certificates_issued_by: * @self: a #GTlsDatabase * @issuer_raw_dn: a #GByteArray which holds the DER encoded issuer DN. - * @interaction: (allow-none): used to interact with the user if necessary + * @interaction: (nullable): used to interact with the user if necessary * @flags: Flags which affect the lookup operation. - * @cancellable: (allow-none): a #GCancellable, or %NULL - * @error: (allow-none): a #GError, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL + * @error: (nullable): a #GError, or %NULL * * Lookup certificates issued by this issuer in the database. * @@ -39884,9 +39900,9 @@ * g_tls_database_lookup_certificates_issued_by_async: * @self: a #GTlsDatabase * @issuer_raw_dn: a #GByteArray which holds the DER encoded issuer DN. - * @interaction: (allow-none): used to interact with the user if necessary + * @interaction: (nullable): used to interact with the user if necessary * @flags: Flags which affect the lookup operation. - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: callback to call when the operation completes * @user_data: the data to pass to the callback function * @@ -39921,11 +39937,11 @@ * @self: a #GTlsDatabase * @chain: a #GTlsCertificate chain * @purpose: the purpose that this certificate chain will be used for. - * @identity: (allow-none): the expected peer identity - * @interaction: (allow-none): used to interact with the user if necessary + * @identity: (nullable): the expected peer identity + * @interaction: (nullable): used to interact with the user if necessary * @flags: additional verify flags - * @cancellable: (allow-none): a #GCancellable, or %NULL - * @error: (allow-none): a #GError, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL + * @error: (nullable): a #GError, or %NULL * * Verify's a certificate chain after looking up and adding any missing * certificates to the chain. @@ -39963,10 +39979,10 @@ * @self: a #GTlsDatabase * @chain: a #GTlsCertificate chain * @purpose: the purpose that this certificate chain will be used for. - * @identity: (allow-none): the expected peer identity - * @interaction: (allow-none): used to interact with the user if necessary + * @identity: (nullable): the expected peer identity + * @interaction: (nullable): used to interact with the user if necessary * @flags: additional verify flags - * @cancellable: (allow-none): a #GCancellable, or %NULL + * @cancellable: (nullable): a #GCancellable, or %NULL * @callback: callback to call when the operation completes * @user_data: the data to pass to the callback function * @@ -40050,8 +40066,8 @@ * @interaction: a #GTlsInteraction object * @password: a #GTlsPassword object * @cancellable: an optional #GCancellable cancellation object - * @callback: (allow-none): will be called when the interaction completes - * @user_data: (allow-none): data to pass to the @callback + * @callback: (nullable): will be called when the interaction completes + * @user_data: (nullable): data to pass to the @callback * * Run asynchronous interaction to ask the user for a password. In general, * g_tls_interaction_invoke_ask_password() should be used instead of this @@ -40196,8 +40212,8 @@ * @connection: a #GTlsConnection object * @flags: flags providing more information about the request * @cancellable: an optional #GCancellable cancellation object - * @callback: (allow-none): will be called when the interaction completes - * @user_data: (allow-none): data to pass to the @callback + * @callback: (nullable): will be called when the interaction completes + * @user_data: (nullable): data to pass to the @callback * * Run asynchronous interaction to ask the user for a certificate to use with * the connection. In general, g_tls_interaction_invoke_request_certificate() should @@ -40259,7 +40275,7 @@ /** * g_tls_password_get_value: * @password: a #GTlsPassword object - * @length: (allow-none): location to place the length of the password. + * @length: (nullable): location to place the length of the password. * * Get the password value. If @length is not %NULL then it will be * filled in with the length of the password value. (Note that the @@ -40341,7 +40357,7 @@ * @password: a #GTlsPassword object * @value: the value for the password * @length: the length of the password, or -1 - * @destroy: (allow-none): a function to use to free the password. + * @destroy: (nullable): a function to use to free the password. * * Provide the value for this password. * @@ -40373,7 +40389,7 @@ /** * g_tls_server_connection_new: * @base_io_stream: the #GIOStream to wrap - * @certificate: (allow-none): the default server certificate, or %NULL + * @certificate: (nullable): the default server certificate, or %NULL * @error: #GError for error reporting, or %NULL to ignore. * * Creates a new #GTlsServerConnection wrapping @base_io_stream (which @@ -40392,7 +40408,7 @@ /** * g_unix_connection_receive_credentials: * @connection: A #GUnixConnection. - * @cancellable: (allow-none): A #GCancellable or %NULL. + * @cancellable: (nullable): A #GCancellable or %NULL. * @error: Return location for error or %NULL. * * Receives credentials from the sending end of the connection. The @@ -40415,7 +40431,7 @@ /** * g_unix_connection_receive_credentials_async: * @connection: A #GUnixConnection. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @callback: (scope async): a #GAsyncReadyCallback to call when the request is satisfied * @user_data: (closure): the data to pass to callback function * @@ -40449,8 +40465,8 @@ /** * g_unix_connection_receive_fd: * @connection: a #GUnixConnection - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore - * @error: (allow-none): #GError for error reporting, or %NULL to ignore + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore + * @error: (nullable): #GError for error reporting, or %NULL to ignore * * Receives a file descriptor from the sending end of the connection. * The sending end has to call g_unix_connection_send_fd() for this @@ -40468,7 +40484,7 @@ /** * g_unix_connection_send_credentials: * @connection: A #GUnixConnection. - * @cancellable: (allow-none): A #GCancellable or %NULL. + * @cancellable: (nullable): A #GCancellable or %NULL. * @error: Return location for error or %NULL. * * Passes the credentials of the current user the receiving side @@ -40491,7 +40507,7 @@ /** * g_unix_connection_send_credentials_async: * @connection: A #GUnixConnection. - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. * @callback: (scope async): a #GAsyncReadyCallback to call when the request is satisfied * @user_data: (closure): the data to pass to callback function * @@ -40525,8 +40541,8 @@ * g_unix_connection_send_fd: * @connection: a #GUnixConnection * @fd: a file descriptor - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore. - * @error: (allow-none): #GError for error reporting, or %NULL to ignore. + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore. + * @error: (nullable): #GError for error reporting, or %NULL to ignore. * * Passes a file descriptor to the receiving side of the * connection. The receiving end has to call g_unix_connection_receive_fd() @@ -40676,7 +40692,7 @@ /** * g_unix_fd_list_peek_fds: * @list: a #GUnixFDList - * @length: (out) (allow-none): pointer to the length of the returned + * @length: (out) (optional): pointer to the length of the returned * array, or %NULL * * Returns the array of file descriptors that is contained in this @@ -40702,7 +40718,7 @@ /** * g_unix_fd_list_steal_fds: * @list: a #GUnixFDList - * @length: (out) (allow-none): pointer to the length of the returned + * @length: (out) (optional): pointer to the length of the returned * array, or %NULL * * Returns the array of file descriptors that is contained in this @@ -40788,7 +40804,7 @@ /** * g_unix_fd_message_steal_fds: * @message: a #GUnixFDMessage - * @length: (out) (allow-none): pointer to the length of the returned + * @length: (out) (optional): pointer to the length of the returned * array, or %NULL * * Returns the array of file descriptors that is contained in this @@ -40881,7 +40897,7 @@ /** * g_unix_mount_at: (skip) * @mount_path: path for a possible unix mount. - * @time_read: (out) (allow-none): guint64 to contain a timestamp. + * @time_read: (out) (optional): guint64 to contain a timestamp. * * Gets a #GUnixMountEntry for a given mount path. If @time_read * is set, it will be filled with a unix timestamp for checking @@ -40906,7 +40922,7 @@ /** * g_unix_mount_for: (skip) * @file_path: file path on some unix mount. - * @time_read: (out) (allow-none): guint64 to contain a timestamp. + * @time_read: (out) (optional): guint64 to contain a timestamp. * * Gets a #GUnixMountEntry for a given file path. If @time_read * is set, it will be filled with a unix timestamp for checking @@ -41247,7 +41263,7 @@ /** * g_unix_mount_points_get: (skip) - * @time_read: (out) (allow-none): guint64 to contain a timestamp. + * @time_read: (out) (optional): guint64 to contain a timestamp. * * Gets a #GList of #GUnixMountPoint containing the unix mount points. * If @time_read is set, it will be filled with the mount timestamp, @@ -41271,7 +41287,7 @@ /** * g_unix_mounts_get: (skip) - * @time_read: (out) (allow-none): guint64 to contain a timestamp, or %NULL + * @time_read: (out) (optional): guint64 to contain a timestamp, or %NULL * * Gets a #GList of #GUnixMountEntry containing the unix mounts. * If @time_read is set, it will be filled with the mount @@ -41628,8 +41644,8 @@ * g_volume_eject: * @volume: a #GVolume * @flags: flags affecting the unmount if required for eject - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore - * @callback: (allow-none): a #GAsyncReadyCallback, or %NULL + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore + * @callback: (nullable): a #GAsyncReadyCallback, or %NULL * @user_data: user data that gets passed to @callback * * Ejects a volume. This is an asynchronous operation, and is @@ -41658,10 +41674,10 @@ * g_volume_eject_with_operation: * @volume: a #GVolume * @flags: flags affecting the unmount if required for eject - * @mount_operation: (allow-none): a #GMountOperation or %NULL to + * @mount_operation: (nullable): a #GMountOperation or %NULL to * avoid user interaction - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore - * @callback: (allow-none): a #GAsyncReadyCallback, or %NULL + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore + * @callback: (nullable): a #GAsyncReadyCallback, or %NULL * @user_data: user data passed to @callback * * Ejects a volume. This is an asynchronous operation, and is @@ -41956,9 +41972,9 @@ * g_volume_mount: (virtual mount_fn) * @volume: a #GVolume * @flags: flags affecting the operation - * @mount_operation: (allow-none): a #GMountOperation or %NULL to avoid user interaction - * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore - * @callback: (allow-none): a #GAsyncReadyCallback, or %NULL + * @mount_operation: (nullable): a #GMountOperation or %NULL to avoid user interaction + * @cancellable: (nullable): optional #GCancellable object, %NULL to ignore + * @callback: (nullable): a #GAsyncReadyCallback, or %NULL * @user_data: user data that gets passed to @callback * * Mounts a volume. This is an asynchronous operation, and is @@ -42115,7 +42131,7 @@ * g_win32_registry_key_get_child: * @key: (in) (transfer none): a parent #GWin32RegistryKey * @subkey: (in) (transfer none): name of a child key to open (in UTF-8), relative to @key - * @error: (inout) (nullable): a pointer to a %NULL #GError, or %NULL + * @error: (inout) (optional): a pointer to a %NULL #GError, or %NULL * * Opens a @subkey of the @key. * @@ -42128,7 +42144,7 @@ * g_win32_registry_key_get_child_w: * @key: (in) (transfer none): a parent #GWin32RegistryKey * @subkey: (in) (transfer none): name of a child key to open (in UTF-8), relative to @key - * @error: (inout) (nullable): a pointer to a %NULL #GError, or %NULL + * @error: (inout) (optional): a pointer to a %NULL #GError, or %NULL * * Opens a @subkey of the @key. * @@ -42248,7 +42264,7 @@ /** * g_win32_registry_key_new_w: * @path: (in) (transfer none): absolute full name of a key to open (in UTF-16) - * @error: (inout) (nullable): a pointer to a %NULL #GError, or %NULL + * @error: (inout) (optional): a pointer to a %NULL #GError, or %NULL * * Creates an object that represents a registry key specified by @path. * @path must start with one of the following pre-defined names: @@ -42391,7 +42407,7 @@ * g_win32_registry_subkey_iter_init: * @iter: (in) (transfer none): a pointer to a #GWin32RegistrySubkeyIter * @key: (in) (transfer none): a #GWin32RegistryKey to iterate over - * @error: (inout) (nullable): a pointer to %NULL #GError, or %NULL + * @error: (inout) (optional): a pointer to %NULL #GError, or %NULL * * Initialises (without allocating) a #GWin32RegistrySubkeyIter. @iter may be * completely uninitialised prior to this call; its old value is @@ -42713,7 +42729,7 @@ /** * g_zlib_compressor_set_file_info: * @compressor: a #GZlibCompressor - * @file_info: (allow-none): a #GFileInfo + * @file_info: (nullable): a #GFileInfo * * Sets @file_info in @compressor. If non-%NULL, and @compressor's * #GZlibCompressor:format property is %G_ZLIB_COMPRESSOR_FORMAT_GZIP, diff --git a/gir/glib-2.0.c b/gir/glib-2.0.c index f22e299c..97296056 100644 --- a/gir/glib-2.0.c +++ b/gir/glib-2.0.c @@ -10630,9 +10630,9 @@ * g_bookmark_file_add_application: * @bookmark: a #GBookmarkFile * @uri: a valid URI - * @name: (allow-none): the name of the application registering the bookmark + * @name: (nullable): the name of the application registering the bookmark * or %NULL - * @exec: (allow-none): command line to be used to launch the bookmark or %NULL + * @exec: (nullable): command line to be used to launch the bookmark or %NULL * * Adds the application with @name and @exec to the list of * applications that have registered a bookmark for @uri into @@ -10707,9 +10707,9 @@ * @bookmark: a #GBookmarkFile * @uri: a valid URI * @name: an application's name - * @exec: (allow-none) (out): return location for the command line of the application, or %NULL - * @count: (allow-none) (out): return location for the registration count, or %NULL - * @stamp: (allow-none) (out): return location for the last registration time, or %NULL + * @exec: (out) (optional): return location for the command line of the application, or %NULL + * @count: (out) (optional): return location for the registration count, or %NULL + * @stamp: (out) (optional): return location for the last registration time, or %NULL * @error: return location for a #GError, or %NULL * * Gets the registration informations of @app_name for the bookmark for @@ -10735,7 +10735,7 @@ * g_bookmark_file_get_applications: * @bookmark: a #GBookmarkFile * @uri: a valid URI - * @length: (allow-none) (out): return location of the length of the returned list, or %NULL + * @length: (out) (optional): return location of the length of the returned list, or %NULL * @error: return location for a #GError, or %NULL * * Retrieves the names of the applications that have registered the @@ -10771,7 +10771,7 @@ * g_bookmark_file_get_groups: * @bookmark: a #GBookmarkFile * @uri: a valid URI - * @length: (allow-none) (out): return location for the length of the returned string, or %NULL + * @length: (out) (optional): return location for the length of the returned string, or %NULL * @error: return location for a #GError, or %NULL * * Retrieves the list of group names of the bookmark for @uri. @@ -10792,8 +10792,8 @@ * g_bookmark_file_get_icon: * @bookmark: a #GBookmarkFile * @uri: a valid URI - * @href: (allow-none) (out): return location for the icon's location or %NULL - * @mime_type: (allow-none) (out): return location for the icon's MIME type or %NULL + * @href: (out) (optional): return location for the icon's location or %NULL + * @mime_type: (out) (optional): return location for the icon's MIME type or %NULL * @error: return location for a #GError or %NULL * * Gets the icon of the bookmark for @uri. @@ -10874,7 +10874,7 @@ /** * g_bookmark_file_get_title: * @bookmark: a #GBookmarkFile - * @uri: (allow-none): a valid URI or %NULL + * @uri: (nullable): a valid URI or %NULL * @error: return location for a #GError, or %NULL * * Returns the title of the bookmark for @uri. @@ -10893,7 +10893,7 @@ /** * g_bookmark_file_get_uris: * @bookmark: a #GBookmarkFile - * @length: (allow-none) (out): return location for the number of returned URIs, or %NULL + * @length: (out) (optional): return location for the number of returned URIs, or %NULL * * Returns all URIs of the bookmarks in the bookmark file @bookmark. * The array of returned URIs will be %NULL-terminated, so @length may @@ -10989,7 +10989,7 @@ * g_bookmark_file_load_from_data_dirs: * @bookmark: a #GBookmarkFile * @file: (type filename): a relative path to a filename to open and parse - * @full_path: (type filename) (allow-none): return location for a string + * @full_path: (type filename) (nullable): return location for a string * containing the full path of the file, or %NULL * @error: return location for a #GError, or %NULL * @@ -11024,7 +11024,7 @@ * g_bookmark_file_move_item: * @bookmark: a #GBookmarkFile * @old_uri: a valid URI - * @new_uri: (allow-none): a valid URI, or %NULL + * @new_uri: (nullable): a valid URI, or %NULL * @error: return location for a #GError or %NULL * * Changes the URI of a bookmark item from @old_uri to @new_uri. Any @@ -11169,7 +11169,7 @@ /** * g_bookmark_file_set_description: * @bookmark: a #GBookmarkFile - * @uri: (allow-none): a valid URI or %NULL + * @uri: (nullable): a valid URI or %NULL * @description: a string * * Sets @description as the description of the bookmark for @uri. @@ -11186,7 +11186,7 @@ * g_bookmark_file_set_groups: * @bookmark: a #GBookmarkFile * @uri: an item's URI - * @groups: (allow-none): an array of group names, or %NULL to remove all groups + * @groups: (nullable): an array of group names, or %NULL to remove all groups * @length: number of group name values in @groups * * Sets a list of group names for the item with URI @uri. Each previously @@ -11202,7 +11202,7 @@ * g_bookmark_file_set_icon: * @bookmark: a #GBookmarkFile * @uri: a valid URI - * @href: (allow-none): the URI of the icon for the bookmark, or %NULL + * @href: (nullable): the URI of the icon for the bookmark, or %NULL * @mime_type: the MIME type of the icon for the bookmark * * Sets the icon for the bookmark for @uri. If @href is %NULL, unsets @@ -11265,7 +11265,7 @@ /** * g_bookmark_file_set_title: * @bookmark: a #GBookmarkFile - * @uri: (allow-none): a valid URI or %NULL + * @uri: (nullable): a valid URI or %NULL * @title: a UTF-8 encoded string * * Sets @title as the title of the bookmark for @uri inside the @@ -11302,7 +11302,7 @@ /** * g_bookmark_file_to_data: * @bookmark: a #GBookmarkFile - * @length: (allow-none) (out): return location for the length of the returned string, or %NULL + * @length: (out) (optional): return location for the length of the returned string, or %NULL * @error: return location for a #GError, or %NULL * * This function outputs @bookmark as a string. @@ -12026,7 +12026,7 @@ * Windows a handle for a process (which doesn't have to be a child). * @function: function to call * @data: data to pass to @function - * @notify: (allow-none): function to call when the idle is removed, or %NULL + * @notify: (nullable): function to call when the idle is removed, or %NULL * * Sets a function to be called when the child indicated by @pid * exits, at the priority @priority. @@ -12649,8 +12649,8 @@ * g_datalist_id_dup_data: * @datalist: location of a datalist * @key_id: the #GQuark identifying a data element - * @dup_func: (allow-none): function to duplicate the old value - * @user_data: (allow-none): passed as user_data to @dup_func + * @dup_func: (nullable): function to duplicate the old value + * @user_data: (nullable): passed as user_data to @dup_func * * This is a variant of g_datalist_id_get_data() which * returns a 'duplicate' of the value. @dup_func defines the @@ -12709,10 +12709,10 @@ * g_datalist_id_replace_data: * @datalist: location of a datalist * @key_id: the #GQuark identifying a data element - * @oldval: (allow-none): the old value to compare against - * @newval: (allow-none): the new value to replace it with - * @destroy: (allow-none): destroy notify for the new value - * @old_destroy: (allow-none): destroy notify for the existing value + * @oldval: (nullable): the old value to compare against + * @newval: (nullable): the new value to replace it with + * @destroy: (nullable): destroy notify for the new value + * @old_destroy: (nullable): destroy notify for the existing value * * Compares the member that is associated with @key_id in * @datalist to @oldval, and if they are the same, replace @@ -12738,7 +12738,7 @@ * g_datalist_id_set_data: * @dl: a datalist. * @q: the #GQuark to identify the data element. - * @d: (allow-none): the data element, or %NULL to remove any previous element + * @d: (nullable): the data element, or %NULL to remove any previous element * corresponding to @q. * * Sets the data corresponding to the given #GQuark id. Any previous @@ -12751,7 +12751,7 @@ * g_datalist_id_set_data_full: * @datalist: a datalist. * @key_id: the #GQuark to identify the data element. - * @data: (allow-none): the data element or %NULL to remove any previous element + * @data: (nullable): the data element or %NULL to remove any previous element * corresponding to @key_id. * @destroy_func: the function to call when the data element is * removed. This function will be called with the data @@ -12798,7 +12798,7 @@ * g_datalist_set_data: * @dl: a datalist. * @k: the string to identify the data element. - * @d: (allow-none): the data element, or %NULL to remove any previous element + * @d: (nullable): the data element, or %NULL to remove any previous element * corresponding to @k. * * Sets the data element corresponding to the given string identifier. @@ -12809,7 +12809,7 @@ * g_datalist_set_data_full: * @dl: a datalist. * @k: the string to identify the data element. - * @d: (allow-none): the data element, or %NULL to remove any previous element + * @d: (nullable): the data element, or %NULL to remove any previous element * corresponding to @k. * @f: the function to call when the data element is removed. This * function will be called with the data element and can be used to @@ -13994,9 +13994,9 @@ /** * g_date_time_get_ymd: * @datetime: a #GDateTime. - * @year: (out) (allow-none): the return location for the gregorian year, or %NULL. - * @month: (out) (allow-none): the return location for the month of the year, or %NULL. - * @day: (out) (allow-none): the return location for the day of the month, or %NULL. + * @year: (out) (optional): the return location for the gregorian year, or %NULL. + * @month: (out) (optional): the return location for the month of the year, or %NULL. + * @day: (out) (optional): the return location for the day of the month, or %NULL. * * Retrieves the Gregorian day, month, and year of a given #GDateTime. * @@ -14447,7 +14447,7 @@ /** * g_dcgettext: - * @domain: (allow-none): the translation domain to use, or %NULL to use + * @domain: (nullable): the translation domain to use, or %NULL to use * the domain set with textdomain() * @msgid: message to translate * @category: a locale category @@ -14487,7 +14487,7 @@ /** * g_dgettext: - * @domain: (allow-none): the translation domain to use, or %NULL to use + * @domain: (nullable): the translation domain to use, or %NULL to use * the domain set with textdomain() * @msgid: message to translate * @@ -14539,7 +14539,7 @@ /** * g_dir_make_tmp: - * @tmpl: (type filename) (allow-none): Template for directory name, + * @tmpl: (type filename) (nullable): Template for directory name, * as in g_mkdtemp(), basename only, or %NULL for a default template * @error: return location for a #GError * @@ -14664,7 +14664,7 @@ /** * g_dngettext: - * @domain: (allow-none): the translation domain to use, or %NULL to use + * @domain: (nullable): the translation domain to use, or %NULL to use * the domain set with textdomain() * @msgid: message to translate * @msgid_plural: plural form of the message @@ -14714,7 +14714,7 @@ /** * g_dpgettext: - * @domain: (allow-none): the translation domain to use, or %NULL to use + * @domain: (nullable): the translation domain to use, or %NULL to use * the domain set with textdomain() * @msgctxtid: a combined message context and message id, separated * by a \004 character @@ -14741,7 +14741,7 @@ /** * g_dpgettext2: - * @domain: (allow-none): the translation domain to use, or %NULL to use + * @domain: (nullable): the translation domain to use, or %NULL to use * the domain set with textdomain() * @context: the message context * @msgid: the message @@ -14764,7 +14764,7 @@ /** * g_environ_getenv: - * @envp: (allow-none) (array zero-terminated=1) (transfer none): an environment + * @envp: (nullable) (array zero-terminated=1) (transfer none): an environment * list (eg, as returned from g_get_environ()), or %NULL * for an empty environment list * @variable: the environment variable to get @@ -14782,7 +14782,7 @@ /** * g_environ_setenv: - * @envp: (allow-none) (array zero-terminated=1) (transfer full): an + * @envp: (nullable) (array zero-terminated=1) (transfer full): an * environment list that can be freed using g_strfreev() (e.g., as * returned from g_get_environ()), or %NULL for an empty * environment list @@ -14801,7 +14801,7 @@ /** * g_environ_unsetenv: - * @envp: (allow-none) (array zero-terminated=1) (transfer full): an environment + * @envp: (nullable) (array zero-terminated=1) (transfer full): an environment * list that can be freed using g_strfreev() (e.g., as returned from g_get_environ()), * or %NULL for an empty environment list * @variable: the environment variable to remove, must not contain '=' @@ -14947,7 +14947,7 @@ * @filename: (type filename): name of a file to read contents from, in the GLib file name encoding * @contents: (out) (array length=length) (element-type guint8): location to store an allocated string, use g_free() to free * the returned string - * @length: (allow-none): location to store length in bytes of the contents, or %NULL + * @length: (nullable): location to store length in bytes of the contents, or %NULL * @error: return location for a #GError, or %NULL * * Reads an entire file into allocated memory, with good error @@ -14967,7 +14967,7 @@ /** * g_file_open_tmp: - * @tmpl: (type filename) (allow-none): Template for file name, as in + * @tmpl: (type filename) (nullable): Template for file name, as in * g_mkstemp(), basename only, or %NULL for a default template * @name_used: (out) (type filename): location to store actual name used, * or %NULL @@ -15161,8 +15161,7 @@ /** * g_filename_from_uri: * @uri: a uri describing a filename (escaped, encoded in ASCII). - * @hostname: (out) (optional) (nullable): Location to store hostname for the - * URI. + * @hostname: (out) (optional): Location to store hostname for the URI. * If there is no hostname in the URI, %NULL will be * stored in this location. * @error: location to store the error occurring, or %NULL to ignore @@ -15209,7 +15208,7 @@ * @filename: (type filename): an absolute filename specified in the GLib file * name encoding, which is the on-disk file name bytes on Unix, and UTF-8 * on Windows - * @hostname: (allow-none): A UTF-8 encoded hostname, or %NULL for none. + * @hostname: (nullable): A UTF-8 encoded hostname, or %NULL for none. * @error: location to store the error occurring, or %NULL to ignore * errors. Any of the errors in #GConvertError may occur. * @@ -15378,7 +15377,7 @@ /** * g_free: - * @mem: (allow-none): the memory to free + * @mem: (nullable): the memory to free * * Frees the memory pointed to by @mem. * @@ -15392,7 +15391,7 @@ * @filename: (type filename): a pathname in the GLib file name encoding * (UTF-8 on Windows) * @mode: a string describing the mode in which the file should be opened - * @stream: (allow-none): an existing stream which will be reused, or %NULL + * @stream: (nullable): an existing stream which will be reused, or %NULL * * A wrapper for the POSIX freopen() function. The freopen() function * opens a file and associates it with an existing stream. @@ -16198,7 +16197,7 @@ * g_hash_table_iter_next: * @iter: an initialized #GHashTableIter * @key: (out) (optional): a location to store the key - * @value: (out) (nullable) (optional): a location to store the value + * @value: (out) (optional): a location to store the value * * Advances @iter and retrieves the key and/or value that are now * pointed to as a result of this advancement. If %FALSE is returned, @@ -16284,8 +16283,8 @@ * g_hash_table_lookup_extended: * @hash_table: a #GHashTable * @lookup_key: the key to look up - * @orig_key: (out) (optional) (nullable): return location for the original key - * @value: (out) (optional) (nullable): return location for the value associated + * @orig_key: (out) (optional): return location for the original key + * @value: (out) (optional): return location for the value associated * with the key * * Looks up a key in the #GHashTable, returning the original key and the @@ -17056,7 +17055,7 @@ * range between #G_PRIORITY_DEFAULT_IDLE and #G_PRIORITY_HIGH_IDLE. * @function: function to call * @data: data to pass to @function - * @notify: (allow-none): function to call when the idle is removed, or %NULL + * @notify: (nullable): function to call when the idle is removed, or %NULL * * Adds a function to be called whenever there are no higher priority * events pending. If the function returns %FALSE it is automatically @@ -17191,7 +17190,7 @@ /** * g_intern_static_string: - * @string: (allow-none): a static string + * @string: (nullable): a static string * * Returns a canonical representation for @string. Interned strings * can be compared for equality by comparing the pointers, instead of @@ -17205,7 +17204,7 @@ /** * g_intern_string: - * @string: (allow-none): a string + * @string: (nullable): a string * * Returns a canonical representation for @string. Interned strings * can be compared for equality by comparing the pointers, instead of @@ -17429,7 +17428,7 @@ * @count: (in): the size of the buffer. Note that the buffer may not be * complelely filled even if there is data in the buffer if the * remaining data is not a complete character. - * @bytes_read: (allow-none) (out): The number of bytes read. This may be + * @bytes_read: (out) (optional): The number of bytes read. This may be * zero even on success if count < 6 and the channel's encoding * is non-%NULL. This indicates that the next UTF-8 character is * too wide for the buffer. @@ -17449,8 +17448,8 @@ * line terminator. This data should be freed with g_free() * when no longer needed. This is a nul-terminated string. * If a @length of zero is returned, this will be %NULL instead. - * @length: (allow-none) (out): location to store length of the read data, or %NULL - * @terminator_pos: (allow-none) (out): location to store position of line terminator, or %NULL + * @length: (out) (optional): location to store length of the read data, or %NULL + * @terminator_pos: (out) (optional): location to store position of line terminator, or %NULL * @error: A location to return an error of type #GConvertError * or #GIOChannelError * @@ -17469,7 +17468,7 @@ * @buffer: a #GString into which the line will be written. * If @buffer already contains data, the old data will * be overwritten. - * @terminator_pos: (allow-none): location to store position of line terminator, or %NULL + * @terminator_pos: (nullable): location to store position of line terminator, or %NULL * @error: a location to store an error of type #GConvertError * or #GIOChannelError * @@ -17607,7 +17606,7 @@ /** * g_io_channel_set_encoding: * @channel: a #GIOChannel - * @encoding: (allow-none): the encoding type + * @encoding: (nullable): the encoding type * @error: location to store an error of type #GConvertError * * Sets the encoding for the input/output of the channel. @@ -17664,7 +17663,7 @@ /** * g_io_channel_set_line_term: * @channel: a #GIOChannel - * @line_term: (allow-none): The line termination string. Use %NULL for + * @line_term: (nullable): The line termination string. Use %NULL for * autodetect. Autodetection breaks on "\n", "\r\n", "\r", "\0", * and the Unicode paragraph separator. Autodetection should not be * used for anything other than file-based channels. @@ -17936,7 +17935,7 @@ /** * g_key_file_get_comment: * @key_file: a #GKeyFile - * @group_name: (allow-none): a group name, or %NULL + * @group_name: (nullable): a group name, or %NULL * @key: a key * @error: return location for a #GError * @@ -18000,7 +17999,7 @@ /** * g_key_file_get_groups: * @key_file: a #GKeyFile - * @length: (out) (allow-none): return location for the number of returned groups, or %NULL + * @length: (out) (optional): return location for the number of returned groups, or %NULL * * Returns all groups in the key file loaded with @key_file. * The array of returned groups will be %NULL-terminated, so @@ -18078,7 +18077,7 @@ * g_key_file_get_keys: * @key_file: a #GKeyFile * @group_name: a group name - * @length: (out) (allow-none): return location for the number of keys returned, or %NULL + * @length: (out) (optional): return location for the number of keys returned, or %NULL * @error: return location for a #GError, or %NULL * * Returns all keys for the group name @group_name. The array of @@ -18098,7 +18097,7 @@ * @key_file: a #GKeyFile * @group_name: a group name * @key: a key - * @locale: (allow-none): a locale identifier or %NULL + * @locale: (nullable): a locale identifier or %NULL * @error: return location for a #GError, or %NULL * * Returns the value associated with @key under @group_name @@ -18121,8 +18120,8 @@ * @key_file: a #GKeyFile * @group_name: a group name * @key: a key - * @locale: (allow-none): a locale identifier or %NULL - * @length: (out) (allow-none): return location for the number of returned strings or %NULL + * @locale: (nullable): a locale identifier or %NULL + * @length: (out) (optional): return location for the number of returned strings or %NULL * @error: return location for a #GError or %NULL * * Returns the values associated with @key under @group_name @@ -18181,7 +18180,7 @@ * @key_file: a #GKeyFile * @group_name: a group name * @key: a key - * @length: (out) (allow-none): return location for the number of returned strings, or %NULL + * @length: (out) (optional): return location for the number of returned strings, or %NULL * @error: return location for a #GError, or %NULL * * Returns the values associated with @key under @group_name. @@ -18307,7 +18306,7 @@ * g_key_file_load_from_data_dirs: * @key_file: an empty #GKeyFile struct * @file: (type filename): a relative path to a filename to open and parse - * @full_path: (out) (type filename) (allow-none): return location for a string containing the full path + * @full_path: (out) (type filename) (optional): return location for a string containing the full path * of the file, or %NULL * @flags: flags from #GKeyFileFlags * @error: return location for a #GError, or %NULL @@ -18328,7 +18327,7 @@ * @key_file: an empty #GKeyFile struct * @file: (type filename): a relative path to a filename to open and parse * @search_dirs: (array zero-terminated=1) (element-type filename): %NULL-terminated array of directories to search - * @full_path: (out) (type filename) (allow-none): return location for a string containing the full path + * @full_path: (out) (type filename) (optional): return location for a string containing the full path * of the file, or %NULL * @flags: flags from #GKeyFileFlags * @error: return location for a #GError, or %NULL @@ -18387,8 +18386,8 @@ /** * g_key_file_remove_comment: * @key_file: a #GKeyFile - * @group_name: (allow-none): a group name, or %NULL - * @key: (allow-none): a key + * @group_name: (nullable): a group name, or %NULL + * @key: (nullable): a key * @error: return location for a #GError * * Removes a comment above @key from @group_name. @@ -18479,8 +18478,8 @@ /** * g_key_file_set_comment: * @key_file: a #GKeyFile - * @group_name: (allow-none): a group name, or %NULL - * @key: (allow-none): a key + * @group_name: (nullable): a group name, or %NULL + * @key: (nullable): a key * @comment: a comment * @error: return location for a #GError * @@ -18683,7 +18682,7 @@ /** * g_key_file_to_data: * @key_file: a #GKeyFile - * @length: (out) (allow-none): return location for the length of the + * @length: (out) (optional): return location for the length of the * returned string, or %NULL * @error: return location for a #GError, or %NULL * @@ -19447,7 +19446,7 @@ /** * g_log_set_handler: - * @log_domain: (allow-none): the log domain, or %NULL for the default "" + * @log_domain: (nullable): the log domain, or %NULL for the default "" * application domain * @log_levels: the log levels to apply the log handler for. * To handle fatal and recursive messages as well, combine @@ -19493,7 +19492,7 @@ /** * g_log_set_handler_full: (rename-to g_log_set_handler) - * @log_domain: (allow-none): the log domain, or %NULL for the default "" + * @log_domain: (nullable): the log domain, or %NULL for the default "" * application domain * @log_levels: the log levels to apply the log handler for. * To handle fatal and recursive messages as well, combine @@ -19647,7 +19646,7 @@ /** * g_log_variant: - * @log_domain: (allow-none): log domain, usually %G_LOG_DOMAIN + * @log_domain: (nullable): log domain, usually %G_LOG_DOMAIN * @log_level: log level, either from #GLogLevelFlags, or a user-defined * level * @fields: a dictionary (#GVariant of the type %G_VARIANT_TYPE_VARDICT) @@ -19870,7 +19869,7 @@ /** * g_main_context_add_poll: - * @context: (allow-none): a #GMainContext (or %NULL for the default context) + * @context: (nullable): a #GMainContext (or %NULL for the default context) * @fd: a #GPollFD structure holding information about a file * descriptor to watch. * @priority: the priority for this file descriptor which should be @@ -19925,7 +19924,7 @@ /** * g_main_context_find_source_by_funcs_user_data: - * @context: (allow-none): a #GMainContext (if %NULL, the default context will be used). + * @context: (nullable): a #GMainContext (if %NULL, the default context will be used). * @funcs: the @source_funcs passed to g_source_new(). * @user_data: the user data from the callback. * @@ -19939,7 +19938,7 @@ /** * g_main_context_find_source_by_id: - * @context: (allow-none): a #GMainContext (if %NULL, the default context will be used) + * @context: (nullable): a #GMainContext (if %NULL, the default context will be used) * @source_id: the source ID, as returned by g_source_get_id(). * * Finds a #GSource given a pair of context and ID. @@ -20005,7 +20004,7 @@ /** * g_main_context_invoke: - * @context: (allow-none): a #GMainContext, or %NULL + * @context: (nullable): a #GMainContext, or %NULL * @function: function to call * @data: data to pass to @function * @@ -20037,11 +20036,11 @@ /** * g_main_context_invoke_full: - * @context: (allow-none): a #GMainContext, or %NULL + * @context: (nullable): a #GMainContext, or %NULL * @priority: the priority at which to run @function * @function: function to call * @data: data to pass to @function - * @notify: (allow-none): a function to call when @data is no longer in use, or %NULL. + * @notify: (nullable): a function to call when @data is no longer in use, or %NULL. * * Invokes a function in such a way that @context is owned during the * invocation of @function. @@ -20073,7 +20072,7 @@ /** * g_main_context_iteration: - * @context: (allow-none): a #GMainContext (if %NULL, the default context will be used) + * @context: (nullable): a #GMainContext (if %NULL, the default context will be used) * @may_block: whether the call may block. * * Runs a single iteration for the given main loop. This involves @@ -20104,7 +20103,7 @@ /** * g_main_context_pending: - * @context: (allow-none): a #GMainContext (if %NULL, the default context will be used) + * @context: (nullable): a #GMainContext (if %NULL, the default context will be used) * * Checks if any sources have pending events for the given context. * @@ -20114,7 +20113,7 @@ /** * g_main_context_pop_thread_default: - * @context: (allow-none): a #GMainContext object, or %NULL + * @context: (nullable): a #GMainContext object, or %NULL * * Pops @context off the thread-default context stack (verifying that * it was on the top of the stack). @@ -20142,7 +20141,7 @@ /** * g_main_context_push_thread_default: - * @context: (allow-none): a #GMainContext, or %NULL for the global default context + * @context: (nullable): a #GMainContext, or %NULL for the global default context * * Acquires @context and sets it as the thread-default context for the * current thread. This will cause certain asynchronous operations @@ -20471,7 +20470,7 @@ /** * g_main_loop_new: - * @context: (allow-none): a #GMainContext (if %NULL, the default context will be used). + * @context: (nullable): a #GMainContext (if %NULL, the default context will be used). * @is_running: set to %TRUE to indicate that the loop is running. This * is not very important since calling g_main_loop_run() will set this to * %TRUE anyway. @@ -20843,8 +20842,8 @@ /** * g_markup_parse_context_get_position: * @context: a #GMarkupParseContext - * @line_number: (allow-none): return location for a line number, or %NULL - * @char_number: (allow-none): return location for a char-on-line number, or %NULL + * @line_number: (nullable): return location for a line number, or %NULL + * @char_number: (nullable): return location for a char-on-line number, or %NULL * * Retrieves the current line number and the number of the character on * that line. Intended for use in error messages; there are no strict @@ -21127,7 +21126,7 @@ /** * g_match_info_expand_references: - * @match_info: (allow-none): a #GMatchInfo or %NULL + * @match_info: (nullable): a #GMatchInfo or %NULL * @string_to_expand: the string to expand * @error: location to store the error occurring, or %NULL to ignore errors * @@ -21149,7 +21148,7 @@ * Use g_regex_check_replacement() to find out whether @string_to_expand * contains references. * - * Returns: (allow-none): the expanded string, or %NULL if an error occurred + * Returns: (nullable): the expanded string, or %NULL if an error occurred * Since: 2.14 */ @@ -21176,7 +21175,7 @@ * The string is fetched from the string passed to the match function, * so you cannot call this function after freeing the string. * - * Returns: (allow-none): The matched substring, or %NULL if an error + * Returns: (nullable): The matched substring, or %NULL if an error * occurred. You have to free the string yourself * Since: 2.14 */ @@ -21224,7 +21223,7 @@ * The string is fetched from the string passed to the match function, * so you cannot call this function after freeing the string. * - * Returns: (allow-none): The matched substring, or %NULL if an error + * Returns: (nullable): The matched substring, or %NULL if an error * occurred. You have to free the string yourself * Since: 2.14 */ @@ -21234,9 +21233,9 @@ * g_match_info_fetch_named_pos: * @match_info: #GMatchInfo structure * @name: name of the subexpression - * @start_pos: (out) (allow-none): pointer to location where to store + * @start_pos: (out) (optional): pointer to location where to store * the start position, or %NULL - * @end_pos: (out) (allow-none): pointer to location where to store + * @end_pos: (out) (optional): pointer to location where to store * the end position, or %NULL * * Retrieves the position in bytes of the capturing parentheses named @name. @@ -21256,9 +21255,9 @@ * g_match_info_fetch_pos: * @match_info: #GMatchInfo structure * @match_num: number of the sub expression - * @start_pos: (out) (allow-none): pointer to location where to store + * @start_pos: (out) (optional): pointer to location where to store * the start position, or %NULL - * @end_pos: (out) (allow-none): pointer to location where to store + * @end_pos: (out) (optional): pointer to location where to store * the end position, or %NULL * * Retrieves the position in bytes of the @match_num'th capturing @@ -21284,7 +21283,7 @@ /** * g_match_info_free: - * @match_info: (allow-none): a #GMatchInfo, or %NULL + * @match_info: (nullable): a #GMatchInfo, or %NULL * * If @match_info is not %NULL, calls g_match_info_unref(); otherwise does * nothing. @@ -22291,7 +22290,7 @@ * g_option_context_add_main_entries: * @context: a #GOptionContext * @entries: a %NULL-terminated array of #GOptionEntrys - * @translation_domain: (allow-none): a translation domain to use for translating + * @translation_domain: (nullable): a translation domain to use for translating * the `--help` output for the options in @entries * with gettext(), or %NULL * @@ -22331,7 +22330,7 @@ * g_option_context_get_help: * @context: a #GOptionContext * @main_help: if %TRUE, only include the main group - * @group: (allow-none): the #GOptionGroup to create help for, or %NULL + * @group: (nullable): the #GOptionGroup to create help for, or %NULL * * Returns a formatted, translated help text for the given context. * To obtain the text produced by `--help`, call @@ -22409,7 +22408,7 @@ /** * g_option_context_new: - * @parameter_string: (allow-none): a string which is displayed in + * @parameter_string: (nullable): a string which is displayed in * the first line of `--help` output, after the usage summary * `programname [OPTION...]` * @@ -22442,8 +22441,8 @@ /** * g_option_context_parse: * @context: a #GOptionContext - * @argc: (inout) (allow-none): a pointer to the number of command line arguments - * @argv: (inout) (array length=argc) (allow-none): a pointer to the array of command line arguments + * @argc: (inout) (optional): a pointer to the number of command line arguments + * @argv: (inout) (array length=argc) (optional): a pointer to the array of command line arguments * @error: a return location for errors * * Parses the command line arguments, recognizing options @@ -22507,7 +22506,7 @@ /** * g_option_context_set_description: * @context: a #GOptionContext - * @description: (allow-none): a string to be shown in `--help` output + * @description: (nullable): a string to be shown in `--help` output * after the list of options, or %NULL * * Adds a string to be displayed in `--help` output after the list @@ -22603,7 +22602,7 @@ /** * g_option_context_set_summary: * @context: a #GOptionContext - * @summary: (allow-none): a string to be shown in `--help` output + * @summary: (nullable): a string to be shown in `--help` output * before the list of options, or %NULL * * Adds a string to be displayed in `--help` output before the list @@ -22620,9 +22619,9 @@ /** * g_option_context_set_translate_func: * @context: a #GOptionContext - * @func: (allow-none): the #GTranslateFunc, or %NULL - * @data: (allow-none): user data to pass to @func, or %NULL - * @destroy_notify: (allow-none): a function which gets called to free @data, or %NULL + * @func: (nullable): the #GTranslateFunc, or %NULL + * @data: (nullable): user data to pass to @func, or %NULL + * @destroy_notify: (nullable): a function which gets called to free @data, or %NULL * * Sets the function which is used to translate the contexts * user-visible strings, for `--help` output. If @func is %NULL, @@ -22685,9 +22684,9 @@ * @help_description: a description for the `--help-`@name option. * This string is translated using the translation domain or translation function * of the group - * @user_data: (allow-none): user data that will be passed to the pre- and post-parse hooks, + * @user_data: (nullable): user data that will be passed to the pre- and post-parse hooks, * the error hook and to callbacks of %G_OPTION_ARG_CALLBACK options, or %NULL - * @destroy: (allow-none): a function that will be called to free @user_data, or %NULL + * @destroy: (nullable): a function that will be called to free @user_data, or %NULL * * Creates a new #GOptionGroup. * @@ -22726,8 +22725,8 @@ /** * g_option_group_set_parse_hooks: * @group: a #GOptionGroup - * @pre_parse_func: (allow-none): a function to call before parsing, or %NULL - * @post_parse_func: (allow-none): a function to call after parsing, or %NULL + * @pre_parse_func: (nullable): a function to call before parsing, or %NULL + * @post_parse_func: (nullable): a function to call after parsing, or %NULL * * Associates two functions with @group which will be called * from g_option_context_parse() before the first option is parsed @@ -22744,9 +22743,9 @@ /** * g_option_group_set_translate_func: * @group: a #GOptionGroup - * @func: (allow-none): the #GTranslateFunc, or %NULL - * @data: (allow-none): user data to pass to @func, or %NULL - * @destroy_notify: (allow-none): a function which gets called to free @data, or %NULL + * @func: (nullable): the #GTranslateFunc, or %NULL + * @data: (nullable): user data to pass to @func, or %NULL + * @destroy_notify: (nullable): a function which gets called to free @data, or %NULL * * Sets the function which is used to translate user-visible strings, * for `--help` output. Different groups can use different @@ -22785,7 +22784,7 @@ /** * g_parse_debug_string: - * @string: (allow-none): a list of debug options separated by colons, spaces, or + * @string: (nullable): a list of debug options separated by colons, spaces, or * commas, or %NULL. * @keys: (array length=nkeys): pointer to an array of #GDebugKey which associate * strings with bit flags. @@ -22889,7 +22888,7 @@ * @string_length: the length of @string (in bytes, i.e. strlen(), * not g_utf8_strlen()) * @string: the UTF-8 encoded string to match - * @string_reversed: (allow-none): the reverse of @string or %NULL + * @string_reversed: (nullable): the reverse of @string or %NULL * * Matches a string against a compiled pattern. Passing the correct * length of the string given is mandatory. The reversed string can be @@ -23049,7 +23048,7 @@ /** * g_prefix_error: - * @err: (inout) (optional) (nullable): a return location for a #GError + * @err: (inout) (optional): a return location for a #GError * @format: printf()-style format string * @...: arguments to @format * @@ -23285,7 +23284,7 @@ /** * g_ptr_array_new_full: * @reserved_size: number of pointers preallocated - * @element_free_func: (allow-none): A function to free elements with + * @element_free_func: (nullable): A function to free elements with * destroy @array or %NULL * * Creates a new #GPtrArray with @reserved_size pointers preallocated @@ -23303,7 +23302,7 @@ /** * g_ptr_array_new_with_free_func: - * @element_free_func: (allow-none): A function to free elements with + * @element_free_func: (nullable): A function to free elements with * destroy @array or %NULL * * Creates a new #GPtrArray with a reference count of 1 and use @@ -23412,7 +23411,7 @@ /** * g_ptr_array_set_free_func: * @array: A #GPtrArray - * @element_free_func: (allow-none): A function to free elements with + * @element_free_func: (nullable): A function to free elements with * destroy @array or %NULL * * Sets a function for freeing each element when @array is destroyed @@ -23513,7 +23512,7 @@ /** * g_quark_from_static_string: - * @string: (allow-none): a string + * @string: (nullable): a string * * Gets the #GQuark identifying the given (static) string. If the * string does not currently have an associated #GQuark, a new #GQuark @@ -23534,7 +23533,7 @@ /** * g_quark_from_string: - * @string: (allow-none): a string + * @string: (nullable): a string * * Gets the #GQuark identifying the given string. If the string does * not currently have an associated #GQuark, a new #GQuark is created, @@ -23556,7 +23555,7 @@ /** * g_quark_try_string: - * @string: (allow-none): a string + * @string: (nullable): a string * * Gets the #GQuark associated with the given string, or 0 if string is * %NULL or it has no associated #GQuark. @@ -24262,7 +24261,7 @@ /** * g_realloc: - * @mem: (allow-none): the memory to reallocate + * @mem: (nullable): the memory to reallocate * @n_bytes: new size of the memory in bytes * * Reallocates the memory pointed to by @mem, so that it now has space for @@ -24277,7 +24276,7 @@ /** * g_realloc_n: - * @mem: (allow-none): the memory to reallocate + * @mem: (nullable): the memory to reallocate * @n_blocks: the number of blocks to allocate * @n_block_bytes: the size of each block in bytes * @@ -24387,7 +24386,7 @@ /** * g_regex_check_replacement: * @replacement: the replacement string - * @has_references: (out) (allow-none): location to store information about + * @has_references: (out) (optional): location to store information about * references in @replacement or %NULL * @error: location to store error * @@ -24544,7 +24543,7 @@ * @regex: a #GRegex structure from g_regex_new() * @string: the string to scan for matches * @match_options: match options - * @match_info: (out) (allow-none): pointer to location where to store + * @match_info: (out) (optional): pointer to location where to store * the #GMatchInfo, or %NULL if you do not need it * * Scans for a match in string for the pattern in @regex. @@ -24596,7 +24595,7 @@ * @regex: a #GRegex structure from g_regex_new() * @string: the string to scan for matches * @match_options: match options - * @match_info: (out) (allow-none): pointer to location where to store + * @match_info: (out) (optional): pointer to location where to store * the #GMatchInfo, or %NULL if you do not need it * * Using the standard algorithm for regular expression matching only @@ -24626,7 +24625,7 @@ * @string_len: the length of @string, or -1 if @string is nul-terminated * @start_position: starting index of the string to match, in bytes * @match_options: match options - * @match_info: (out) (allow-none): pointer to location where to store + * @match_info: (out) (optional): pointer to location where to store * the #GMatchInfo, or %NULL if you do not need it * @error: location to store the error occurring, or %NULL to ignore errors * @@ -24679,7 +24678,7 @@ * @string_len: the length of @string, or -1 if @string is nul-terminated * @start_position: starting index of the string to match, in bytes * @match_options: match options - * @match_info: (out) (allow-none): pointer to location where to store + * @match_info: (out) (optional): pointer to location where to store * the #GMatchInfo, or %NULL if you do not need it * @error: location to store the error occurring, or %NULL to ignore errors * @@ -25954,7 +25953,7 @@ /** * g_sequence_new: - * @data_destroy: (allow-none): a #GDestroyNotify function, or %NULL + * @data_destroy: (nullable): a #GDestroyNotify function, or %NULL * * Creates a new GSequence. The @data_destroy function, if non-%NULL will * be called on all items when the sequence is destroyed and on items that @@ -27175,7 +27174,7 @@ /** * g_source_attach: * @source: a #GSource - * @context: (allow-none): a #GMainContext (if %NULL, the default context will be used) + * @context: (nullable): a #GMainContext (if %NULL, the default context will be used) * * Adds a #GSource to a @context so that it will be executed within * that context. Remove it by calling g_source_destroy(). @@ -27220,7 +27219,7 @@ * g_main_current_source(). But calling this function on a source * whose #GMainContext has been destroyed is an error. * - * Returns: (transfer none) (allow-none): the #GMainContext with which the + * Returns: (transfer none) (nullable): the #GMainContext with which the * source is associated, or %NULL if the context has not * yet been added to a source. */ @@ -27554,7 +27553,7 @@ * @source: the source * @func: a callback function * @data: the data to pass to callback function - * @notify: (allow-none): a function to call when @data is no longer in use, or %NULL. + * @notify: (nullable): a function to call when @data is no longer in use, or %NULL. * * Sets the callback function for a source. The callback for a source is * called from the source's dispatch function. @@ -27737,13 +27736,13 @@ /** * g_spawn_async: - * @working_directory: (type filename) (allow-none): child's current working directory, or %NULL to inherit parent's + * @working_directory: (type filename) (nullable): child's current working directory, or %NULL to inherit parent's * @argv: (array zero-terminated=1): child's argument vector - * @envp: (array zero-terminated=1) (allow-none): child's environment, or %NULL to inherit parent's + * @envp: (array zero-terminated=1) (nullable): child's environment, or %NULL to inherit parent's * @flags: flags from #GSpawnFlags - * @child_setup: (scope async) (allow-none): function to run in the child just before exec() + * @child_setup: (scope async) (nullable): function to run in the child just before exec() * @user_data: (closure): user data for @child_setup - * @child_pid: (out) (allow-none): return location for child process reference, or %NULL + * @child_pid: (out) (optional): return location for child process reference, or %NULL * @error: return location for error * * See g_spawn_async_with_pipes() for a full description; this function @@ -27767,16 +27766,16 @@ /** * g_spawn_async_with_pipes: - * @working_directory: (type filename) (allow-none): child's current working directory, or %NULL to inherit parent's, in the GLib file name encoding + * @working_directory: (type filename) (nullable): child's current working directory, or %NULL to inherit parent's, in the GLib file name encoding * @argv: (array zero-terminated=1): child's argument vector, in the GLib file name encoding - * @envp: (array zero-terminated=1) (allow-none): child's environment, or %NULL to inherit parent's, in the GLib file name encoding + * @envp: (array zero-terminated=1) (nullable): child's environment, or %NULL to inherit parent's, in the GLib file name encoding * @flags: flags from #GSpawnFlags - * @child_setup: (scope async) (allow-none): function to run in the child just before exec() + * @child_setup: (scope async) (nullable): function to run in the child just before exec() * @user_data: (closure): user data for @child_setup - * @child_pid: (out) (allow-none): return location for child process ID, or %NULL - * @standard_input: (out) (allow-none): return location for file descriptor to write to child's stdin, or %NULL - * @standard_output: (out) (allow-none): return location for file descriptor to read child's stdout, or %NULL - * @standard_error: (out) (allow-none): return location for file descriptor to read child's stderr, or %NULL + * @child_pid: (out) (optional): return location for child process ID, or %NULL + * @standard_input: (out) (optional): return location for file descriptor to write to child's stdin, or %NULL + * @standard_output: (out) (optional): return location for file descriptor to read child's stdout, or %NULL + * @standard_error: (out) (optional): return location for file descriptor to read child's stderr, or %NULL * @error: return location for error * * Executes a child program asynchronously (your program will not @@ -28014,9 +28013,9 @@ /** * g_spawn_command_line_sync: * @command_line: a command line - * @standard_output: (out) (array zero-terminated=1) (element-type guint8) (allow-none): return location for child output - * @standard_error: (out) (array zero-terminated=1) (element-type guint8) (allow-none): return location for child errors - * @exit_status: (out) (allow-none): return location for child exit status, as returned by waitpid() + * @standard_output: (out) (array zero-terminated=1) (element-type guint8) (optional): return location for child output + * @standard_error: (out) (array zero-terminated=1) (element-type guint8) (optional): return location for child errors + * @exit_status: (out) (optional): return location for child exit status, as returned by waitpid() * @error: return location for errors * * A simple version of g_spawn_sync() with little-used parameters @@ -28048,15 +28047,15 @@ /** * g_spawn_sync: - * @working_directory: (type filename) (allow-none): child's current working directory, or %NULL to inherit parent's + * @working_directory: (type filename) (nullable): child's current working directory, or %NULL to inherit parent's * @argv: (array zero-terminated=1): child's argument vector - * @envp: (array zero-terminated=1) (allow-none): child's environment, or %NULL to inherit parent's + * @envp: (array zero-terminated=1) (nullable): child's environment, or %NULL to inherit parent's * @flags: flags from #GSpawnFlags - * @child_setup: (scope async) (allow-none): function to run in the child just before exec() + * @child_setup: (scope async) (nullable): function to run in the child just before exec() * @user_data: (closure): user data for @child_setup - * @standard_output: (out) (array zero-terminated=1) (element-type guint8) (allow-none): return location for child output, or %NULL - * @standard_error: (out) (array zero-terminated=1) (element-type guint8) (allow-none): return location for child error messages, or %NULL - * @exit_status: (out) (allow-none): return location for child exit status, as returned by waitpid(), or %NULL + * @standard_output: (out) (array zero-terminated=1) (element-type guint8) (optional): return location for child output, or %NULL + * @standard_error: (out) (array zero-terminated=1) (element-type guint8) (optional): return location for child error messages, or %NULL + * @exit_status: (out) (optional): return location for child exit status, as returned by waitpid(), or %NULL * @error: return location for error, or %NULL * * Executes a child synchronously (waits for the child to exit before returning). @@ -28266,7 +28265,7 @@ /** * g_str_to_ascii: * @str: a string, in UTF-8 - * @from_locale: (allow-none): the source locale, if known + * @from_locale: (nullable): the source locale, if known * * Transliterate @str to plain ASCII. * @@ -28295,7 +28294,7 @@ /** * g_str_tokenize_and_fold: * @string: a string - * @translit_locale: (allow-none): the language code (like 'de' or + * @translit_locale: (nullable): the language code (like 'de' or * 'en_GB') from which @string originates * @ascii_alternates: (out) (transfer full) (array zero-terminated=1): a * return location for ASCII alternates @@ -28393,8 +28392,8 @@ /** * g_strcmp0: - * @str1: (allow-none): a C string or %NULL - * @str2: (allow-none): another C string or %NULL + * @str1: (nullable): a C string or %NULL + * @str2: (nullable): another C string or %NULL * * Compares @str1 and @str2 like strcmp(). Handles %NULL * gracefully by sorting it before non-%NULL strings. @@ -28440,7 +28439,7 @@ /** * g_strdelimit: * @string: the string to convert - * @delimiters: (allow-none): a string containing the current delimiters, + * @delimiters: (nullable): a string containing the current delimiters, * or %NULL to use the standard delimiters defined in #G_STR_DELIMITERS * @new_delimiter: the new delimiter character * @@ -29196,7 +29195,7 @@ /** * g_strjoin: - * @separator: (allow-none): a string to insert between each of the + * @separator: (nullable): a string to insert between each of the * strings, or %NULL * @...: a %NULL-terminated list of strings to join * @@ -29211,7 +29210,7 @@ /** * g_strjoinv: - * @separator: (allow-none): a string to insert between each of the + * @separator: (nullable): a string to insert between each of the * strings, or %NULL * @str_array: a %NULL-terminated array of strings to join * @@ -29749,7 +29748,7 @@ /** * g_test_expect_message: - * @log_domain: (allow-none): the log domain of the message + * @log_domain: (nullable): the log domain of the message * @log_level: the log level of the message * @pattern: a glob-style [pattern][glib-Glob-style-pattern-matching] * @@ -29883,7 +29882,7 @@ /** * g_test_incomplete: - * @msg: (allow-none): explanation + * @msg: (nullable): explanation * * Indicates that a test failed because of some incomplete * functionality. This function can be called multiple times @@ -30282,7 +30281,7 @@ /** * g_test_skip: - * @msg: (allow-none): explanation + * @msg: (nullable): explanation * * Indicates that a test was skipped. * @@ -30523,7 +30522,7 @@ /** * g_test_trap_subprocess: - * @test_path: (allow-none): Test to run in a subprocess + * @test_path: (nullable): Test to run in a subprocess * @usec_timeout: Timeout for the subprocess test in micro seconds. * @test_flags: Flags to modify subprocess behaviour. * @@ -30661,7 +30660,7 @@ /** * g_thread_new: - * @name: (allow-none): an (optional) name for the new thread + * @name: (nullable): an (optional) name for the new thread * @func: a function to execute in the new thread * @data: an argument to supply to the new thread * @@ -30998,7 +30997,7 @@ /** * g_thread_try_new: - * @name: (allow-none): an (optional) name for the new thread + * @name: (nullable): an (optional) name for the new thread * @func: a function to execute in the new thread * @data: an argument to supply to the new thread * @error: return location for error, or %NULL @@ -31205,7 +31204,7 @@ /** * g_time_zone_new: - * @identifier: (allow-none): a timezone identifier + * @identifier: (nullable): a timezone identifier * * Creates a #GTimeZone corresponding to @identifier. * @@ -31379,7 +31378,7 @@ * (1/1000ths of a second) * @function: function to call * @data: data to pass to @function - * @notify: (allow-none): function to call when the timeout is removed, or %NULL + * @notify: (nullable): function to call when the timeout is removed, or %NULL * * Sets a function to be called at regular intervals, with the given * priority. The function is called repeatedly until it returns @@ -31448,7 +31447,7 @@ * @interval: the time between calls to the function, in seconds * @function: function to call * @data: data to pass to @function - * @notify: (allow-none): function to call when the timeout is removed, or %NULL + * @notify: (nullable): function to call when the timeout is removed, or %NULL * * Sets a function to be called at regular intervals, with @priority. * The function is called repeatedly until it returns %FALSE, at which @@ -31974,7 +31973,7 @@ /** * g_try_realloc: - * @mem: (allow-none): previously-allocated memory, or %NULL. + * @mem: (nullable): previously-allocated memory, or %NULL. * @n_bytes: number of bytes to allocate. * * Attempts to realloc @mem to a new size, @n_bytes, and returns %NULL @@ -31989,7 +31988,7 @@ /** * g_try_realloc_n: - * @mem: (allow-none): previously-allocated memory, or %NULL. + * @mem: (nullable): previously-allocated memory, or %NULL. * @n_blocks: the number of blocks to allocate * @n_block_bytes: the size of each block in bytes * @@ -32226,7 +32225,7 @@ * g_unichar_fully_decompose: * @ch: a Unicode character. * @compat: whether perform canonical or compatibility decomposition - * @result: (allow-none): location to store decomposed result, or %NULL + * @result: (nullable): location to store decomposed result, or %NULL * @result_len: length of @result * * Computes the canonical or compatibility decomposition of a @@ -32884,7 +32883,7 @@ /** * g_uri_escape_string: * @unescaped: the unescaped input string. - * @reserved_chars_allowed: (allow-none): a string of reserved characters that + * @reserved_chars_allowed: (nullable): a string of reserved characters that * are allowed to be used, or %NULL. * @allow_utf8: %TRUE if the result can include UTF-8 characters. * @@ -32936,9 +32935,9 @@ /** * g_uri_unescape_segment: - * @escaped_string: (allow-none): A string, may be %NULL - * @escaped_string_end: (allow-none): Pointer to end of @escaped_string, may be %NULL - * @illegal_characters: (allow-none): An optional string of illegal characters not to be allowed, may be %NULL + * @escaped_string: (nullable): A string, may be %NULL + * @escaped_string_end: (nullable): Pointer to end of @escaped_string, may be %NULL + * @illegal_characters: (nullable): An optional string of illegal characters not to be allowed, may be %NULL * * Unescapes a segment of an escaped string. * @@ -32959,7 +32958,7 @@ /** * g_uri_unescape_string: * @escaped_string: an escaped string to be unescaped. - * @illegal_characters: (allow-none): a string of illegal characters not to be + * @illegal_characters: (nullable): a string of illegal characters not to be * allowed, or %NULL. * * Unescapes a whole escaped string. @@ -33520,7 +33519,7 @@ * g_utf8_validate: * @str: (array length=max_len) (element-type guint8): a pointer to character data * @max_len: max bytes to validate, or -1 to go until NUL - * @end: (allow-none) (out) (transfer none): return location for end of valid data + * @end: (out) (optional) (transfer none): return location for end of valid data * * Validates UTF-8 encoded text. @str is the text to validate; * if @str is nul-terminated, then @max_len can be -1, otherwise @@ -33971,7 +33970,7 @@ /** * g_variant_dict_init: (skip) * @dict: a #GVariantDict - * @from_asv: (allow-none): the initial value for @dict + * @from_asv: (nullable): the initial value for @dict * * Initialises a #GVariantDict structure. * @@ -34051,7 +34050,7 @@ * g_variant_dict_lookup_value: * @dict: a #GVariantDict * @key: the key to lookup in the dictionary - * @expected_type: (allow-none): a #GVariantType, or %NULL + * @expected_type: (nullable): a #GVariantType, or %NULL * * Looks up a value in a #GVariantDict. * @@ -34072,7 +34071,7 @@ /** * g_variant_dict_new: - * @from_asv: (allow-none): the #GVariant with which to initialise the + * @from_asv: (nullable): the #GVariant with which to initialise the * dictionary * * Allocates and initialises a new #GVariantDict. @@ -34136,7 +34135,7 @@ /** * g_variant_dup_bytestring: * @value: an array-of-bytes #GVariant instance - * @length: (out) (allow-none) (default NULL): a pointer to a #gsize, to store + * @length: (out) (optional) (default NULL): a pointer to a #gsize, to store * the length (not including the nul terminator) * * Similar to g_variant_get_bytestring() except that instead of @@ -34153,7 +34152,7 @@ /** * g_variant_dup_bytestring_array: * @value: an array of array of bytes #GVariant ('aay') - * @length: (out) (allow-none): the length of the result, or %NULL + * @length: (out) (optional): the length of the result, or %NULL * * Gets the contents of an array of array of bytes #GVariant. This call * makes a deep copy; the return result should be released with @@ -34174,7 +34173,7 @@ /** * g_variant_dup_objv: * @value: an array of object paths #GVariant - * @length: (out) (allow-none): the length of the result, or %NULL + * @length: (out) (optional): the length of the result, or %NULL * * Gets the contents of an array of object paths #GVariant. This call * makes a deep copy; the return result should be released with @@ -34212,7 +34211,7 @@ /** * g_variant_dup_strv: * @value: an array of strings #GVariant - * @length: (out) (allow-none): the length of the result, or %NULL + * @length: (out) (optional): the length of the result, or %NULL * * Gets the contents of an array of strings #GVariant. This call * makes a deep copy; the return result should be released with @@ -34332,7 +34331,7 @@ /** * g_variant_get_bytestring_array: * @value: an array of array of bytes #GVariant ('aay') - * @length: (out) (allow-none): the length of the result, or %NULL + * @length: (out) (optional): the length of the result, or %NULL * * Gets the contents of an array of array of bytes #GVariant. This call * makes a shallow copy; the return result should be released with @@ -34563,7 +34562,7 @@ * Given a maybe-typed #GVariant instance, extract its value. If the * value is Nothing, then this function returns %NULL. * - * Returns: (allow-none) (transfer full): the contents of @value, or %NULL + * Returns: (nullable) (transfer full): the contents of @value, or %NULL * Since: 2.24 */ @@ -34597,7 +34596,7 @@ /** * g_variant_get_objv: * @value: an array of object paths #GVariant - * @length: (out) (allow-none): the length of the result, or %NULL + * @length: (out) (optional): the length of the result, or %NULL * * Gets the contents of an array of object paths #GVariant. This call * makes a shallow copy; the return result should be released with @@ -34639,7 +34638,7 @@ /** * g_variant_get_string: * @value: a string #GVariant instance - * @length: (allow-none) (default 0) (out): a pointer to a #gsize, + * @length: (optional) (default 0) (out): a pointer to a #gsize, * to store the length * * Returns the string value of a #GVariant instance with a string @@ -34665,7 +34664,7 @@ /** * g_variant_get_strv: * @value: an array of strings #GVariant - * @length: (out) (allow-none): the length of the result, or %NULL + * @length: (out) (optional): the length of the result, or %NULL * * Gets the contents of an array of strings #GVariant. This call * makes a shallow copy; the return result should be released with @@ -34756,7 +34755,7 @@ * g_variant_get_va: (skip) * @value: a #GVariant * @format_string: a string that is prefixed with a format string - * @endptr: (allow-none) (default NULL): location to store the end pointer, + * @endptr: (nullable) (default NULL): location to store the end pointer, * or %NULL * @app: a pointer to a #va_list * @@ -35158,7 +35157,7 @@ * } * ]| * - * Returns: (allow-none) (transfer full): a #GVariant, or %NULL + * Returns: (nullable) (transfer full): a #GVariant, or %NULL * Since: 2.24 */ @@ -35194,7 +35193,7 @@ * g_variant_lookup_value: * @dictionary: a dictionary #GVariant * @key: the key to lookup in the dictionary - * @expected_type: (allow-none): a #GVariantType, or %NULL + * @expected_type: (nullable): a #GVariantType, or %NULL * * Looks up a value in a dictionary #GVariant. * @@ -35285,8 +35284,8 @@ /** * g_variant_new_array: - * @child_type: (allow-none): the element type of the new array - * @children: (allow-none) (array length=n_children): an array of + * @child_type: (nullable): the element type of the new array + * @children: (nullable) (array length=n_children): an array of * #GVariant pointers, the children * @n_children: the length of @children * @@ -35525,8 +35524,8 @@ /** * g_variant_new_maybe: - * @child_type: (allow-none): the #GVariantType of the child, or %NULL - * @child: (allow-none): the child value, or %NULL + * @child_type: (nullable): the #GVariantType of the child, or %NULL + * @child: (nullable): the child value, or %NULL * * Depending on if @child is %NULL, either wraps @child inside of a * maybe container or creates a Nothing instance for the given @type. @@ -35785,7 +35784,7 @@ /** * g_variant_new_va: (skip) * @format_string: a string that is prefixed with a format string - * @endptr: (allow-none) (default NULL): location to store the end pointer, + * @endptr: (nullable) (default NULL): location to store the end pointer, * or %NULL * @app: a pointer to a #va_list * @@ -35848,11 +35847,11 @@ /** * g_variant_parse: - * @type: (allow-none): a #GVariantType, or %NULL + * @type: (nullable): a #GVariantType, or %NULL * @text: a string containing a GVariant in text form - * @limit: (allow-none): a pointer to the end of @text, or %NULL - * @endptr: (allow-none): a location to store the end pointer, or %NULL - * @error: (allow-none): a pointer to a %NULL #GError pointer, or %NULL + * @limit: (nullable): a pointer to the end of @text, or %NULL + * @endptr: (nullable): a location to store the end pointer, or %NULL + * @error: (nullable): a pointer to a %NULL #GError pointer, or %NULL * * Parses a #GVariant from a text representation. * @@ -35960,7 +35959,7 @@ /** * g_variant_print_string: (skip) * @value: a #GVariant - * @string: (allow-none) (default NULL): a #GString, or %NULL + * @string: (nullable) (default NULL): a #GString, or %NULL * @type_annotate: %TRUE if type information should be included in * the output * @@ -36170,7 +36169,7 @@ /** * g_variant_type_free: - * @type: (allow-none): a #GVariantType, or %NULL + * @type: (nullable): a #GVariantType, or %NULL * * Frees a #GVariantType that was allocated with * g_variant_type_copy(), g_variant_type_new() or one of the container @@ -36541,8 +36540,8 @@ /** * g_variant_type_string_scan: * @string: a pointer to any string - * @limit: (allow-none): the end of @string, or %NULL - * @endptr: (out) (allow-none): location to store the end pointer, or %NULL + * @limit: (nullable): the end of @string, or %NULL + * @endptr: (out) (optional): location to store the end pointer, or %NULL * * Scan for a single complete and valid GVariant type string in @string. * The memory pointed to by @limit (or bytes beyond it) is never @@ -36868,8 +36867,8 @@ /** * g_win32_get_package_installation_directory: - * @package: (allow-none): You should pass %NULL for this. - * @dll_name: (allow-none): The name of a DLL that a package provides in UTF-8, or %NULL. + * @package: (nullable): You should pass %NULL for this. + * @dll_name: (nullable): The name of a DLL that a package provides in UTF-8, or %NULL. * * Try to determine the installation directory for a software package. * @@ -36924,7 +36923,7 @@ /** * g_win32_get_package_installation_directory_of_module: - * @hmodule: (allow-none): The Win32 handle for a DLL loaded into the current process, or %NULL + * @hmodule: (nullable): The Win32 handle for a DLL loaded into the current process, or %NULL * * This function tries to determine the installation directory of a * software package based on the location of a DLL of the software @@ -36961,8 +36960,8 @@ /** * g_win32_get_package_installation_subdirectory: - * @package: (allow-none): You should pass %NULL for this. - * @dll_name: (allow-none): The name of a DLL that a package provides, in UTF-8, or %NULL. + * @package: (nullable): You should pass %NULL for this. + * @dll_name: (nullable): The name of a DLL that a package provides, in UTF-8, or %NULL. * @subdir: A subdirectory of the package installation directory, also in UTF-8 * * This function is deprecated. Use diff --git a/gir/gmodule-2.0.c b/gir/gmodule-2.0.c index c1a66a55..145d4772 100644 --- a/gir/gmodule-2.0.c +++ b/gir/gmodule-2.0.c @@ -159,7 +159,7 @@ /** * g_module_build_path: - * @directory: (allow-none): the directory where the module is. This can be + * @directory: (nullable): the directory where the module is. This can be * %NULL or the empty string to indicate that the standard platform-specific * directories will be used, though that is not recommended * @module_name: the name of the module @@ -225,7 +225,7 @@ /** * g_module_open: - * @file_name: (allow-none): the name of the file containing the module, or %NULL + * @file_name: (nullable): the name of the file containing the module, or %NULL * to obtain a #GModule representing the main program itself * @flags: the flags used for opening the module. This can be the * logical OR of any of the #GModuleFlags diff --git a/gir/gobject-2.0.c b/gir/gobject-2.0.c index dfca0326..d16d28f4 100644 --- a/gir/gobject-2.0.c +++ b/gir/gobject-2.0.c @@ -884,12 +884,12 @@ /** * g_cclosure_marshal_BOOLEAN__BOXED_BOXEDv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -924,12 +924,12 @@ /** * g_cclosure_marshal_BOOLEAN__FLAGSv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1016,12 +1016,12 @@ /** * g_cclosure_marshal_STRING__OBJECT_POINTERv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1054,12 +1054,12 @@ /** * g_cclosure_marshal_VOID__BOOLEANv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1092,12 +1092,12 @@ /** * g_cclosure_marshal_VOID__BOXEDv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1130,12 +1130,12 @@ /** * g_cclosure_marshal_VOID__CHARv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1168,12 +1168,12 @@ /** * g_cclosure_marshal_VOID__DOUBLEv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1206,12 +1206,12 @@ /** * g_cclosure_marshal_VOID__ENUMv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1244,12 +1244,12 @@ /** * g_cclosure_marshal_VOID__FLAGSv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1282,12 +1282,12 @@ /** * g_cclosure_marshal_VOID__FLOATv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1320,12 +1320,12 @@ /** * g_cclosure_marshal_VOID__INTv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1358,12 +1358,12 @@ /** * g_cclosure_marshal_VOID__LONGv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1396,12 +1396,12 @@ /** * g_cclosure_marshal_VOID__OBJECTv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1434,12 +1434,12 @@ /** * g_cclosure_marshal_VOID__PARAMv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1476,12 +1476,12 @@ /** * g_cclosure_marshal_VOID__POINTERv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1514,12 +1514,12 @@ /** * g_cclosure_marshal_VOID__STRINGv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1552,12 +1552,12 @@ /** * g_cclosure_marshal_VOID__UCHARv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1609,12 +1609,12 @@ /** * g_cclosure_marshal_VOID__UINT_POINTERv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1628,12 +1628,12 @@ /** * g_cclosure_marshal_VOID__UINTv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1666,12 +1666,12 @@ /** * g_cclosure_marshal_VOID__ULONGv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1704,12 +1704,12 @@ /** * g_cclosure_marshal_VOID__VARIANTv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1741,12 +1741,12 @@ /** * g_cclosure_marshal_VOID__VOIDv: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is invoked. * @args: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1784,13 +1784,13 @@ /** * g_cclosure_marshal_generic_va: * @closure: the #GClosure to which the marshaller belongs - * @return_value: (allow-none): a #GValue to store the return + * @return_value: (nullable): a #GValue to store the return * value. May be %NULL if the callback of @closure doesn't return a * value. * @instance: (type GObject.TypeInstance): the instance on which the closure is * invoked. * @args_list: va_list of arguments to be passed to the closure. - * @marshal_data: (allow-none): additional data specified when + * @marshal_data: (nullable): additional data specified when * registering the marshaller, see g_closure_set_marshal() and * g_closure_set_meta_marshal() * @n_params: the length of the @param_types array @@ -1954,7 +1954,7 @@ * @param_values: (array length=n_param_values): an array of * #GValues holding the arguments on which to * invoke the callback of @closure - * @invocation_hint: (allow-none): a context-dependent invocation hint + * @invocation_hint: (nullable): a context-dependent invocation hint * * Invokes the closure, i.e. executes the callback represented by the @closure. */ @@ -2354,7 +2354,7 @@ /** * g_object_add_weak_pointer: (skip) * @object: The object that should be weak referenced. - * @weak_pointer_location: (inout) (not optional) (nullable): The memory address + * @weak_pointer_location: (inout) (not optional): The memory address * of a pointer. * * Adds a weak reference from weak_pointer to @object to indicate that @@ -2414,9 +2414,9 @@ * @target: (type GObject.Object): the target #GObject * @target_property: the property on @target to bind * @flags: flags to pass to #GBinding - * @transform_to: (scope notified) (allow-none): the transformation function + * @transform_to: (scope notified) (nullable): the transformation function * from the @source to the @target, or %NULL to use the default - * @transform_from: (scope notified) (allow-none): the transformation function + * @transform_from: (scope notified) (nullable): the transformation function * from the @target to the @source, or %NULL to use the default * @user_data: custom data to be passed to the transformation functions, * or %NULL @@ -2682,8 +2682,8 @@ * g_object_dup_data: * @object: the #GObject to store user data on * @key: a string, naming the user data pointer - * @dup_func: (allow-none): function to dup the value - * @user_data: (allow-none): passed as user_data to @dup_func + * @dup_func: (nullable): function to dup the value + * @user_data: (nullable): passed as user_data to @dup_func * * This is a variant of g_object_get_data() which returns * a 'duplicate' of the value. @dup_func defines the @@ -2712,8 +2712,8 @@ * g_object_dup_qdata: * @object: the #GObject to store user data on * @quark: a #GQuark, naming the user data pointer - * @dup_func: (allow-none): function to dup the value - * @user_data: (allow-none): passed as user_data to @dup_func + * @dup_func: (nullable): function to dup the value + * @user_data: (nullable): passed as user_data to @dup_func * * This is a variant of g_object_get_qdata() which returns * a 'duplicate' of the value. @dup_func defines the @@ -3096,7 +3096,7 @@ /** * g_object_remove_weak_pointer: (skip) * @object: The object that is weak referenced. - * @weak_pointer_location: (inout) (not optional) (nullable): The memory address + * @weak_pointer_location: (inout) (not optional): The memory address * of a pointer. * * Removes a weak reference from @object that was previously added @@ -3109,10 +3109,10 @@ * g_object_replace_data: * @object: the #GObject to store user data on * @key: a string, naming the user data pointer - * @oldval: (allow-none): the old value to compare against - * @newval: (allow-none): the new value - * @destroy: (allow-none): a destroy notify for the new value - * @old_destroy: (allow-none): destroy notify for the existing value + * @oldval: (nullable): the old value to compare against + * @newval: (nullable): the new value + * @destroy: (nullable): a destroy notify for the new value + * @old_destroy: (nullable): destroy notify for the existing value * * Compares the user data for the key @key on @object with * @oldval, and if they are the same, replaces @oldval with @@ -3138,10 +3138,10 @@ * g_object_replace_qdata: * @object: the #GObject to store user data on * @quark: a #GQuark, naming the user data pointer - * @oldval: (allow-none): the old value to compare against - * @newval: (allow-none): the new value - * @destroy: (allow-none): a destroy notify for the new value - * @old_destroy: (allow-none): destroy notify for the existing value + * @oldval: (nullable): the old value to compare against + * @newval: (nullable): the new value + * @destroy: (nullable): a destroy notify for the new value + * @old_destroy: (nullable): destroy notify for the existing value * * Compares the user data for the key @quark on @object with * @oldval, and if they are the same, replaces @oldval with @@ -4083,7 +4083,7 @@ * @nick: nick name for the property specified * @blurb: description of the property specified * @type: a #GVariantType - * @default_value: (allow-none) (transfer full): a #GVariant of type @type to + * @default_value: (nullable) (transfer full): a #GVariant of type @type to * use as the default value, or %NULL * @flags: flags for the property specified * @@ -4468,7 +4468,7 @@ * and/or @data the handler has to match. * @signal_id: Signal the handler has to be connected to. * @detail: Signal detail the handler has to be connected to. - * @closure: (allow-none): The closure the handler will invoke. + * @closure: (nullable): The closure the handler will invoke. * @func: The C closure callback of the handler (useless for non-C closures). * @data: The closure data of the handler's closure. * @@ -4521,7 +4521,7 @@ * and/or @data the handlers have to match. * @signal_id: Signal the handlers have to be connected to. * @detail: Signal detail the handlers have to be connected to. - * @closure: (allow-none): The closure the handlers will invoke. + * @closure: (nullable): The closure the handlers will invoke. * @func: The C closure callback of the handlers (useless for non-C closures). * @data: The closure data of the handlers' closures. * @@ -4554,7 +4554,7 @@ * and/or @data the handlers have to match. * @signal_id: Signal the handlers have to be connected to. * @detail: Signal detail the handlers have to be connected to. - * @closure: (allow-none): The closure the handlers will invoke. + * @closure: (nullable): The closure the handlers will invoke. * @func: The C closure callback of the handlers (useless for non-C closures). * @data: The closure data of the handlers' closures. * @@ -4578,7 +4578,7 @@ * and/or @data the handlers have to match. * @signal_id: Signal the handlers have to be connected to. * @detail: Signal detail the handlers have to be connected to. - * @closure: (allow-none): The closure the handlers will invoke. + * @closure: (nullable): The closure the handlers will invoke. * @func: The C closure callback of the handlers (useless for non-C closures). * @data: The closure data of the handlers' closures. * @@ -4679,7 +4679,7 @@ * not associate a class method slot with this signal. * @accumulator: the accumulator for this signal; may be %NULL. * @accu_data: user data for the @accumulator. - * @c_marshaller: (allow-none): the function to translate arrays of parameter + * @c_marshaller: (nullable): the function to translate arrays of parameter * values to signal emissions into C language callback invocations or %NULL. * @return_type: the type of return value, or #G_TYPE_NONE for a signal * without a return value. @@ -4720,7 +4720,7 @@ * not associate a class method with this signal. * @accumulator: the accumulator for this signal; may be %NULL. * @accu_data: user data for the @accumulator. - * @c_marshaller: (allow-none): the function to translate arrays of parameter + * @c_marshaller: (nullable): the function to translate arrays of parameter * values to signal emissions into C language callback invocations or %NULL. * @return_type: the type of return value, or #G_TYPE_NONE for a signal * without a return value. @@ -4760,7 +4760,7 @@ * @class_closure: The closure to invoke on signal emission; may be %NULL. * @accumulator: the accumulator for this signal; may be %NULL. * @accu_data: user data for the @accumulator. - * @c_marshaller: (allow-none): the function to translate arrays of parameter + * @c_marshaller: (nullable): the function to translate arrays of parameter * values to signal emissions into C language callback invocations or %NULL. * @return_type: the type of return value, or #G_TYPE_NONE for a signal * without a return value. @@ -4786,11 +4786,11 @@ * @signal_flags: a combination of #GSignalFlags specifying detail of when * the default handler is to be invoked. You should at least specify * %G_SIGNAL_RUN_FIRST or %G_SIGNAL_RUN_LAST - * @class_closure: (allow-none): The closure to invoke on signal emission; + * @class_closure: (nullable): The closure to invoke on signal emission; * may be %NULL - * @accumulator: (allow-none): the accumulator for this signal; may be %NULL + * @accumulator: (nullable): the accumulator for this signal; may be %NULL * @accu_data: user data for the @accumulator - * @c_marshaller: (allow-none): the function to translate arrays of + * @c_marshaller: (nullable): the function to translate arrays of * parameter values to signal emissions into C language callback * invocations or %NULL * @return_type: the type of return value, or #G_TYPE_NONE for a signal @@ -5081,7 +5081,7 @@ /** * g_type_children: * @type: the parent type - * @n_children: (out) (allow-none): location to store the length of + * @n_children: (out) (optional): location to store the length of * the returned array, or %NULL * * Return a newly allocated and 0-terminated array of type IDs, listing @@ -5569,7 +5569,7 @@ /** * g_type_interface_prerequisites: * @interface_type: an interface type - * @n_prerequisites: (out) (allow-none): location to return the number + * @n_prerequisites: (out) (optional): location to return the number * of prerequisites, or %NULL * * Returns the prerequisites of an interfaces type. @@ -5584,7 +5584,7 @@ /** * g_type_interfaces: * @type: the type to list interface types for - * @n_interfaces: (out) (allow-none): location to store the length of + * @n_interfaces: (out) (optional): location to store the length of * the returned array, or %NULL * * Return a newly allocated and 0-terminated array of type IDs, listing @@ -5967,7 +5967,7 @@ /** * g_value_array_append: * @value_array: #GValueArray to add an element to - * @value: (allow-none): #GValue to copy into #GValueArray, or %NULL + * @value: (nullable): #GValue to copy into #GValueArray, or %NULL * * Insert a copy of @value as last element of @value_array. If @value is * %NULL, an uninitialized value is appended. @@ -6015,7 +6015,7 @@ * g_value_array_insert: * @value_array: #GValueArray to add an element to * @index_: insertion position, must be <= value_array->;n_values - * @value: (allow-none): #GValue to copy into #GValueArray, or %NULL + * @value: (nullable): #GValue to copy into #GValueArray, or %NULL * * Insert a copy of @value at specified position into @value_array. If @value * is %NULL, an uninitialized value is inserted. @@ -6041,7 +6041,7 @@ /** * g_value_array_prepend: * @value_array: #GValueArray to add an element to - * @value: (allow-none): #GValue to copy into #GValueArray, or %NULL + * @value: (nullable): #GValue to copy into #GValueArray, or %NULL * * Insert a copy of @value as first element of @value_array. If @value is * %NULL, an uninitialized value is prepended. @@ -6470,7 +6470,7 @@ /** * g_value_set_boxed: * @value: a valid #GValue of %G_TYPE_BOXED derived type - * @v_boxed: (allow-none): boxed value to be set + * @v_boxed: (nullable): boxed value to be set * * Set the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed. */ @@ -6479,7 +6479,7 @@ /** * g_value_set_boxed_take_ownership: * @value: a valid #GValue of %G_TYPE_BOXED derived type - * @v_boxed: (allow-none): duplicated unowned boxed value to be set + * @v_boxed: (nullable): duplicated unowned boxed value to be set * * This is an internal function introduced mainly for C marshallers. * @@ -6548,7 +6548,7 @@ /** * g_value_set_instance: * @value: An initialized #GValue structure. - * @instance: (allow-none): the instance + * @instance: (nullable): the instance * * Sets @value from an instantiatable type via the * value_table's collect_value() function. @@ -6585,7 +6585,7 @@ /** * g_value_set_object: * @value: a valid #GValue of %G_TYPE_OBJECT derived type - * @v_object: (type GObject.Object) (allow-none): object value to be set + * @v_object: (type GObject.Object) (nullable): object value to be set * * Set the contents of a %G_TYPE_OBJECT derived #GValue to @v_object. * @@ -6604,7 +6604,7 @@ /** * g_value_set_object_take_ownership: (skip) * @value: a valid #GValue of %G_TYPE_OBJECT derived type - * @v_object: (allow-none): object value to be set + * @v_object: (nullable): object value to be set * * This is an internal function introduced mainly for C marshallers. * @@ -6615,7 +6615,7 @@ /** * g_value_set_param: * @value: a valid #GValue of type %G_TYPE_PARAM - * @param: (allow-none): the #GParamSpec to be set + * @param: (nullable): the #GParamSpec to be set * * Set the contents of a %G_TYPE_PARAM #GValue to @param. */ @@ -6624,7 +6624,7 @@ /** * g_value_set_param_take_ownership: (skip) * @value: a valid #GValue of type %G_TYPE_PARAM - * @param: (allow-none): the #GParamSpec to be set + * @param: (nullable): the #GParamSpec to be set * * This is an internal function introduced mainly for C marshallers. * @@ -6655,7 +6655,7 @@ /** * g_value_set_static_boxed: * @value: a valid #GValue of %G_TYPE_BOXED derived type - * @v_boxed: (allow-none): static boxed value to be set + * @v_boxed: (nullable): static boxed value to be set * * Set the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed. * The boxed value is assumed to be static, and is thus not duplicated @@ -6666,7 +6666,7 @@ /** * g_value_set_static_string: * @value: a valid #GValue of type %G_TYPE_STRING - * @v_string: (allow-none): static string to be set + * @v_string: (nullable): static string to be set * * Set the contents of a %G_TYPE_STRING #GValue to @v_string. * The string is assumed to be static, and is thus not duplicated @@ -6677,7 +6677,7 @@ /** * g_value_set_string: * @value: a valid #GValue of type %G_TYPE_STRING - * @v_string: (allow-none): caller-owned string to be duplicated for the #GValue + * @v_string: (nullable): caller-owned string to be duplicated for the #GValue * * Set the contents of a %G_TYPE_STRING #GValue to @v_string. */ @@ -6686,7 +6686,7 @@ /** * g_value_set_string_take_ownership: * @value: a valid #GValue of type %G_TYPE_STRING - * @v_string: (allow-none): duplicated unowned string to be set + * @v_string: (nullable): duplicated unowned string to be set * * This is an internal function introduced mainly for C marshallers. * @@ -6733,7 +6733,7 @@ /** * g_value_set_variant: * @value: a valid #GValue of type %G_TYPE_VARIANT - * @variant: (allow-none): a #GVariant, or %NULL + * @variant: (nullable): a #GVariant, or %NULL * * Set the contents of a variant #GValue to @variant. * If the variant is floating, it is consumed. @@ -6745,7 +6745,7 @@ /** * g_value_take_boxed: * @value: a valid #GValue of %G_TYPE_BOXED derived type - * @v_boxed: (allow-none): duplicated unowned boxed value to be set + * @v_boxed: (nullable): duplicated unowned boxed value to be set * * Sets the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed * and takes over the ownership of the callers reference to @v_boxed; @@ -6758,7 +6758,7 @@ /** * g_value_take_object: (skip) * @value: a valid #GValue of %G_TYPE_OBJECT derived type - * @v_object: (allow-none): object value to be set + * @v_object: (nullable): object value to be set * * Sets the contents of a %G_TYPE_OBJECT derived #GValue to @v_object * and takes over the ownership of the callers reference to @v_object; @@ -6775,7 +6775,7 @@ /** * g_value_take_param: (skip) * @value: a valid #GValue of type %G_TYPE_PARAM - * @param: (allow-none): the #GParamSpec to be set + * @param: (nullable): the #GParamSpec to be set * * Sets the contents of a %G_TYPE_PARAM #GValue to @param and takes * over the ownership of the callers reference to @param; the caller @@ -6788,7 +6788,7 @@ /** * g_value_take_string: * @value: a valid #GValue of type %G_TYPE_STRING - * @v_string: (allow-none): string to take ownership of + * @v_string: (nullable): string to take ownership of * * Sets the contents of a %G_TYPE_STRING #GValue to @v_string. * |