diff options
author | Rico Tzschichholz <ricotz@ubuntu.com> | 2017-12-09 13:20:20 +0100 |
---|---|---|
committer | Rico Tzschichholz <ricotz@ubuntu.com> | 2017-12-09 13:20:20 +0100 |
commit | fe3c8e24e4684f9a4440c599c2a6b141281aaaf2 (patch) | |
tree | c505eef8c068c492246f8f1a432682d3d3f0062c /gir/glib-2.0.c | |
parent | 5c3f20e243929e8f37b23f2e8f48ecbcdbd4303f (diff) | |
download | gobject-introspection-fe3c8e24e4684f9a4440c599c2a6b141281aaaf2.tar.gz |
gir: Update annotations from GLib git master
Diffstat (limited to 'gir/glib-2.0.c')
-rw-r--r-- | gir/glib-2.0.c | 25 |
1 files changed, 16 insertions, 9 deletions
diff --git a/gir/glib-2.0.c b/gir/glib-2.0.c index 1651e312..17d30b09 100644 --- a/gir/glib-2.0.c +++ b/gir/glib-2.0.c @@ -12120,7 +12120,7 @@ * @bytes: (nullable): a #GBytes * * Releases a reference on @bytes. This may result in the bytes being - * freed. + * freed. If @bytes is %NULL, it will return immediately. * * Since: 2.32 */ @@ -14146,7 +14146,8 @@ * for the specifier. * * Returns: a newly allocated string formatted to the requested format - * or %NULL in the case that there was an error. The string + * or %NULL in the case that there was an error (such as a format specifier + * not being supported in the current locale). The string * should be freed with g_free(). * Since: 2.26 */ @@ -27608,7 +27609,8 @@ * first element comes before the second, or a positive value if * the first element comes after the second. * - * Sorts a #GSList using the given comparison function. + * Sorts a #GSList using the given comparison function. The algorithm + * used is a stable sort. * * Returns: the start of the sorted #GSList */ @@ -28015,17 +28017,15 @@ * g_source_remove: * @tag: the ID of the source to remove. * - * Removes the source with the given id from the default main context. + * Removes the source with the given ID from the default main context. You must + * use g_source_destroy() for sources added to a non-default main context. * - * The id of a #GSource is given by g_source_get_id(), or will be + * The ID of a #GSource is given by g_source_get_id(), or will be * returned by the functions g_source_attach(), g_idle_add(), * g_idle_add_full(), g_timeout_add(), g_timeout_add_full(), * g_child_watch_add(), g_child_watch_add_full(), g_io_add_watch(), and * g_io_add_watch_full(). * - * See also g_source_destroy(). You must use g_source_destroy() for sources - * added to a non-default main context. - * * It is a programmer error to attempt to remove a non-existent source. * * More specifically: source IDs can be reissued after a source has been @@ -28264,7 +28264,7 @@ * Note that if you have a pair of sources where the ready time of one * suggests that it will be delivered first but the priority for the * other suggests that it would be delivered first, and the ready time - * for both sources is reached during the same main context iteration + * for both sources is reached during the same main context iteration, * then the order of dispatch is undefined. * * It is a no-op to call this function on a #GSource which has already been @@ -35257,6 +35257,13 @@ * data from untrusted sources and you want to ensure your serialised * output is definitely in normal form. * + * If @value is already in normal form, a new reference will be returned + * (which will be floating if @value is floating). If it is not in normal form, + * the newly created #GVariant will be returned with a single non-floating + * reference. Typically, g_variant_take_ref() should be called on the return + * value from this function to guarantee ownership of a single non-floating + * reference to it. + * * Returns: (transfer full): a trusted #GVariant * Since: 2.24 */ |