summaryrefslogtreecommitdiff
path: root/gir/gio-2.0.c
diff options
context:
space:
mode:
Diffstat (limited to 'gir/gio-2.0.c')
-rw-r--r--gir/gio-2.0.c266
1 files changed, 154 insertions, 112 deletions
diff --git a/gir/gio-2.0.c b/gir/gio-2.0.c
index 693c4295..b925400a 100644
--- a/gir/gio-2.0.c
+++ b/gir/gio-2.0.c
@@ -6037,7 +6037,7 @@
* To just export an object on a well-known name on a message bus, such as the
* session or system bus, you should instead use g_bus_own_name().
*
- * An example of peer-to-peer communication with G-DBus can be found
+ * An example of peer-to-peer communication with GDBus can be found
* in [gdbus-example-peer.c](https://git.gnome.org/browse/glib/tree/gio/tests/gdbus-example-peer.c).
*
* Note that a minimal #GDBusServer will accept connections from any
@@ -10375,7 +10375,7 @@
* The return value (if non-%NULL) should be freed with
* g_variant_unref() when it is no longer required.
*
- * Returns: (transfer full): the current state of the action
+ * Returns: (nullable) (transfer full): the current state of the action
* Since: 2.28
*/
@@ -10782,7 +10782,7 @@
*
* If no such action exists, returns %NULL.
*
- * Returns: (transfer none): a #GAction, or %NULL
+ * Returns: (nullable) (transfer none): a #GAction, or %NULL
* Since: 2.32
*/
@@ -10962,7 +10962,7 @@
*
* Checks if two #GAppInfos are equal.
*
- * Note that the check <emphasis>may not</emphasis> compare each individual
+ * Note that the check *may not* compare each individual
* field, and only does an identity check. In case detecting changes in the
* contents is needed, program code must additionally compare relevant fields.
*
@@ -11007,7 +11007,7 @@
* Gets the commandline with which the application will be
* started.
*
- * Returns: (type filename): a string containing the @appinfo's commandline,
+ * Returns: (nullable) (type filename): a string containing the @appinfo's commandline,
* or %NULL if this information is not available
* Since: 2.20
*/
@@ -11046,7 +11046,7 @@
*
* Gets a human-readable description of an installed application.
*
- * Returns: a string containing a description of the
+ * Returns: (nullable): a string containing a description of the
* application @appinfo, or %NULL if none.
*/
@@ -11095,7 +11095,7 @@
*
* Gets the icon for the application.
*
- * Returns: (transfer none): the default #GIcon for @appinfo or %NULL
+ * Returns: (nullable) (transfer none): the default #GIcon for @appinfo or %NULL
* if there is no default icon.
*/
@@ -11112,7 +11112,7 @@
* Note that the returned ID may be %NULL, depending on how
* the @appinfo has been constructed.
*
- * Returns: a string containing the application's ID.
+ * Returns: (nullable): a string containing the application's ID.
*/
@@ -11433,7 +11433,7 @@
* applications are started on the same display as the launching
* application, by setting the `DISPLAY` environment variable.
*
- * Returns: a display string for the display.
+ * Returns: (nullable): a display string for the display.
*/
@@ -11464,7 +11464,7 @@
* Startup notification IDs are defined in the
* [FreeDesktop.Org Startup Notifications standard](http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt).
*
- * Returns: a startup notification ID for the application, or %NULL if
+ * Returns: (nullable): a startup notification ID for the application, or %NULL if
* not supported.
*/
@@ -11828,13 +11828,13 @@
* The #GInputStream can be used to read data passed to the standard
* input of the invoking process.
* This doesn't work on all platforms. Presently, it is only available
- * on UNIX when using a DBus daemon capable of passing file descriptors.
+ * on UNIX when using a D-Bus daemon capable of passing file descriptors.
* If stdin is not available then %NULL will be returned. In the
* future, support may be expanded to other platforms.
*
* You must only call this function once per commandline invocation.
*
- * Returns: (transfer full): a #GInputStream for stdin
+ * Returns: (nullable) (transfer full): a #GInputStream for stdin
* Since: 2.34
*/
@@ -11856,7 +11856,7 @@
* The return value should not be modified or freed and is valid for as
* long as @cmdline exists.
*
- * Returns: the value of the variable, or %NULL if unset or unsent
+ * Returns: (nullable): the value of the variable, or %NULL if unset or unsent
* Since: 2.28
*/
@@ -11932,7 +11932,7 @@
*
* Gets the unique identifier for @application.
*
- * Returns: the identifier for @application, owned by @application
+ * Returns: (nullable): the identifier for @application, owned by @application
* Since: 2.28
*/
@@ -11955,7 +11955,7 @@
* This function must not be called before the application has been
* registered. See g_application_get_is_registered().
*
- * Returns: (transfer none): a #GDBusConnection, or %NULL
+ * Returns: (nullable) (transfer none): a #GDBusConnection, or %NULL
* Since: 2.34
*/
@@ -11979,7 +11979,7 @@
* This function must not be called before the application has been
* registered. See g_application_get_is_registered().
*
- * Returns: the object path, or %NULL
+ * Returns: (nullable): the object path, or %NULL
* Since: 2.34
*/
@@ -11995,7 +11995,7 @@
*
* If there is no default application then %NULL is returned.
*
- * Returns: (transfer none): the default application for this process, or %NULL
+ * Returns: (nullable) (transfer none): the default application for this process, or %NULL
* Since: 2.32
*/
@@ -13428,7 +13428,7 @@
*
* Gets the #GBytes associated with the given @icon.
*
- * Returns: (transfer none): a #GBytes, or %NULL.
+ * Returns: (transfer none): a #GBytes.
* Since: 2.38
*/
@@ -15217,7 +15217,7 @@
*
* The cost of this function is O(n) in number of annotations.
*
- * Returns: The value or %NULL if not found. Do not free, it is owned by @annotations.
+ * Returns: (nullable): The value or %NULL if not found. Do not free, it is owned by @annotations.
* Since: 2.26
*/
@@ -15515,6 +15515,18 @@
*
* Like g_dbus_connection_call() but also takes a #GUnixFDList object.
*
+ * The file descriptors normally correspond to %G_VARIANT_TYPE_HANDLE
+ * values in the body of the message. For example, if a message contains
+ * two file descriptors, @fd_list would have length 2, and
+ * `g_variant_new_handle (0)` and `g_variant_new_handle (1)` would appear
+ * somewhere in the body of the message (not necessarily in that order!)
+ * to represent the file descriptors at indexes 0 and 1 respectively.
+ *
+ * When designing D-Bus APIs that are intended to be interoperable,
+ * please note that non-GDBus implementations of D-Bus can usually only
+ * access file descriptors if they are referenced in this way by a
+ * value of type %G_VARIANT_TYPE_HANDLE in the body of the message.
+ *
* This method is only available on UNIX.
*
* Since: 2.30
@@ -15531,6 +15543,17 @@
*
* Finishes an operation started with g_dbus_connection_call_with_unix_fd_list().
*
+ * The file descriptors normally correspond to %G_VARIANT_TYPE_HANDLE
+ * values in the body of the message. For example,
+ * if g_variant_get_handle() returns 5, that is intended to be a reference
+ * to the file descriptor that can be accessed by
+ * `g_unix_fd_list_get (*out_fd_list, 5, ...)`.
+ *
+ * When designing D-Bus APIs that are intended to be interoperable,
+ * please note that non-GDBus implementations of D-Bus can usually only
+ * access file descriptors if they are referenced in this way by a
+ * value of type %G_VARIANT_TYPE_HANDLE in the body of the message.
+ *
* Returns: %NULL if @error is set. Otherwise a #GVariant tuple with
* return values. Free with g_variant_unref().
* Since: 2.30
@@ -15557,6 +15580,8 @@
* @error: return location for error or %NULL
*
* Like g_dbus_connection_call_sync() but also takes and returns #GUnixFDList objects.
+ * See g_dbus_connection_call_with_unix_fd_list() and
+ * g_dbus_connection_call_with_unix_fd_list_finish() for more details.
*
* This method is only available on UNIX.
*
@@ -16767,9 +16792,9 @@
* See the g_dbus_gvariant_to_gvalue() function for how to convert a
* #GVariant to a #GValue.
*
- * Returns: A #GVariant (never floating) of #GVariantType @type holding
- * the data from @gvalue or %NULL in case of failure. Free with
- * g_variant_unref().
+ * Returns: (transfer full): A #GVariant (never floating) of
+ * #GVariantType @type holding the data from @gvalue or an empty #GVariant
+ * in case of failure. Free with g_variant_unref().
* Since: 2.30
*/
@@ -16801,7 +16826,7 @@
*
* Gets the #GDBusObject that @interface_ belongs to, if any.
*
- * Returns: (transfer full): A #GDBusObject or %NULL. The returned
+ * Returns: (nullable) (transfer full): A #GDBusObject or %NULL. The returned
* reference should be freed with g_object_unref().
* Since: 2.32
*/
@@ -16829,7 +16854,7 @@
* the returned object is being used from other threads. See
* g_dbus_interface_dup_object() for a thread-safe alternative.
*
- * Returns: (transfer none): A #GDBusObject or %NULL. The returned
+ * Returns: (nullable) (transfer none): A #GDBusObject or %NULL. The returned
* reference belongs to @interface_ and should not be freed.
* Since: 2.30
*/
@@ -16893,7 +16918,7 @@
* The cost of this function is O(n) in number of methods unless
* g_dbus_interface_info_cache_build() has been used on @info.
*
- * Returns: (transfer none): A #GDBusMethodInfo or %NULL if not found. Do not free, it is owned by @info.
+ * Returns: (nullable) (transfer none): A #GDBusMethodInfo or %NULL if not found. Do not free, it is owned by @info.
* Since: 2.26
*/
@@ -16908,7 +16933,7 @@
* The cost of this function is O(n) in number of properties unless
* g_dbus_interface_info_cache_build() has been used on @info.
*
- * Returns: (transfer none): A #GDBusPropertyInfo or %NULL if not found. Do not free, it is owned by @info.
+ * Returns: (nullable) (transfer none): A #GDBusPropertyInfo or %NULL if not found. Do not free, it is owned by @info.
* Since: 2.26
*/
@@ -16923,7 +16948,7 @@
* The cost of this function is O(n) in number of signals unless
* g_dbus_interface_info_cache_build() has been used on @info.
*
- * Returns: (transfer none): A #GDBusSignalInfo or %NULL if not found. Do not free, it is owned by @info.
+ * Returns: (nullable) (transfer none): A #GDBusSignalInfo or %NULL if not found. Do not free, it is owned by @info.
* Since: 2.26
*/
@@ -17009,7 +17034,7 @@
*
* Gets the first connection that @interface_ is exported on, if any.
*
- * Returns: (transfer none): A #GDBusConnection or %NULL if @interface_ is
+ * Returns: (nullable) (transfer none): A #GDBusConnection or %NULL if @interface_ is
* not exported anywhere. Do not free, the object belongs to @interface_.
* Since: 2.30
*/
@@ -17059,7 +17084,7 @@
*
* Gets the object path that @interface_ is exported on, if any.
*
- * Returns: A string owned by @interface_ or %NULL if @interface_ is not exported
+ * Returns: (nullable): A string owned by @interface_ or %NULL if @interface_ is not exported
* anywhere. Do not free, the string belongs to @interface_.
* Since: 2.30
*/
@@ -17293,7 +17318,7 @@
*
* Convenience to get the first item in the body of @message.
*
- * Returns: The string item or %NULL if the first item in the body of
+ * Returns: (nullable): The string item or %NULL if the first item in the body of
* @message is not a string.
* Since: 2.26
*/
@@ -17305,7 +17330,7 @@
*
* Gets the body of a message.
*
- * Returns: (transfer none): A #GVariant or %NULL if the body is
+ * Returns: (nullable) (transfer none): A #GVariant or %NULL if the body is
* empty. Do not free, it is owned by @message.
* Since: 2.26
*/
@@ -17327,7 +17352,7 @@
*
* Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field.
*
- * Returns: The value.
+ * Returns: (nullable): The value.
* Since: 2.26
*/
@@ -17338,7 +17363,7 @@
*
* Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field.
*
- * Returns: The value.
+ * Returns: (nullable): The value.
* Since: 2.26
*/
@@ -17389,7 +17414,7 @@
*
* Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field.
*
- * Returns: The value.
+ * Returns: (nullable): The value.
* Since: 2.26
*/
@@ -17413,7 +17438,7 @@
*
* Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field.
*
- * Returns: The value.
+ * Returns: (nullable): The value.
* Since: 2.26
*/
@@ -17446,7 +17471,7 @@
*
* Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field.
*
- * Returns: The value.
+ * Returns: (nullable): The value.
* Since: 2.26
*/
@@ -17468,7 +17493,7 @@
*
* Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field.
*
- * Returns: The value.
+ * Returns: (nullable): The value.
* Since: 2.26
*/
@@ -17503,7 +17528,13 @@
*
* This method is only available on UNIX.
*
- * Returns: (transfer none): A #GUnixFDList or %NULL if no file descriptors are
+ * The file descriptors normally correspond to %G_VARIANT_TYPE_HANDLE
+ * values in the body of the message. For example,
+ * if g_variant_get_handle() returns 5, that is intended to be a reference
+ * to the file descriptor that can be accessed by
+ * `g_unix_fd_list_get (list, 5, ...)`.
+ *
+ * Returns: (nullable) (transfer none): A #GUnixFDList or %NULL if no file descriptors are
* associated. Do not free, this object is owned by @message.
* Since: 2.26
*/
@@ -17702,7 +17733,7 @@
/**
* g_dbus_message_set_destination:
* @message: A #GDBusMessage.
- * @value: The value to set.
+ * @value: (nullable): The value to set.
*
* Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field.
*
@@ -17712,7 +17743,7 @@
/**
* g_dbus_message_set_error_name:
- * @message: A #GDBusMessage.
+ * @message: (nullable): A #GDBusMessage.
* @value: The value to set.
*
* Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field.
@@ -17750,7 +17781,7 @@
/**
* g_dbus_message_set_interface:
* @message: A #GDBusMessage.
- * @value: The value to set.
+ * @value: (nullable): The value to set.
*
* Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field.
*
@@ -17761,7 +17792,7 @@
/**
* g_dbus_message_set_member:
* @message: A #GDBusMessage.
- * @value: The value to set.
+ * @value: (nullable): The value to set.
*
* Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field.
*
@@ -17794,7 +17825,7 @@
/**
* g_dbus_message_set_path:
* @message: A #GDBusMessage.
- * @value: The value to set.
+ * @value: (nullable): The value to set.
*
* Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field.
*
@@ -17816,7 +17847,7 @@
/**
* g_dbus_message_set_sender:
* @message: A #GDBusMessage.
- * @value: The value to set.
+ * @value: (nullable): The value to set.
*
* Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field.
*
@@ -17838,7 +17869,7 @@
/**
* g_dbus_message_set_signature:
* @message: A #GDBusMessage.
- * @value: The value to set.
+ * @value: (nullable): The value to set.
*
* Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field.
*
@@ -17858,6 +17889,11 @@
*
* This method is only available on UNIX.
*
+ * When designing D-Bus APIs that are intended to be interoperable,
+ * please note that non-GDBus implementations of D-Bus can usually only
+ * access file descriptors if they are referenced by a value of type
+ * %G_VARIANT_TYPE_HANDLE in the body of the message.
+ *
* Since: 2.26
*/
@@ -17977,7 +18013,7 @@
* returned. See g_dbus_method_invocation_get_property_info() and
* #GDBusInterfaceVTable for more information.
*
- * Returns: A #GDBusMethodInfo or %NULL. Do not free, it is owned by @invocation.
+ * Returns: (nullable): A #GDBusMethodInfo or %NULL. Do not free, it is owned by @invocation.
* Since: 2.26
*/
@@ -18032,7 +18068,7 @@
*
* If the call was GetAll, %NULL will be returned.
*
- * Returns: (transfer none): a #GDBusPropertyInfo or %NULL
+ * Returns: (nullable) (transfer none): a #GDBusPropertyInfo or %NULL
* Since: 2.38
*/
@@ -18260,7 +18296,7 @@
*
* The cost of this function is O(n) in number of interfaces.
*
- * Returns: (transfer none): A #GDBusInterfaceInfo or %NULL if not found. Do not free, it is owned by @info.
+ * Returns: (nullable) (transfer none): A #GDBusInterfaceInfo or %NULL if not found. Do not free, it is owned by @info.
* Since: 2.26
*/
@@ -18317,7 +18353,7 @@
* Gets the D-Bus interface with name @interface_name associated with
* @object, if any.
*
- * Returns: (transfer full): %NULL if not found, otherwise a
+ * Returns: (nullable) (transfer full): %NULL if not found, otherwise a
* #GDBusInterface that must be freed with g_object_unref().
* Since: 2.30
*/
@@ -19521,7 +19557,7 @@
*
* Gets the categories from the desktop file.
*
- * Returns: The unparsed Categories key from the desktop file;
+ * Returns: (nullable): The unparsed Categories key from the desktop file;
* i.e. no attempt is made to split it by ';' or validate it.
*/
@@ -19534,7 +19570,7 @@
* situations such as the #GDesktopAppInfo returned from
* g_desktop_app_info_new_from_keyfile(), this function will return %NULL.
*
- * Returns: (type filename): The full path to the file for @info,
+ * Returns: (nullable) (type filename): The full path to the file for @info,
* or %NULL if not known.
* Since: 2.24
*/
@@ -19544,9 +19580,9 @@
* g_desktop_app_info_get_generic_name:
* @info: a #GDesktopAppInfo
*
- * Gets the generic name from the destkop file.
+ * Gets the generic name from the desktop file.
*
- * Returns: The value of the GenericName key
+ * Returns: (nullable): The value of the GenericName key
*/
@@ -19648,7 +19684,7 @@
* WM_CLASS property of the main window of the application, if launched
* through @info.
*
- * Returns: (transfer none): the startup WM class, or %NULL if none is set
+ * Returns: (nullable) (transfer none): the startup WM class, or %NULL if none is set
* in the desktop file.
* Since: 2.34
*/
@@ -19663,7 +19699,7 @@
*
* The @key is looked up in the "Desktop Entry" group.
*
- * Returns: a newly allocated string, or %NULL if the key
+ * Returns: (nullable): a newly allocated string, or %NULL if the key
* is not found
* Since: 2.36
*/
@@ -21177,8 +21213,8 @@
/**
* g_file_attribute_matcher_subtract:
- * @matcher: Matcher to subtract from
- * @subtract: The matcher to subtract
+ * @matcher: (nullable): Matcher to subtract from
+ * @subtract: (nullable): The matcher to subtract
*
* Subtracts all attributes of @subtract from @matcher and returns
* a matcher that supports those attributes.
@@ -21189,7 +21225,7 @@
* is a limitation of the current implementation, but may be fixed
* in the future.
*
- * Returns: A file attribute matcher matching all attributes of
+ * Returns: (nullable): A file attribute matcher matching all attributes of
* @matcher that are not matched by @subtract
*/
@@ -22342,7 +22378,7 @@
*
* Gets the #GFile associated with the given @icon.
*
- * Returns: (transfer none): a #GFile, or %NULL.
+ * Returns: (transfer none): a #GFile.
*/
@@ -22608,7 +22644,7 @@
* Gets the [entity tag][gfile-etag] for a given
* #GFileInfo. See %G_FILE_ATTRIBUTE_ETAG_VALUE.
*
- * Returns: a string containing the value of the "etag:value" attribute.
+ * Returns: (nullable): a string containing the value of the "etag:value" attribute.
*/
@@ -22629,7 +22665,7 @@
*
* Gets the icon for a file.
*
- * Returns: (transfer none): #GIcon for the given @info.
+ * Returns: (nullable) (transfer none): #GIcon for the given @info.
*/
@@ -22729,7 +22765,7 @@
*
* Gets the symbolic icon for a file.
*
- * Returns: (transfer none): #GIcon for the given @info.
+ * Returns: (nullable) (transfer none): #GIcon for the given @info.
* Since: 2.34
*/
@@ -22740,7 +22776,7 @@
*
* Gets the symlink target for a given #GFileInfo.
*
- * Returns: a string containing the symlink target.
+ * Returns: (nullable): a string containing the symlink target.
*/
@@ -23163,7 +23199,7 @@
* This must be called after the stream has been written
* and closed, as the etag can change while writing.
*
- * Returns: the entity tag for the stream.
+ * Returns: (nullable) (transfer full): the entity tag for the stream.
* Since: 2.22
*/
@@ -24066,7 +24102,7 @@
* This must be called after the stream has been written
* and closed, as the etag can change while writing.
*
- * Returns: the entity tag for the stream.
+ * Returns: (nullable) (transfer full): the entity tag for the stream.
*/
@@ -25391,9 +25427,9 @@
*
* Obtains a completion for @initial_text from @completer.
*
- * Returns: a completed string, or %NULL if no completion exists.
- * This string is not owned by GIO, so remember to g_free() it
- * when finished.
+ * Returns: (nullable) (transfer full): a completed string, or %NULL if no
+ * completion exists. This string is not owned by GIO, so remember to g_free()
+ * it when finished.
*/
@@ -25494,7 +25530,7 @@
*
* Deserializes a #GIcon previously serialized using g_icon_serialize().
*
- * Returns: (transfer full): a #GIcon, or %NULL when deserialization fails.
+ * Returns: (nullable) (transfer full): a #GIcon, or %NULL when deserialization fails.
* Since: 2.38
*/
@@ -25549,7 +25585,7 @@
* makes sense to transfer the #GVariant between processes on the same machine,
* (as opposed to over the network), and within the same file system namespace.
*
- * Returns: (transfer full): a #GVariant, or %NULL when serialization fails. The #GVariant will not be floating.
+ * Returns: (nullable) (transfer full): a #GVariant, or %NULL when serialization fails. The #GVariant will not be floating.
* Since: 2.38
*/
@@ -27548,7 +27584,7 @@
*
* Gets a reference to the default #GMemoryMonitor for the system.
*
- * Returns: (transfer full): a new reference to the default #GMemoryMonitor
+ * Returns: (not nullable) (transfer full): a new reference to the default #GMemoryMonitor
* Since: 2.64
*/
@@ -27965,7 +28001,7 @@
* type, %NULL is returned. %NULL is also returned if the attribute
* simply does not exist.
*
- * Returns: (transfer full): the attribute value, or %NULL
+ * Returns: (nullable) (transfer full): the attribute value, or %NULL
* Since: 2.34
*/
@@ -27977,7 +28013,7 @@
*
* Queries the named @link on @menu_item.
*
- * Returns: (transfer full): the link, or %NULL
+ * Returns: (nullable) (transfer full): the link, or %NULL
* Since: 2.34
*/
@@ -28473,7 +28509,7 @@
* If the attribute does not exist, or does not match the expected type
* then %NULL is returned.
*
- * Returns: (transfer full): the value of the attribute
+ * Returns: (nullable) (transfer full): the value of the attribute
* Since: 2.32
*/
@@ -28490,7 +28526,7 @@
* If the link exists, the linked #GMenuModel is returned. If the link
* does not exist, %NULL is returned.
*
- * Returns: (transfer full): the linked #GMenuModel, or %NULL
+ * Returns: (nullable) (transfer full): the linked #GMenuModel, or %NULL
* Since: 2.32
*/
@@ -29008,7 +29044,7 @@
*
* Gets the domain of the mount operation.
*
- * Returns: a string set to the domain.
+ * Returns: (nullable): a string set to the domain.
*/
@@ -29042,7 +29078,7 @@
*
* Gets a password from the mount operation.
*
- * Returns: a string containing the password within @op.
+ * Returns: (nullable): a string containing the password within @op.
*/
@@ -29073,7 +29109,7 @@
*
* Get the user name from the mount operation.
*
- * Returns: a string containing the user name.
+ * Returns: (nullable): a string containing the user name.
*/
@@ -29116,7 +29152,7 @@
/**
* g_mount_operation_set_domain:
* @op: a #GMountOperation.
- * @domain: the domain to set.
+ * @domain: (nullable): the domain to set.
*
* Sets the mount operation's domain.
*/
@@ -29147,7 +29183,7 @@
/**
* g_mount_operation_set_password:
* @op: a #GMountOperation.
- * @password: password to set.
+ * @password: (nullable): password to set.
*
* Sets the mount operation's password to @password.
*/
@@ -29176,7 +29212,7 @@
/**
* g_mount_operation_set_username:
* @op: a #GMountOperation.
- * @username: input username.
+ * @username: (nullable): input username.
*
* Sets the user name within @op to @username.
*/
@@ -29349,7 +29385,7 @@
*
* Gets @addr's scheme
*
- * Returns: @addr's scheme (%NULL if not built from URI)
+ * Returns: (nullable): @addr's scheme (%NULL if not built from URI)
* Since: 2.26
*/
@@ -29579,7 +29615,8 @@
*
* Gets the default #GNetworkMonitor for the system.
*
- * Returns: (transfer none): a #GNetworkMonitor
+ * Returns: (not nullable) (transfer none): a #GNetworkMonitor, which will be
+ * a dummy object if no network monitor is available
* Since: 2.32
*/
@@ -31190,7 +31227,7 @@
*
* Gets @proxy's password.
*
- * Returns: the @proxy's password
+ * Returns: (nullable): the @proxy's password
* Since: 2.26
*/
@@ -31212,7 +31249,7 @@
*
* Gets the proxy URI that @proxy was constructed from.
*
- * Returns: the @proxy's URI, or %NULL if unknown
+ * Returns: (nullable): the @proxy's URI, or %NULL if unknown
* Since: 2.34
*/
@@ -31223,7 +31260,7 @@
*
* Gets @proxy's username.
*
- * Returns: the @proxy's username
+ * Returns: (nullable): the @proxy's username
* Since: 2.26
*/
@@ -31307,7 +31344,7 @@
* Find the `gio-proxy` extension point for a proxy implementation that supports
* the specified protocol.
*
- * Returns: (transfer full): return a #GProxy or NULL if protocol
+ * Returns: (nullable) (transfer full): return a #GProxy or NULL if protocol
* is not supported.
* Since: 2.26
*/
@@ -31318,7 +31355,8 @@
*
* Gets the default #GProxyResolver for the system.
*
- * Returns: (transfer none): the default #GProxyResolver.
+ * Returns: (not nullable) (transfer none): the default #GProxyResolver, which
+ * will be a dummy object if no proxy resolver is available
* Since: 2.26
*/
@@ -32307,7 +32345,9 @@
*
* The user gets a reference to the backend.
*
- * Returns: (transfer full): the default #GSettingsBackend
+ * Returns: (not nullable) (transfer full): the default #GSettingsBackend,
+ * which will be a dummy (memory) settings backend if no other settings
+ * backend is available.
* Since: 2.28
*/
@@ -33175,7 +33215,7 @@
* therefore describe multiple sets of keys at different locations. For
* relocatable schemas, this function will return %NULL.
*
- * Returns: (transfer none): the path of the schema, or %NULL
+ * Returns: (nullable) (transfer none): the path of the schema, or %NULL
* Since: 2.32
*/
@@ -33225,7 +33265,7 @@
* function has to parse all of the source XML files in the schema
* directory.
*
- * Returns: the description for @key, or %NULL
+ * Returns: (nullable): the description for @key, or %NULL
* Since: 2.34
*/
@@ -33305,7 +33345,7 @@
* function has to parse all of the source XML files in the schema
* directory.
*
- * Returns: the summary for @key, or %NULL
+ * Returns: (nullable): the summary for @key, or %NULL
* Since: 2.34
*/
@@ -34976,7 +35016,7 @@
*
* See g_socket_client_set_local_address() for details.
*
- * Returns: (transfer none): a #GSocketAddress or %NULL. Do not free.
+ * Returns: (nullable) (transfer none): a #GSocketAddress or %NULL. Do not free.
* Since: 2.22
*/
@@ -37509,10 +37549,10 @@
* Gets the #GInputStream from which to read the stderr output of
* @subprocess.
*
- * The process must have been created with
- * %G_SUBPROCESS_FLAGS_STDERR_PIPE.
+ * The process must have been created with %G_SUBPROCESS_FLAGS_STDERR_PIPE,
+ * otherwise %NULL will be returned.
*
- * Returns: (transfer none): the stderr pipe
+ * Returns: (nullable) (transfer none): the stderr pipe
* Since: 2.40
*/
@@ -37524,10 +37564,10 @@
* Gets the #GOutputStream that you can write to in order to give data
* to the stdin of @subprocess.
*
- * The process must have been created with
- * %G_SUBPROCESS_FLAGS_STDIN_PIPE.
+ * The process must have been created with %G_SUBPROCESS_FLAGS_STDIN_PIPE and
+ * not %G_SUBPROCESS_FLAGS_STDIN_INHERIT, otherwise %NULL will be returned.
*
- * Returns: (transfer none): the stdout pipe
+ * Returns: (nullable) (transfer none): the stdout pipe
* Since: 2.40
*/
@@ -37539,10 +37579,10 @@
* Gets the #GInputStream from which to read the stdout output of
* @subprocess.
*
- * The process must have been created with
- * %G_SUBPROCESS_FLAGS_STDOUT_PIPE.
+ * The process must have been created with %G_SUBPROCESS_FLAGS_STDOUT_PIPE,
+ * otherwise %NULL will be returned.
*
- * Returns: (transfer none): the stdout pipe
+ * Returns: (nullable) (transfer none): the stdout pipe
* Since: 2.40
*/
@@ -37610,7 +37650,7 @@
* On UNIX, the returned string can be an arbitrary byte string.
* On Windows, it will be UTF-8.
*
- * Returns: (type filename): the value of the environment variable,
+ * Returns: (nullable) (type filename): the value of the environment variable,
* %NULL if unset
* Since: 2.40
*/
@@ -39028,7 +39068,8 @@
*
* Gets the default #GTlsBackend for the system.
*
- * Returns: (transfer none): a #GTlsBackend
+ * Returns: (not nullable) (transfer none): a #GTlsBackend, which will be a
+ * dummy object if no TLS backend is available
* Since: 2.28
*/
@@ -39140,7 +39181,7 @@
*
* Gets the #GTlsCertificate representing @cert's issuer, if known
*
- * Returns: (transfer none): The certificate of @cert's issuer,
+ * Returns: (nullable) (transfer none): The certificate of @cert's issuer,
* or %NULL if @cert is self-signed or signed with an unknown
* certificate.
* Since: 2.28
@@ -39398,7 +39439,7 @@
*
* Gets @conn's expected server identity
*
- * Returns: (transfer none): a #GSocketConnectable describing the
+ * Returns: (nullable) (transfer none): a #GSocketConnectable describing the
* expected server identity, or %NULL if the expected identity is not
* known.
* Since: 2.28
@@ -41467,7 +41508,7 @@
*
* Gets the options for the mount point.
*
- * Returns: a string containing the options.
+ * Returns: (nullable): a string containing the options.
* Since: 2.32
*/
@@ -41791,7 +41832,8 @@
*
* Gets the default #GVfs for the system.
*
- * Returns: (transfer none): a #GVfs.
+ * Returns: (not nullable) (transfer none): a #GVfs, which will be the local
+ * file system #GVfs if no other implementation is available.
*/
@@ -42232,7 +42274,7 @@
*
* Finds a #GMount object by its UUID (see g_mount_get_uuid())
*
- * Returns: (transfer full): a #GMount or %NULL if no such mount is available.
+ * Returns: (nullable) (transfer full): a #GMount or %NULL if no such mount is available.
* Free the returned object with g_object_unref().
*/
@@ -42257,7 +42299,7 @@
*
* Finds a #GVolume object by its UUID (see g_volume_get_uuid())
*
- * Returns: (transfer full): a #GVolume or %NULL if no such volume is available.
+ * Returns: (nullable) (transfer full): a #GVolume or %NULL if no such volume is available.
* Free the returned object with g_object_unref().
*/
@@ -43080,7 +43122,7 @@
*
* Returns the #GZlibCompressor:file-info property.
*
- * Returns: (transfer none): a #GFileInfo, or %NULL
+ * Returns: (nullable) (transfer none): a #GFileInfo, or %NULL
* Since: 2.26
*/
@@ -43125,7 +43167,7 @@
* or the header data was not fully processed yet, or it not present in the
* data stream at all.
*
- * Returns: (transfer none): a #GFileInfo, or %NULL
+ * Returns: (nullable) (transfer none): a #GFileInfo, or %NULL
* Since: 2.26
*/