GNOME.org
 

[glibmm] Glib, Gio: Regenerate docs.xml and .defs files

commit e1b3dfb33a7f3c38db952fed96c559dd5ed302cd
Author: Kjell Ahlstedt <kjellahlstedt gmail com>
Date:   Tue Aug 13 20:03:31 2019 +0200

    Glib, Gio: Regenerate docs.xml and .defs files

 gio/src/gio_docs.xml         |  59 ++++++++++++++++++------
 gio/src/gio_methods.defs     |  15 +++++++
 glib/src/glib_docs.xml       | 104 +++++++++++++++++++++++++++++++++++++++++--
 glib/src/glib_functions.defs |   6 +++
 4 files changed, 166 insertions(+), 18 deletions(-)
---
diff --git a/gio/src/gio_docs.xml b/gio/src/gio_docs.xml
index 31bc44b4..4ac0d5fd 100644
--- a/gio/src/gio_docs.xml
+++ b/gio/src/gio_docs.xml
@@ -26687,11 +26687,32 @@ Checks if a file is a symlink.
 </return>
 </function>
 
+<function name="g_file_info_get_modification_date_time">
+<description>
+Gets the modification time of the current @info and returns it as a
+#GDateTime.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+</parameters>
+<return> modification time, or %NULL if unknown
+</return>
+</function>
+
 <function name="g_file_info_get_modification_time">
 <description>
 Gets the modification time of the current @info and sets it
 in @result.
 
+Deprecated: 2.62: Use g_file_info_get_modification_date_time() instead, as
+#GTimeVal is deprecated due to the year 2038 problem.
+
 </description>
 <parameters>
 <parameter name="info">
@@ -27307,11 +27328,35 @@ See %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK.
 <return></return>
 </function>
 
+<function name="g_file_info_set_modification_date_time">
+<description>
+Sets the %G_FILE_ATTRIBUTE_TIME_MODIFIED attribute in the file
+info to the given date/time value.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="info">
+<parameter_description> a #GFileInfo.
+</parameter_description>
+</parameter>
+<parameter name="mtime">
+<parameter_description> a #GDateTime.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="g_file_info_set_modification_time">
 <description>
 Sets the %G_FILE_ATTRIBUTE_TIME_MODIFIED attribute in the file
 info to the given time value.
 
+Deprecated: 2.62: Use g_file_info_set_modification_date_time() instead, as
+#GTimeVal is deprecated due to the year 2038 problem.
+
 </description>
 <parameters>
 <parameter name="info">
@@ -59571,18 +59616,4 @@ GetLogicalDrives() is returned.
 </return>
 </function>
 
-<function name="inet_addresses_to_inet_socket_addresses">
-<description>
-
-</description>
-<parameters>
-<parameter name="addresses">
-<parameter_description> #GList of #GInetAddress
-</parameter_description>
-</parameter>
-</parameters>
-<return> #GList of #GInetSocketAddress
-</return>
-</function>
-
 </root>
diff --git a/gio/src/gio_methods.defs b/gio/src/gio_methods.defs
index 3aa62405..2a1adfed 100644
--- a/gio/src/gio_methods.defs
+++ b/gio/src/gio_methods.defs
@@ -9681,6 +9681,12 @@
   )
 )
 
+(define-method get_modification_date_time
+  (of-object "GFileInfo")
+  (c-name "g_file_info_get_modification_date_time")
+  (return-type "GDateTime*")
+)
+
 (define-method get_symlink_target
   (of-object "GFileInfo")
   (c-name "g_file_info_get_symlink_target")
@@ -9813,6 +9819,15 @@
   )
 )
 
+(define-method set_modification_date_time
+  (of-object "GFileInfo")
+  (c-name "g_file_info_set_modification_date_time")
+  (return-type "none")
+  (parameters
+    '("GDateTime*" "mtime")
+  )
+)
+
 (define-method set_symlink_target
   (of-object "GFileInfo")
   (c-name "g_file_info_set_symlink_target")
diff --git a/glib/src/glib_docs.xml b/glib/src/glib_docs.xml
index ed807ca6..9604e1f8 100644
--- a/glib/src/glib_docs.xml
+++ b/glib/src/glib_docs.xml
@@ -3537,6 +3537,22 @@ Old South Arabian. Since 2.26
 <parameter_description>              Sogdian. Since: 2.58
 </parameter_description>
 </parameter>
+<parameter name="G_UNICODE_SCRIPT_ELYMAIC">
+<parameter_description>              Elym. Since: 2.62
+</parameter_description>
+</parameter>
+<parameter name="G_UNICODE_SCRIPT_NANDINAGARI">
+<parameter_description>          Nand. Since: 2.62
+</parameter_description>
+</parameter>
+<parameter name="G_UNICODE_SCRIPT_NYIAKENG_PUACHUE_HMONG">
+<parameter_description> Rohg. Since: 2.62
+</parameter_description>
+</parameter>
+<parameter name="G_UNICODE_SCRIPT_WANCHO">
+<parameter_description>               Wcho. Since: 2.62
+</parameter_description>
+</parameter>
 </parameters>
 </enum>
 
@@ -5716,6 +5732,29 @@ Since: 2.38
 <return></return>
 </function>
 
+<function name="g_assert_finalize_object">
+<description>
+Assert that @object is non-%NULL, then release one reference to it with
+g_object_unref() and assert that it has been finalized (i.e. that there
+are no more references).
+
+If assertions are disabled via `G_DISABLE_ASSERT`,
+this macro just calls g_object_unref() without any further checks.
+
+This macro should only be used in regression tests.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="object">
+<parameter_description> an object
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="g_assert_no_error">
 <description>
 Debugging macro to check that a #GError is not set.
@@ -6330,7 +6369,7 @@ Pops data from the @queue. If the queue is empty, blocks until
 
 If no data is received before @end_time, %NULL is returned.
 
-To easily calculate @end_time, a combination of g_get_current_time()
+To easily calculate @end_time, a combination of g_get_real_time()
 and g_time_val_add() can be used.
 
 Deprecated: use g_async_queue_timeout_pop().
@@ -6359,7 +6398,7 @@ Pops data from the @queue. If the queue is empty, blocks until
 
 If no data is received before @end_time, %NULL is returned.
 
-To easily calculate @end_time, a combination of g_get_current_time()
+To easily calculate @end_time, a combination of g_get_real_time()
 and g_time_val_add() can be used.
 
 This function must be called while holding the @queue's lock.
@@ -14001,7 +14040,7 @@ If @abs_time is %NULL, g_cond_timed_wait() acts like g_cond_wait().
 This function can be used even if g_thread_init() has not yet been
 called, and, in that case, will immediately return %TRUE.
 
-To easily calculate @abs_time a combination of g_get_current_time()
+To easily calculate @abs_time a combination of g_get_real_time()
 and g_time_val_add() can be used.
 
 Deprecated:2.32: Use g_cond_wait_until() instead.
@@ -15882,6 +15921,8 @@ additional precision.
 The time to date conversion is done using the user's current timezone.
 
 Since: 2.10
+Deprecated: 2.62: #GTimeVal is not year-2038-safe. Use g_date_set_time_t()
+instead.
 
 </description>
 <parameters>
@@ -16455,6 +16496,27 @@ should be freed with g_free().
 </return>
 </function>
 
+<function name="g_date_time_format_iso8601">
+<description>
+Format @datetime in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601),
+including the date, time and time zone, and return that as a UTF-8 encoded
+string.
+
+Since: 2.62
+
+</description>
+<parameters>
+<parameter name="datetime">
+<parameter_description> A #GDateTime
+</parameter_description>
+</parameter>
+</parameters>
+<return> a newly allocated string formatted in ISO 8601 format
+or %NULL in the case that there was an error. The string
+should be freed with g_free().
+</return>
+</function>
+
 <function name="g_date_time_get_day_of_month">
 <description>
 Retrieves the day of the month represented by @datetime in the gregorian
@@ -16995,6 +17057,8 @@ You should release the return value by calling g_date_time_unref()
 when you are done with it.
 
 Since: 2.26
+Deprecated: 2.62: #GTimeVal is not year-2038-safe. Use
+g_date_time_new_from_unix_local() instead.
 
 </description>
 <parameters>
@@ -17022,6 +17086,8 @@ You should release the return value by calling g_date_time_unref()
 when you are done with it.
 
 Since: 2.26
+Deprecated: 2.62: #GTimeVal is not year-2038-safe. Use
+g_date_time_new_from_unix_utc() instead.
 
 </description>
 <parameters>
@@ -17293,6 +17359,8 @@ out of range.
 On systems where 'long' is 64bit, this function never fails.
 
 Since: 2.26
+Deprecated: 2.62: #GTimeVal is not year-2038-safe. Use
+g_date_time_to_unix() instead.
 
 </description>
 <parameters>
@@ -19449,6 +19517,9 @@ Equivalent to the UNIX gettimeofday() function, but portable.
 
 You may find g_get_real_time() to be more convenient.
 
+Deprecated: 2.62: #GTimeVal is not year-2038-safe. Use g_get_real_time()
+instead.
+
 </description>
 <parameters>
 <parameter name="result">
@@ -31365,6 +31436,7 @@ The @value can be:
 
 - an empty #GValue initialized by %G_VALUE_INIT, which will be
 automatically initialized with the expected type of the property
+(since GLib 2.60)
 - a #GValue initialized with the expected type of the property
 - a #GValue initialized with a type to which the expected type
 of the property can be transformed
@@ -35708,6 +35780,9 @@ may get compiler warnings from this though if compiling with GCC’s
 If @func is %NULL, then only the pointers (and not what they are
 pointing to) are copied to the new #GPtrArray.
 
+The copy of @array will have the same #GDestroyNotify for its elements as
+@array.
+
 Since: 2.62
 
 </description>
@@ -51768,6 +51843,9 @@ This function is often used as a method to make busy wait less evil.
 Adds the given number of microseconds to @time_. @microseconds can
 also be negative to decrease the value of @time_.
 
+Deprecated: 2.62: #GTimeVal is not year-2038-safe. Use `guint64` for
+representing microseconds since the epoch, or use #GDateTime.
+
 </description>
 <parameters>
 <parameter name="time_">
@@ -51794,7 +51872,17 @@ timestamp is assumed to be in local time.)
 
 Any leading or trailing space in @iso_date is ignored.
 
+This function was deprecated, along with #GTimeVal itself, in GLib 2.62.
+Equivalent functionality is available using code like:
+|[
+GDateTime *dt = g_date_time_new_from_iso8601 (iso8601_string, NULL);
+gint64 time_val = g_date_time_to_unix (dt);
+g_date_time_unref (dt);
+]|
+
 Since: 2.12
+Deprecated: 2.62: #GTimeVal is not year-2038-safe. Use
+g_date_time_new_from_iso8601() instead.
 
 </description>
 <parameters>
@@ -51838,12 +51926,20 @@ variation of ISO 8601 format is required.
 If @time_ represents a date which is too large to fit into a `struct tm`,
 %NULL will be returned. This is platform dependent. Note also that since
 `GTimeVal` stores the number of seconds as a `glong`, on 32-bit systems it
-is subject to the year 2038 problem.
+is subject to the year 2038 problem. Accordingly, since GLib 2.62, this
+function has been deprecated. Equivalent functionality is available using:
+|[
+GDateTime *dt = g_date_time_new_from_unix_utc (time_val);
+iso8601_string = g_date_time_format_iso8601 (dt);
+g_date_time_unref (dt);
+]|
 
 The return value of g_time_val_to_iso8601() has been nullable since GLib
 2.54; before then, GLib would crash under the same conditions.
 
 Since: 2.12
+Deprecated: 2.62: #GTimeVal is not year-2038-safe. Use
+g_date_time_format_iso8601(dt) instead.
 
 </description>
 <parameters>
diff --git a/glib/src/glib_functions.defs b/glib/src/glib_functions.defs
index daf056fb..1885ee08 100644
--- a/glib/src/glib_functions.defs
+++ b/glib/src/glib_functions.defs
@@ -4046,6 +4046,12 @@
   )
 )
 
+(define-method format_iso8601
+  (of-object "GDateTime")
+  (c-name "g_date_time_format_iso8601")
+  (return-type "gchar*")
+)
+
 
 
 ;; From gdir.h
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]