diff options
Diffstat (limited to 'gir')
| -rw-r--r-- | gir/gio-2.0.c | 80 | ||||
| -rw-r--r-- | gir/glib-2.0.c | 10 | ||||
| -rw-r--r-- | gir/gobject-2.0.c | 15 |
3 files changed, 63 insertions, 42 deletions
diff --git a/gir/gio-2.0.c b/gir/gio-2.0.c index 4f1b0f57..23bf75b2 100644 --- a/gir/gio-2.0.c +++ b/gir/gio-2.0.c @@ -18346,6 +18346,19 @@ /** + * g_desktop_app_info_get_implementations: + * @interface: the name of the interface + * + * Gets all applications that implement @interface. + * + * An application implements an interface if that interface is listed in + * the Implements= line of the desktop file of the application. + * + * Since: 2.42 + */ + + +/** * g_desktop_app_info_get_is_hidden: * @info: a #GDesktopAppInfo. * @@ -18383,14 +18396,16 @@ /** * g_desktop_app_info_get_show_in: * @info: a #GDesktopAppInfo - * @desktop_env: a string specifying a desktop name + * @desktop_env: (nullable): a string specifying a desktop name * * Checks if the application info should be shown in menus that list available * applications for a specific name of the desktop, based on the * `OnlyShowIn` and `NotShowIn` keys. * - * If @desktop_env is %NULL, then the name of the desktop set with - * g_desktop_app_info_set_desktop_env() is used. + * @desktop_env should typically be given as %NULL, in which case the + * `XDG_CURRENT_DESKTOP` environment variable is consulted. If you want + * to override the default mechanism then you may specify @desktop_env, + * but this is not recommended. * * Note that g_app_info_should_show() for @info will include this check (with * %NULL for @desktop_env) as well as additional checks. @@ -18607,18 +18622,10 @@ * `OnlyShowIn` and `NotShowIn` * desktop entry fields. * - * The - * [Desktop Menu specification](http://standards.freedesktop.org/menu-spec/latest/) - * recognizes the following: - * - GNOME - * - KDE - * - ROX - * - XFCE - * - LXDE - * - Unity - * - Old - * * Should be called only once; subsequent calls are ignored. + * + * Deprecated: 2.42: do not use this API. Since 2.42 the value of the + * `XDG_CURRENT_DESKTOP` environment variable will be used. */ @@ -20011,7 +20018,7 @@ * * Finishes the asynchronous operation started with g_file_enumerator_next_files_async(). * - * Returns: (transfer full) (element-type Gio.FileInfo): a #GList of #GFileInfo<!---->s. You must free the list with + * Returns: (transfer full) (element-type Gio.FileInfo): a #GList of #GFileInfos. You must free the list with * g_list_free() and unref the infos with g_object_unref() when you're * done with them. */ @@ -28599,7 +28606,7 @@ * the textual form of an IP address (in which case this just becomes * a wrapper around g_inet_address_new_from_string()). * - * On success, g_resolver_lookup_by_name() will return a #GList of + * On success, g_resolver_lookup_by_name() will return a non-empty #GList of * #GInetAddress, sorted in order of preference and guaranteed to not * contain duplicates. That is, if using the result to connect to * @hostname, you should attempt to connect to the first address @@ -28608,7 +28615,7 @@ * result using e.g. g_socket_listener_add_address(). * * If the DNS resolution fails, @error (if non-%NULL) will be set to a - * value from #GResolverError. + * value from #GResolverError and %NULL will be returned. * * If @cancellable is non-%NULL, it can be used to cancel the * operation, in which case @error (if non-%NULL) will be set to @@ -28618,7 +28625,7 @@ * address, it may be easier to create a #GNetworkAddress and use its * #GSocketConnectable interface. * - * Returns: (element-type GInetAddress) (transfer full): a #GList + * Returns: (element-type GInetAddress) (transfer full): a non-empty #GList * of #GInetAddress, or %NULL on error. You * must unref each of the addresses and free the list when you are * done with it. (You can use g_resolver_free_addresses() to do this.) @@ -28676,15 +28683,16 @@ * information on what the records contain for each @record_type. * * If the DNS resolution fails, @error (if non-%NULL) will be set to - * a value from #GResolverError. + * a value from #GResolverError and %NULL will be returned. * * If @cancellable is non-%NULL, it can be used to cancel the * operation, in which case @error (if non-%NULL) will be set to * %G_IO_ERROR_CANCELLED. * - * Returns: (element-type GVariant) (transfer full): a #GList of #GVariant, - * or %NULL on error. You must free each of the records and the list when you are - * done with it. (You can use g_list_free_full() with g_variant_unref() to do this.) + * Returns: (element-type GVariant) (transfer full): a non-empty #GList of + * #GVariant, or %NULL on error. You must free each of the records and the list + * when you are done with it. (You can use g_list_free_full() with + * g_variant_unref() to do this.) * Since: 2.34 */ @@ -28714,16 +28722,18 @@ * @error: return location for a #GError, or %NULL * * Retrieves the result of a previous call to - * g_resolver_lookup_records_async(). Returns a list of records as #GVariant - * tuples. See #GResolverRecordType for information on what the records contain. + * g_resolver_lookup_records_async(). Returns a non-empty list of records as + * #GVariant tuples. See #GResolverRecordType for information on what the + * records contain. * * If the DNS resolution failed, @error (if non-%NULL) will be set to * a value from #GResolverError. If the operation was cancelled, * @error will be set to %G_IO_ERROR_CANCELLED. * - * Returns: (element-type GVariant) (transfer full): a #GList of #GVariant, - * or %NULL on error. You must free each of the records and the list when you are - * done with it. (You can use g_list_free_full() with g_variant_unref() to do this.) + * Returns: (element-type GVariant) (transfer full): a non-empty #GList of + * #GVariant, or %NULL on error. You must free each of the records and the list + * when you are done with it. (You can use g_list_free_full() with + * g_variant_unref() to do this.) * Since: 2.34 */ @@ -28743,13 +28753,13 @@ * @service and @protocol arguments do not include the leading underscore * that appears in the actual DNS entry. * - * On success, g_resolver_lookup_service() will return a #GList of + * On success, g_resolver_lookup_service() will return a non-empty #GList of * #GSrvTarget, sorted in order of preference. (That is, you should * attempt to connect to the first target first, then the second if * the first fails, etc.) * * If the DNS resolution fails, @error (if non-%NULL) will be set to - * a value from #GResolverError. + * a value from #GResolverError and %NULL will be returned. * * If @cancellable is non-%NULL, it can be used to cancel the * operation, in which case @error (if non-%NULL) will be set to @@ -28759,9 +28769,10 @@ * to create a #GNetworkService and use its #GSocketConnectable * interface. * - * Returns: (element-type GSrvTarget) (transfer full): a #GList of #GSrvTarget, - * or %NULL on error. You must free each of the targets and the list when you are - * done with it. (You can use g_resolver_free_targets() to do this.) + * Returns: (element-type GSrvTarget) (transfer full): a non-empty #GList of + * #GSrvTarget, or %NULL on error. You must free each of the targets and the + * list when you are done with it. (You can use g_resolver_free_targets() to do + * this.) * Since: 2.22 */ @@ -28799,8 +28810,9 @@ * a value from #GResolverError. If the operation was cancelled, * @error will be set to %G_IO_ERROR_CANCELLED. * - * Returns: (element-type GSrvTarget) (transfer full): a #GList of #GSrvTarget, - * or %NULL on error. See g_resolver_lookup_service() for more details. + * Returns: (element-type GSrvTarget) (transfer full): a non-empty #GList of + * #GSrvTarget, or %NULL on error. See g_resolver_lookup_service() for more + * details. * Since: 2.22 */ diff --git a/gir/glib-2.0.c b/gir/glib-2.0.c index 9c554298..dacb1e2c 100644 --- a/gir/glib-2.0.c +++ b/gir/glib-2.0.c @@ -6800,7 +6800,8 @@ /** * SECTION:markup - * @Title: Simple XML Subset Parser * @Short_description: parses a subset of XML + * @Title: Simple XML Subset Parser + * @Short_description: parses a subset of XML * @See_also: [XML Specification](http://www.w3.org/TR/REC-xml/) * * The "GMarkup" parser is intended to parse a simple markup format @@ -24911,7 +24912,7 @@ * Note that on some systems, when variables are overwritten, the memory * used for the previous variables and its value isn't reclaimed. * - * You should be mindful fo the fact that environment variable handling + * You should be mindful of the fact that environment variable handling * in UNIX is not thread-safe, and your program may crash if one thread * calls g_setenv() while another thread is calling getenv(). (And note * that many functions, such as gettext(), call getenv() internally.) @@ -27485,7 +27486,8 @@ /** * g_string_new: - * @init: the initial text to copy into the string + * @init: (allow-none): the initial text to copy into the string, or %NULL to + * start with an empty string. * * Creates a new #GString, initialized with the given string. * @@ -32757,7 +32759,7 @@ * serialised data, you must know the type of the #GVariant, and (if the * machine might be different) the endianness of the machine that stored * it. As a result, file formats or network messages that incorporate - * serialised #GVariant<!---->s must include this information either + * serialised #GVariants must include this information either * implicitly (for instance "the file always contains a * %G_VARIANT_TYPE_VARIANT and it is always in little-endian order") or * explicitly (by storing the type and/or endianness in addition to the diff --git a/gir/gobject-2.0.c b/gir/gobject-2.0.c index 03aacde9..a4bfed0f 100644 --- a/gir/gobject-2.0.c +++ b/gir/gobject-2.0.c @@ -4065,7 +4065,7 @@ * * See g_signal_new() for information about signal names. * - * If c_marshaller is %NULL @g_cclosure_marshal_generic will be used as + * If c_marshaller is %NULL, g_cclosure_marshal_generic() will be used as * the marshaller for this signal. * * Returns: the signal id @@ -4127,7 +4127,7 @@ * * See g_signal_new() for details on allowed signal names. * - * If c_marshaller is %NULL @g_cclosure_marshal_generic will be used as + * If c_marshaller is %NULL, g_cclosure_marshal_generic() will be used as * the marshaller for this signal. * * Returns: the signal id @@ -4320,7 +4320,9 @@ * when the class is allocated, the private structures for * the class and all of its parent types are allocated * sequentially in the same memory block as the public - * structures. This function should be called in the + * structures, and are zero-filled. + * + * This function should be called in the * type's get_type() function after the type is registered. * The private structure can be retrieved using the * G_TYPE_CLASS_GET_PRIVATE() macro. @@ -4409,7 +4411,7 @@ * When an object is allocated, the private structures for * the type and all of its parent types are allocated * sequentially in the same memory block as the public - * structures. + * structures, and are zero-filled. * * Note that the accumulated size of the private structures of * a type and all its parent types cannot exceed 64 KiB. @@ -4451,6 +4453,8 @@ * my_object->priv = G_TYPE_INSTANCE_GET_PRIVATE (my_object, * MY_TYPE_OBJECT, * MyObjectPrivate); + * /<!-- -->* my_object->priv->some_field will be + * * automatically initialised to 0 *<!-- -->/ * } * * static int @@ -4586,6 +4590,9 @@ * directly through g_type_create_instance() which doesn't handle things * like singleton objects or object construction. * + * The extended members of the returned instance are guaranteed to be filled + * with zeros. + * * Note: Do not use this function, unless you're implementing a * fundamental type. Also language bindings should not use this * function, but g_object_new() instead. |