[glibmm] Glib, Gio: Regenerate docs.xml and .defs files
- From: Kjell Ahlstedt <kjellahl src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glibmm] Glib, Gio: Regenerate docs.xml and .defs files
- Date: Tue, 13 Aug 2019 18:12:05 +0000 (UTC)
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]