Skip to content

Commit

Permalink
Merge pull request #223 from gtk-rs/create-pull-request/patch
Browse files Browse the repository at this point in the history 
Update GIR files (2025-01-05)
  • Loading branch information
@sdroege
sdroege authored Jan 5, 2025
2 parents dd46770 + 896cfc4 commit 98d70b9
Show file tree
Hide file tree
Showing 5 changed files with 51 additions and 101 deletions.
2 changes: 1 addition & 1 deletion GLib-2.0.gir
View file
Original file line number Diff line number Diff line change
Expand Up @@ -18844,7 +18844,7 @@ This function is useful if you are trying to use #GOptionContext with
to the command line arguments (which must be in UTF-8 on Windows).
Starting with GLib 2.62, @arguments can be %NULL, which matches
g_option_context_parse().</doc>
<array zero-terminated="0" c:type="gchar***">
<array c:type="gchar***">
<type name="utf8" c:type="gchar**"/>
</array>
</parameter>
Expand Down
129 changes: 32 additions & 97 deletions GObject-2.0.gir
View file
Original file line number Diff line number Diff line change
Expand Up @@ -14345,27 +14345,7 @@ without first having or creating a strong reference to the object.</doc>
<type name="gpointer" c:type="gpointer"/>
</field>
</union>
<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">
<method 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 @@ -14375,14 +14355,14 @@ g_weak_ref_init() called on it.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="weak_ref" direction="inout" caller-allocates="0" transfer-ownership="full">
<instance-parameter name="weak_ref" transfer-ownership="none">
<doc xml:space="preserve">location of a weak reference, which
may be empty</doc>
<type name="WeakRef" c:type="GWeakRef*"/>
</parameter>
</instance-parameter>
</parameters>
</function>
<function name="get" c:identifier="g_weak_ref_get" version="2.32" introspectable="0">
</method>
<method 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 @@ -14398,13 +14378,13 @@ by using g_object_unref().</doc>
<type name="Object" c:type="gpointer"/>
</return-value>
<parameters>
<parameter name="weak_ref" direction="inout" caller-allocates="0" transfer-ownership="full">
<instance-parameter name="weak_ref" transfer-ownership="none">
<doc xml:space="preserve">location of a weak reference to a #GObject</doc>
<type name="WeakRef" c:type="GWeakRef*"/>
</parameter>
</instance-parameter>
</parameters>
</function>
<function name="init" c:identifier="g_weak_ref_init" version="2.32" introspectable="0">
</method>
<method 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 @@ -14418,17 +14398,36 @@ properly initialised. Just use g_weak_ref_set() directly.</doc>
<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>
<instance-parameter name="weak_ref" transfer-ownership="none">
<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>
</function>
</method>
</record>
<union name="_Value__data__union">
<field name="v_int" writable="1">
Expand Down Expand Up @@ -19608,69 +19607,5 @@ 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 Gio-2.0.gir
View file
Original file line number Diff line number Diff line change
Expand Up @@ -43510,6 +43510,7 @@ closed.</doc>
</parameters>
</method>
<property name="base-stream" writable="1" construct-only="1" transfer-ownership="none" getter="get_base_stream">
<doc xml:space="preserve">The underlying base stream on which the I/O ops will be done.</doc>
<type name="OutputStream"/>
</property>
<property name="close-base-stream" writable="1" construct-only="1" transfer-ownership="none" getter="get_close_base_stream" default-value="TRUE">
Expand Down
6 changes: 3 additions & 3 deletions Gtk-4.0.gir
View file
Original file line number Diff line number Diff line change
Expand Up @@ -81561,7 +81561,7 @@ If you need to add a shortcut programmatically, use
<implements name="Buildable"/>
<implements name="ConstraintTarget"/>
<implements name="Orientable"/>
<method name="add_shortcut" c:identifier="gtk_shortcuts_group_add_shortcut" version="4.14">
<method name="add_shortcut" c:identifier="gtk_shortcuts_group_add_shortcut" version="4.14" deprecated="1" deprecated-version="4.18">
<doc xml:space="preserve">Adds a shortcut to the shortcuts group.

This is the programmatic equivalent to using [[email protected]] and a
Expand Down Expand Up @@ -81649,7 +81649,7 @@ The following signals have default keybindings:
<implements name="Buildable"/>
<implements name="ConstraintTarget"/>
<implements name="Orientable"/>
<method name="add_group" c:identifier="gtk_shortcuts_section_add_group" version="4.14">
<method name="add_group" c:identifier="gtk_shortcuts_section_add_group" version="4.14" deprecated="1" deprecated-version="4.18">
<doc xml:space="preserve">Adds a group to the shortcuts section.

This is the programmatic equivalent to using [[email protected]] and a
Expand Down Expand Up @@ -81893,7 +81893,7 @@ class `.shortcuts`.</doc>
<implements name="Native"/>
<implements name="Root"/>
<implements name="ShortcutManager"/>
<method name="add_section" c:identifier="gtk_shortcuts_window_add_section" version="4.14">
<method name="add_section" c:identifier="gtk_shortcuts_window_add_section" version="4.14" deprecated="1" deprecated-version="4.18">
<doc xml:space="preserve">Adds a section to the shortcuts window.

This is the programmatic equivalent to using [[email protected]] and a
Expand Down
14 changes: 14 additions & 0 deletions Pango-1.0.gir
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8010,6 +8010,20 @@ ellipsized.</doc>
</instance-parameter>
</parameters>
</method>
<method name="is_truncated" c:identifier="pango_layout_is_truncated" version="1.56">
<doc xml:space="preserve">Queries whether the layout does not show all content because of
height limitations.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">true if any paragraphs have been omitted due to height</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<instance-parameter name="layout" transfer-ownership="none">
<doc xml:space="preserve">a `PangoLayout`</doc>
<type name="Layout" c:type="PangoLayout*"/>
</instance-parameter>
</parameters>
</method>
<method name="is_wrapped" c:identifier="pango_layout_is_wrapped" version="1.16">
<doc xml:space="preserve">Queries whether the layout had to wrap any paragraphs.

Expand Down

0 comments on commit 98d70b9

Please sign in to comment.