Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update GIR files (2024-12-08) #218

Merged
merged 1 commit into from
Dec 10, 2024
Merged

Update GIR files (2024-12-08) #218

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 33 additions & 6 deletions GLib-2.0.gir
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15101,13 +15101,16 @@ custom log handler functions behave similarly, so that logging calls in user
code do not need modifying to add a new-line character to the message if the
log handler is changed.

The `log_domain` parameter can be set to `NULL` or an empty string to use the default
application domain.

This is not used if structured logging is enabled; see
[Using Structured Logging](logging.html#using-structured-logging).</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="log_domain" transfer-ownership="none">
<parameter name="log_domain" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">the log domain of the message</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
Expand Down Expand Up @@ -30592,6 +30595,21 @@ If a thread can not be created (due to resource limits),
</parameter>
</parameters>
</constructor>
<method name="get_name" c:identifier="g_thread_get_name" version="2.84">
<doc xml:space="preserve">Gets the name of the thread.

This function is intended for debugging purposes.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">the name of the thread</doc>
<type name="utf8" c:type="const char*"/>
</return-value>
<parameters>
<instance-parameter name="thread" transfer-ownership="none">
<doc xml:space="preserve">a thread</doc>
<type name="Thread" c:type="GThread*"/>
</instance-parameter>
</parameters>
</method>
<method name="join" c:identifier="g_thread_join">
<doc xml:space="preserve">Waits until @thread finishes, i.e. the function @func, as
given to g_thread_new(), returns or g_thread_exit() is called.
Expand Down Expand Up @@ -49267,6 +49285,9 @@ you want to set a handler for this log level you must combine it with
This has no effect if structured logging is enabled; see
[Using Structured Logging](logging.html#using-structured-logging).

The `log_domain` parameter can be set to `NULL` or an empty string to use the default
application domain.

Here is an example for adding a log handler for all warning messages
in the default domain:

Expand Down Expand Up @@ -49294,7 +49315,7 @@ g_log_set_handler ("GLib", G_LOG_LEVEL_MASK | G_LOG_FLAG_FATAL
</return-value>
<parameters>
<parameter name="log_domain" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">the log domain, or `NULL` for the default `""`
<doc xml:space="preserve">the log domain
application domain</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
Expand All @@ -49319,14 +49340,17 @@ g_log_set_handler ("GLib", G_LOG_LEVEL_MASK | G_LOG_FLAG_FATAL
<doc xml:space="preserve">Like [[email protected]_set_handler], but takes a destroy notify for the @user_data.

This has no effect if structured logging is enabled; see
[Using Structured Logging](logging.html#using-structured-logging).</doc>
[Using Structured Logging](logging.html#using-structured-logging).

The `log_domain` parameter can be set to `NULL` or an empty string to use the default
application domain.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">the ID of the new handler</doc>
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
<parameter name="log_domain" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">the log domain, or `NULL` for the default `""`
<doc xml:space="preserve">the log domain
application domain</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
Expand Down Expand Up @@ -49946,13 +49970,16 @@ character will automatically be appended to @..., and need not be entered
manually.

If [structured logging is enabled](logging.html#using-structured-logging) this will
output via the structured log writer function (see [[email protected]_set_writer_func]).</doc>
output via the structured log writer function (see [[email protected]_set_writer_func]).

The `log_domain` parameter can be set to `NULL` or an empty string to use the default
application domain.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="log_domain" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">the log domain, or `NULL` for the default `""`
<doc xml:space="preserve">the log domain
application domain</doc>
<type name="utf8" c:type="const gchar*"/>
</parameter>
Expand Down
190 changes: 146 additions & 44 deletions GObject-2.0.gir
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14343,7 +14343,27 @@ without first having or creating a strong reference to the object.</doc>
<type name="gpointer" c:type="gpointer"/>
</field>
</union>
<method name="clear" c:identifier="g_weak_ref_clear" version="2.32" introspectable="0">
<method name="set" c:identifier="g_weak_ref_set" version="2.32" introspectable="0">
<doc xml:space="preserve">Change the object to which @weak_ref points, or set it to
%NULL.

You must own a strong reference on @object while calling this
function.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="weak_ref" transfer-ownership="none">
<doc xml:space="preserve">location for a weak reference</doc>
<type name="WeakRef" c:type="GWeakRef*"/>
</instance-parameter>
<parameter name="object" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #GObject or %NULL</doc>
<type name="Object" c:type="gpointer"/>
</parameter>
</parameters>
</method>
<function name="clear" c:identifier="g_weak_ref_clear" version="2.32" introspectable="0">
<doc xml:space="preserve">Frees resources associated with a non-statically-allocated #GWeakRef.
After this call, the #GWeakRef is left in an undefined state.

Expand All @@ -14353,14 +14373,14 @@ g_weak_ref_init() called on it.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="weak_ref" direction="inout" caller-allocates="0" transfer-ownership="full">
<parameter name="weak_ref" direction="inout" caller-allocates="0" transfer-ownership="full">
<doc xml:space="preserve">location of a weak reference, which
may be empty</doc>
<type name="WeakRef" c:type="GWeakRef*"/>
</instance-parameter>
</parameter>
</parameters>
</method>
<method name="get" c:identifier="g_weak_ref_get" version="2.32" introspectable="0">
</function>
<function name="get" c:identifier="g_weak_ref_get" version="2.32" introspectable="0">
<doc xml:space="preserve">If @weak_ref is not empty, atomically acquire a strong
reference to the object it points to, and return that reference.

Expand All @@ -14376,13 +14396,13 @@ by using g_object_unref().</doc>
<type name="Object" c:type="gpointer"/>
</return-value>
<parameters>
<instance-parameter name="weak_ref" direction="inout" caller-allocates="0" transfer-ownership="full">
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Checking if this is intentional

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

as we don't generate bindings of this, let us merge it already

<parameter name="weak_ref" direction="inout" caller-allocates="0" transfer-ownership="full">
<doc xml:space="preserve">location of a weak reference to a #GObject</doc>
<type name="WeakRef" c:type="GWeakRef*"/>
</instance-parameter>
</parameter>
</parameters>
</method>
<method name="init" c:identifier="g_weak_ref_init" version="2.32" introspectable="0">
</function>
<function name="init" c:identifier="g_weak_ref_init" version="2.32" introspectable="0">
<doc xml:space="preserve">Initialise a non-statically-allocated #GWeakRef.

This function also calls g_weak_ref_set() with @object on the
Expand All @@ -14396,37 +14416,17 @@ properly initialised. Just use g_weak_ref_set() directly.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="weak_ref" direction="inout" caller-allocates="0" transfer-ownership="full">
<parameter name="weak_ref" direction="inout" caller-allocates="0" transfer-ownership="full">
<doc xml:space="preserve">uninitialized or empty location for a weak
reference</doc>
<type name="WeakRef" c:type="GWeakRef*"/>
</instance-parameter>
<parameter name="object" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #GObject or %NULL</doc>
<type name="Object" c:type="gpointer"/>
</parameter>
</parameters>
</method>
<method name="set" c:identifier="g_weak_ref_set" version="2.32" introspectable="0">
<doc xml:space="preserve">Change the object to which @weak_ref points, or set it to
%NULL.

You must own a strong reference on @object while calling this
function.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<instance-parameter name="weak_ref" transfer-ownership="none">
<doc xml:space="preserve">location for a weak reference</doc>
<type name="WeakRef" c:type="GWeakRef*"/>
</instance-parameter>
<parameter name="object" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #GObject or %NULL</doc>
<type name="Object" c:type="gpointer"/>
</parameter>
</parameters>
</method>
</function>
</record>
<union name="_Value__data__union">
<field name="v_int" writable="1">
Expand Down Expand Up @@ -17048,8 +17048,13 @@ The handler will be called synchronously, before the default handler of the sign
See [memory management of signal handlers](signals.html#Memory_management_of_signal_handlers) for
details on how to handle the return value and memory management of @data.

This function cannot fail. If the given signal doesn&#x2019;t exist, a critical
warning is emitted.</doc>
This function cannot fail. If the given signal name doesn&#x2019;t exist,
a critical warning is emitted. No validation is performed on the
&#x2018;detail&#x2019; string when specified in @detailed_signal, other than a
non-empty check.

Refer to the [signals documentation](signals.html) for more
details.</doc>
<parameters>
<parameter name="instance">
<doc xml:space="preserve">the instance to connect to.</doc>
Expand All @@ -17070,8 +17075,13 @@ warning is emitted.</doc>

The handler will be called synchronously, after the default handler of the signal.

This function cannot fail. If the given signal doesn&#x2019;t exist, a critical
warning is emitted.</doc>
This function cannot fail. If the given signal name doesn&#x2019;t exist,
a critical warning is emitted. No validation is performed on the
&#x2018;detail&#x2019; string when specified in @detailed_signal, other than a
non-empty check.

Refer to the [signals documentation](signals.html) for more
details.</doc>
<parameters>
<parameter name="instance">
<doc xml:space="preserve">the instance to connect to.</doc>
Expand All @@ -17093,8 +17103,13 @@ warning is emitted.</doc>
If @closure is a floating reference (see g_closure_sink()), this function
takes ownership of @closure.

This function cannot fail. If the given signal doesn&#x2019;t exist, a critical
warning is emitted.</doc>
This function cannot fail. If the given signal name doesn&#x2019;t exist,
a critical warning is emitted. No validation is performed on the
&#x2018;detail&#x2019; string when specified in @detailed_signal, other than a
non-empty check.

Refer to the [signals documentation](signals.html) for more
details.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">the handler ID (always greater than 0)</doc>
<type name="gulong" c:type="gulong"/>
Expand Down Expand Up @@ -17125,8 +17140,13 @@ warning is emitted.</doc>
If @closure is a floating reference (see g_closure_sink()), this function
takes ownership of @closure.

This function cannot fail. If the given signal doesn&#x2019;t exist, a critical
warning is emitted.</doc>
This function cannot fail. If the given signal name doesn&#x2019;t exist,
a critical warning is emitted. No validation is performed on the
&#x2018;detail&#x2019; string when specified in @detailed_signal, other than a
non-empty check.

Refer to the [signals documentation](signals.html) for more
details.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">the handler ID (always greater than 0)</doc>
<type name="gulong" c:type="gulong"/>
Expand Down Expand Up @@ -17162,8 +17182,13 @@ which will be called when the signal handler is disconnected and no longer
used. Specify @connect_flags if you need `..._after()` or
`..._swapped()` variants of this function.

This function cannot fail. If the given signal doesn&#x2019;t exist, a critical
warning is emitted.</doc>
This function cannot fail. If the given signal name doesn&#x2019;t exist,
a critical warning is emitted. No validation is performed on the
&#x2018;detail&#x2019; string when specified in @detailed_signal, other than a
non-empty check.

Refer to the [signals documentation](signals.html) for more
details.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">the handler ID (always greater than 0)</doc>
<type name="gulong" c:type="gulong"/>
Expand Down Expand Up @@ -17203,7 +17228,15 @@ by temporarily adding a reference count to @gobject.
When the @gobject is destroyed the signal handler will be automatically
disconnected. Note that this is not currently threadsafe (ie:
emitting a signal while @gobject is being destroyed in another thread
is not safe).</doc>
is not safe).

This function cannot fail. If the given signal name doesn&#x2019;t exist,
a critical warning is emitted. No validation is performed on the
"detail" string when specified in @detailed_signal, other than a
non-empty check.

Refer to the [signals documentation](signals.html) for more
details.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">the handler id.</doc>
<type name="gulong" c:type="gulong"/>
Expand Down Expand Up @@ -17260,8 +17293,13 @@ g_signal_connect (button, "clicked",
(GCallback) button_clicked_cb, other_widget);
]|

This function cannot fail. If the given signal doesn&#x2019;t exist, a critical
warning is emitted.</doc>
This function cannot fail. If the given signal name doesn&#x2019;t exist,
a critical warning is emitted. No validation is performed on the
&#x2018;detail&#x2019; string when specified in @detailed_signal, other than a
non-empty check.

Refer to the [signals documentation](signals.html) for more
details.</doc>
<parameters>
<parameter name="instance">
<doc xml:space="preserve">the instance to connect to.</doc>
Expand Down Expand Up @@ -19568,5 +19606,69 @@ transformation function must be registered.</doc>
<type name="GType" c:type="GType"/>
</return-value>
</function>
<function name="weak_ref_clear" c:identifier="g_weak_ref_clear" moved-to="WeakRef.clear" version="2.32" introspectable="0">
<doc xml:space="preserve">Frees resources associated with a non-statically-allocated #GWeakRef.
After this call, the #GWeakRef is left in an undefined state.

You should only call this on a #GWeakRef that previously had
g_weak_ref_init() called on it.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="weak_ref" direction="inout" caller-allocates="0" transfer-ownership="full">
<doc xml:space="preserve">location of a weak reference, which
may be empty</doc>
<type name="WeakRef" c:type="GWeakRef*"/>
</parameter>
</parameters>
</function>
<function name="weak_ref_get" c:identifier="g_weak_ref_get" moved-to="WeakRef.get" version="2.32" introspectable="0">
<doc xml:space="preserve">If @weak_ref is not empty, atomically acquire a strong
reference to the object it points to, and return that reference.

This function is needed because of the potential race between taking
the pointer value and g_object_ref() on it, if the object was losing
its last reference at the same time in a different thread.

The caller should release the resulting reference in the usual way,
by using g_object_unref().</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">the object pointed to
by @weak_ref, or %NULL if it was empty</doc>
<type name="Object" c:type="gpointer"/>
</return-value>
<parameters>
<parameter name="weak_ref" direction="inout" caller-allocates="0" transfer-ownership="full">
<doc xml:space="preserve">location of a weak reference to a #GObject</doc>
<type name="WeakRef" c:type="GWeakRef*"/>
</parameter>
</parameters>
</function>
<function name="weak_ref_init" c:identifier="g_weak_ref_init" moved-to="WeakRef.init" version="2.32" introspectable="0">
<doc xml:space="preserve">Initialise a non-statically-allocated #GWeakRef.

This function also calls g_weak_ref_set() with @object on the
freshly-initialised weak reference.

This function should always be matched with a call to
g_weak_ref_clear(). It is not necessary to use this function for a
#GWeakRef in static storage because it will already be
properly initialised. Just use g_weak_ref_set() directly.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="weak_ref" direction="inout" caller-allocates="0" transfer-ownership="full">
<doc xml:space="preserve">uninitialized or empty location for a weak
reference</doc>
<type name="WeakRef" c:type="GWeakRef*"/>
</parameter>
<parameter name="object" transfer-ownership="none" nullable="1" allow-none="1">
<doc xml:space="preserve">a #GObject or %NULL</doc>
<type name="Object" c:type="gpointer"/>
</parameter>
</parameters>
</function>
</namespace>
</repository>
1 change: 1 addition & 0 deletions Gdk-4.0.gir
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1851,6 +1851,7 @@ is returned.</doc>
</function>
</record>
<record name="ContentFormatsBuilder" c:type="GdkContentFormatsBuilder" opaque="1" glib:type-name="GdkContentFormatsBuilder" glib:get-type="gdk_content_formats_builder_get_type" c:symbol-prefix="content_formats_builder">
<doc xml:space="preserve">Auxiliary object to create a `GdkContentFormats`.</doc>
<constructor name="new" c:identifier="gdk_content_formats_builder_new">
<doc xml:space="preserve">Create a new `GdkContentFormatsBuilder` object.

Expand Down
Loading