diff options
author | Rico Tzschichholz <ricotz@ubuntu.com> | 2018-03-10 20:14:09 +0100 |
---|---|---|
committer | Rico Tzschichholz <ricotz@ubuntu.com> | 2018-03-10 20:14:09 +0100 |
commit | 695ed85afa9034a8d68a71572fa5450c428cd8be (patch) | |
tree | 4c94c590a47e7227d60a7be1ae8a917dd3e1ecd4 /gir/glib-2.0.c | |
parent | 53bde6ead14c62606b2cb04d2fd96a271f9ca9f9 (diff) | |
download | gobject-introspection-695ed85afa9034a8d68a71572fa5450c428cd8be.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 | 19 |
1 files changed, 18 insertions, 1 deletions
diff --git a/gir/glib-2.0.c b/gir/glib-2.0.c index 98c2f02e..56926fc0 100644 --- a/gir/glib-2.0.c +++ b/gir/glib-2.0.c @@ -8903,7 +8903,8 @@ * * The @clear_func will be called when an element in the array * data segment is removed and when the array is freed and data - * segment is deallocated as well. + * segment is deallocated as well. @clear_func will be passed a + * pointer to the element to clear, rather than the element itself. * * Note that in contrast with other uses of #GDestroyNotify * functions, @clear_func is expected to clear the contents of @@ -14051,6 +14052,11 @@ * Creates a copy of @datetime and adds the specified number of months to the * copy. Add negative values to subtract months. * + * The day of the month of the resulting #GDateTime is clamped to the number + * of days in the updated calendar month. For example, if adding 1 month to + * 31st January 2018, the result would be 28th February 2018. In 2020 (a leap + * year), the result would be 29th February. + * * Returns: the newly created #GDateTime which should be freed with * g_date_time_unref(). * Since: 2.26 @@ -14093,6 +14099,9 @@ * Creates a copy of @datetime and adds the specified number of years to the * copy. Add negative values to subtract years. * + * As with g_date_time_add_months(), if the resulting date would be 29th + * February on a non-leap year, the day will be clamped to 28th February. + * * Returns: the newly created #GDateTime which should be freed with * g_date_time_unref(). * Since: 2.26 @@ -14236,6 +14245,14 @@ * - 0: Pad a numeric result with zeros. This overrides the default padding * for the specifier. * + * Additionally, when O is used with B, b, or h, it produces the alternative + * form of a month name. The alternative form should be used when the month + * name is used without a day number (e.g., standalone). It is required in + * some languages (Baltic, Slavic, Greek, and more) due to their grammatical + * rules. For other languages there is no difference. \%OB is a GNU and BSD + * strftime() extension expected to be added to the future POSIX specification, + * \%Ob and \%Oh are GNU strftime() extensions. Since: 2.56 + * * Returns: a newly allocated string formatted to the requested format * or %NULL in the case that there was an error (such as a format specifier * not being supported in the current locale). The string |