[gtkmm] Regenerate [gdk|gtk]_docs.xml
- From: Kjell Ahlstedt <kjellahl src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtkmm] Regenerate [gdk|gtk]_docs.xml
- Date: Fri, 4 Jun 2021 17:20:29 +0000 (UTC)
commit 66b940066f6266169f94c2b6baf2de0dc5c233a6
Author: Kjell Ahlstedt <kjellahlstedt gmail com>
Date: Fri Jun 4 19:16:53 2021 +0200
Regenerate [gdk|gtk]_docs.xml
and update [gdk|gtk]_docs_override.xml.
gdk/src/gdk_docs.xml | 686 ++----
gdk/src/gdk_docs_override.xml | 11 +-
gtk/src/gtk_docs.xml | 5016 +++++++++++++++++++++--------------------
gtk/src/gtk_docs_override.xml | 12 +-
4 files changed, 2745 insertions(+), 2980 deletions(-)
---
diff --git a/gdk/src/gdk_docs.xml b/gdk/src/gdk_docs.xml
index 113c5e11..657d8767 100644
--- a/gdk/src/gdk_docs.xml
+++ b/gdk/src/gdk_docs.xml
@@ -413,7 +413,7 @@ This is only relevant for keyboard devices.
<property name="GdkDevice:display">
<description>
-The #GdkDisplay the #GdkDevice pertains to.
+The `GdkDisplay` the `GdkDevice` pertains to.
</description>
</property>
@@ -1302,7 +1302,7 @@ Error enumeration for `GdkGLContext`.
<enum name="GdkGravity">
<description>
-Defines the reference point of a surface and is used in #GdkPopupLayout.
+Defines the reference point of a surface and is used in `GdkPopupLayout`.
</description>
<parameters>
@@ -1522,8 +1522,8 @@ byte each of red, green and blue. It is not endian-dependent, so
CAIRO_FORMAT_ARGB32 is represented by different `GdkMemoryFormats`
on architectures with different endiannesses.
-Its naming is modelled after VkFormat (see
-https://www.khronos.org/registry/vulkan/specs/1.0/html/vkspec.html#VkFormat
+Its naming is modelled after
+[VkFormat](https://www.khronos.org/registry/vulkan/specs/1.0/html/vkspec.html#VkFormat)
for details).
</description>
@@ -2354,7 +2354,7 @@ Emitted whenever a new tool is made known to the seat.
The tool may later be assigned to a device (i.e. on
proximity with a tablet). The device will emit the
-[signalGdkDevice::tool-changed] signal accordingly.
+[signal@Gdk.Device::tool-changed] signal accordingly.
A same tool may be used by several devices.
@@ -2936,7 +2936,7 @@ for example in response to a change of the surface size.
<enum name="GdkVulkanError">
<description>
-Error enumeration for #GdkVulkanContext.
+Error enumeration for `GdkVulkanContext`.
</description>
<parameters>
@@ -3011,7 +3011,7 @@ See also [method@Gdk.AppLaunchContext.set_icon_name].
</parameter_description>
</parameter>
<parameter name="icon">
-<parameter_description> a #GIcon, or %NULL
+<parameter_description> a `GIcon`
</parameter_description>
</parameter>
</parameters>
@@ -3023,7 +3023,7 @@ See also [method@Gdk.AppLaunchContext.set_icon_name].
Sets the icon for applications that are launched with this context.
The @icon_name will be interpreted in the same way as the Icon field
-in desktop files. See also [method@Gdk.AppLaunchContext.set_icon()].
+in desktop files. See also [method@Gdk.AppLaunchContext.set_icon].
If both @icon and @icon_name are set, the @icon_name takes priority.
If neither @icon or @icon_name is set, the icon is taken from either
@@ -3037,7 +3037,7 @@ for the launched application itself.
</parameter_description>
</parameter>
<parameter name="icon_name">
-<parameter_description> an icon name, or %NULL
+<parameter_description> an icon name
</parameter_description>
</parameter>
</parameters>
@@ -3101,13 +3101,12 @@ The returned context is guaranteed to be valid until
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GdkCairoContext that is currently drawing
+<parameter_description> a `GdkCairoContext` that is currently drawing
</parameter_description>
</parameter>
</parameters>
-<return> a Cairo context to be used
-to draw the contents of the `GdkSurface`. %NULL is returned
-when @context is not drawing.
+<return> a Cairo context
+to draw on `GdkSurface
</return>
</function>
@@ -3115,8 +3114,8 @@ when @context is not drawing.
<description>
The main way to draw GL content in GTK.
-It takes a render buffer ID (@source_type == #GL_RENDERBUFFER) or a texture
-id (@source_type == #GL_TEXTURE) and draws it onto @cr with an OVER operation,
+It takes a render buffer ID (@source_type == GL_RENDERBUFFER) or a texture
+id (@source_type == GL_TEXTURE) and draws it onto @cr with an OVER operation,
respecting the current clip. The top left corner of the rectangle specified
by @x, @y, @width and @height will be drawn at the current (0,0) position of
the `cairo_t`.
@@ -3127,8 +3126,8 @@ used in the general case. In the case of direct drawing to a surface with
no special effects applied to @cr it will however use a more efficient
approach.
-For #GL_RENDERBUFFER the code will always fall back to software for buffers
-with alpha components, so make sure you use #GL_TEXTURE if using alpha.
+For GL_RENDERBUFFER the code will always fall back to software for buffers
+with alpha components, so make sure you use GL_TEXTURE if using alpha.
Calling this may change the current GL context.
@@ -3185,7 +3184,7 @@ Adds the given rectangle to the current path of @cr.
</parameter_description>
</parameter>
<parameter name="rectangle">
-<parameter_description> a #GdkRectangle
+<parameter_description> a `GdkRectangle`
</parameter_description>
</parameter>
</parameters>
@@ -3203,7 +3202,7 @@ Adds the given region to the current path of @cr.
</parameter_description>
</parameter>
<parameter name="region">
-<parameter_description> a #cairo_region_t
+<parameter_description> a `cairo_region_t`
</parameter_description>
</parameter>
</parameters>
@@ -3226,7 +3225,7 @@ set with cairo_surface_set_device_offset().
</parameter_description>
</parameter>
</parameters>
-<return> A `cairo_region_t`; must be freed with cairo_region_destroy()
+<return> A `cairo_region_t`
</return>
</function>
@@ -3244,7 +3243,7 @@ so that the origin of @pixbuf is @pixbuf_x, @pixbuf_y.
</parameter_description>
</parameter>
<parameter name="pixbuf">
-<parameter_description> a #GdkPixbuf
+<parameter_description> a `GdkPixbuf`
</parameter_description>
</parameter>
<parameter name="pixbuf_x">
@@ -3261,7 +3260,7 @@ so that the origin of @pixbuf is @pixbuf_x, @pixbuf_y.
<function name="gdk_cairo_set_source_rgba">
<description>
-Sets the specified #GdkRGBA as the source color of @cr.
+Sets the specified `GdkRGBA` as the source color of @cr.
</description>
<parameters>
@@ -3270,7 +3269,7 @@ Sets the specified #GdkRGBA as the source color of @cr.
</parameter_description>
</parameter>
<parameter name="rgba">
-<parameter_description> a #GdkRGBA
+<parameter_description> a `GdkRGBA`
</parameter_description>
</parameter>
</parameters>
@@ -3292,8 +3291,8 @@ current process, %NULL will be returned.
</parameter_description>
</parameter>
</parameters>
-<return> The content of a clipboard or %NULL
-if the clipboard does not maintain any content.
+<return> The content of a clipboard
+if the clipboard does not maintain any content
</return>
</function>
@@ -3377,7 +3376,7 @@ to fulfill the request, preferring the ones listed first.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional `GCancellable` object, %NULL to ignore.
+<parameter_description> optional `GCancellable` object
</parameter_description>
</parameter>
<parameter name="callback">
@@ -3410,16 +3409,16 @@ See [method@Gdk.Clipboard.read_async].
</parameter_description>
</parameter>
<parameter name="out_mime_type">
-<parameter_description> pointer to store
-the chosen mime type in or %NULL
+<parameter_description> location to store
+the chosen mime type
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a `GError` location to store the error occurring, or %NULL to ignore.
+<parameter_description> a `GError` location to store the error occurring
</parameter_description>
</parameter>
</parameters>
-<return> a `GInputStream` or %NULL on error.
+<return> a `GInputStream`
</return>
</function>
@@ -3441,7 +3440,7 @@ need more control over the operation.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional `GCancellable` object, %NULL to ignore
+<parameter_description> optional `GCancellable` object
</parameter_description>
</parameter>
<parameter name="callback">
@@ -3474,11 +3473,11 @@ See [method@Gdk.Clipboard.read_text_async].
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a `GError` location to store the error occurring, or %NULL to ignore
+<parameter_description> a `GError` location to store the error occurring
</parameter_description>
</parameter>
</parameters>
-<return> a new string or %NULL on error
+<return> a new string
</return>
</function>
@@ -3490,7 +3489,7 @@ When the operation is finished @callback will be called. You must then
call [method@Gdk.Clipboard.read_texture_finish] to get the result.
This is a simple wrapper around [method@Gdk.Clipboard.read_value_async].
-Use that function or [methos@Gdk.Clipboard.read_async] directly if you
+Use that function or [method@Gdk.Clipboard.read_async] directly if you
need more control over the operation.
</description>
@@ -3533,11 +3532,11 @@ See [method@Gdk.Clipboard.read_texture_async].
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a `GError` location to store the error occurring, or %NULL to ignore
+<parameter_description> a `GError` location to store the error occurring
</parameter_description>
</parameter>
</parameters>
-<return> a new `GdkTexture` or %NULL on error
+<return> a new `GdkTexture`
</return>
</function>
@@ -3568,7 +3567,7 @@ the value will be copied directly. Otherwise, GDK will try to use
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object, %NULL to ignore.
+<parameter_description> optional `GCancellable` object
</parameter_description>
</parameter>
<parameter name="callback">
@@ -3601,7 +3600,7 @@ See [method@Gdk.Clipboard.read_value_async].
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a GError` location to store the error occurring, or %NULL to ignore
+<parameter_description> a GError` location to store the error occurring
</parameter_description>
</parameter>
</parameters>
@@ -3658,8 +3657,8 @@ transfer the contents and then request that format from @provider.
</parameter_description>
</parameter>
<parameter name="provider">
-<parameter_description> the new contents of @clipboard or
-%NULL to clear the clipboard
+<parameter_description> the new contents of @clipboard
+or %NULL to clear the clipboard
</parameter_description>
</parameter>
</parameters>
@@ -3766,11 +3765,11 @@ shut down, so you likely don't need to call it.
</parameter_description>
</parameter>
<parameter name="io_priority">
-<parameter_description> the I/O priority of the request.
+<parameter_description> the I/O priority of the request
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional `GCancellable` object, %NULL to ignore.
+<parameter_description> optional `GCancellable` object
</parameter_description>
</parameter>
<parameter name="callback">
@@ -3803,7 +3802,7 @@ See [method@Gdk.Clipboard.store_async].
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a `GError` location to store the error occurring, or %NULL to ignore.
+<parameter_description> a `GError` location to store the error occurring
</parameter_description>
</parameter>
</parameters>
@@ -3819,7 +3818,7 @@ The default I/O priority is %G_PRIORITY_DEFAULT (i.e. 0), and lower numbers
indicate a higher priority.
When the operation is finished, @callback will be called. You must then
-call [func@content_deserialize_finish] to get the result of the operation.
+call [func@Gdk.content_deserialize_finish] to get the result of the operation.
</description>
<parameters>
@@ -3885,7 +3884,7 @@ Finishes a content deserialization operation.
<description>
Gets the cancellable for the current operation.
-This is the `GCancellable` that was passed to [func@content_deserialize_async].
+This is the `GCancellable` that was passed to [func@Gdk.content_deserialize_async].
</description>
@@ -3901,7 +3900,7 @@ This is the `GCancellable` that was passed to [func@content_deserialize_async].
<function name="gdk_content_deserializer_get_gtype">
<description>
-Gets the GType to create an instance of.
+Gets the `GType` to create an instance of.
</description>
@@ -3911,7 +3910,7 @@ Gets the GType to create an instance of.
</parameter_description>
</parameter>
</parameters>
-<return> the GType for the current operation
+<return> the `GType` for the current operation
</return>
</function>
@@ -3919,7 +3918,7 @@ Gets the GType to create an instance of.
<description>
Gets the input stream for the current operation.
-This is the stream that was passed to [func@content_deserialize_async].
+This is the stream that was passed to [func@Gdk.content_deserialize_async].
</description>
@@ -3953,7 +3952,7 @@ Gets the mime type to deserialize from.
<description>
Gets the I/O priority for the current operation.
-This is the priority that was passed to [funccontent_deserialize_async].
+This is the priority that was passed to [func@Gdk.content_deserialize_async].
</description>
@@ -4234,7 +4233,7 @@ Checks if a given `GType` is part of the given @formats.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the #GType was found
+<return> %TRUE if the `GType` was found
</return>
</function>
@@ -4260,9 +4259,9 @@ Checks if a given mime type is part of the given @formats.
<function name="gdk_content_formats_get_gtypes">
<description>
-Gets the `GTypes` included in @formats.
+Gets the `GType`s included in @formats.
-Note that @formats may not contain any #GTypes, in particular when
+Note that @formats may not contain any `GType`s, in particular when
they are empty. In that case %NULL will be returned.
@@ -4274,13 +4273,12 @@ they are empty. In that case %NULL will be returned.
</parameter>
<parameter name="n_gtypes">
<parameter_description> optional pointer to take the
-number of #GTypes contained in the return value
+number of `GType`s contained in the return value
</parameter_description>
</parameter>
</parameters>
<return>
-%G_TYPE_INVALID-terminated array of types included in @formats or
-%NULL if none.
+%G_TYPE_INVALID-terminated array of types included in @formats
</return>
</function>
@@ -4304,9 +4302,9 @@ number of mime types contained in the return value
</parameter_description>
</parameter>
</parameters>
-<return> %NULL-terminated array of
-interned strings of mime types included in @formats or %NULL
-if none.
+<return>
+%NULL-terminated array of interned strings of mime types included
+in @formats
</return>
</function>
@@ -4372,7 +4370,7 @@ If no matching mime type is found, %NULL is returned.
</parameter_description>
</parameter>
</parameters>
-<return> The first common mime type or %NULL if none.
+<return> The first common mime type or %NULL if none
</return>
</function>
@@ -4382,7 +4380,7 @@ Creates a new `GdkContentFormats` from an array of mime types.
The mime types must be valid and different from each other or the
behavior of the return value is undefined. If you cannot guarantee
-this, use `GdkContentFormatsBuilder` instead.
+this, use [struct@Gdk.ContentFormatsBuilder] instead.
</description>
@@ -4602,7 +4600,7 @@ The @value will have been initialized to the `GType` the value should be
provided in. This given `GType` does not need to be listed in the formats
returned by [method@Gdk.ContentProvider.ref_formats]. However, if the
given `GType` is not supported, this operation can fail and
-#G_IO_ERROR_NOT_SUPPORTED will be reported.
+`G_IO_ERROR_NOT_SUPPORTED` will be reported.
</description>
@@ -4616,7 +4614,7 @@ given `GType` is not supported, this operation can fail and
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a `GError` location to store the error occurring, or %NULL to ignore
+<parameter_description> a `GError` location to store the error occurring
</parameter_description>
</parameter>
</parameters>
@@ -4709,7 +4707,7 @@ gdk_content_provider_new_typed (G_TYPE_TEXTURE, texture)
<parameters>
<parameter name="providers">
<parameter_description>
-The #GdkContentProviders to present the union of
+The `GdkContentProvider`s to present the union of
</parameter_description>
</parameter>
<parameter name="n_providers">
@@ -4729,7 +4727,7 @@ Gets the formats that the provider can provide its current contents in.
</description>
<parameters>
<parameter name="provider">
-<parameter_description> a #GdkContentProvider
+<parameter_description> a `GdkContentProvider`
</parameter_description>
</parameter>
</parameters>
@@ -4750,7 +4748,7 @@ This can be assumed to be a subset of [method@Gdk.ContentProvider.ref_formats].
</description>
<parameters>
<parameter name="provider">
-<parameter_description> a #GdkContentProvider
+<parameter_description> a `GdkContentProvider`
</parameter_description>
</parameter>
</parameters>
@@ -4769,7 +4767,7 @@ of the operation.
The given mime type does not need to be listed in the formats returned by
[method@Gdk.ContentProvider.ref_formats]. However, if the given `GType` is
-not supported, #G_IO_ERROR_NOT_SUPPORTED will be reported.
+not supported, `G_IO_ERROR_NOT_SUPPORTED` will be reported.
The given @stream will not be closed.
@@ -4825,7 +4823,7 @@ See [method@Gdk.ContentProvider.write_mime_type_async].
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a `GError` location to store the error occurring, or %NULL to ignore
+<parameter_description> a `GError` location to store the error occurring
</parameter_description>
</parameter>
</parameters>
@@ -4902,7 +4900,7 @@ The default I/O priority is %G_PRIORITY_DEFAULT (i.e. 0), and lower numbers
indicate a higher priority.
When the operation is finished, @callback will be called. You must then
-call [func@content_serialize_finish] to get the result of the operation.
+call [func@Gdk.content_serialize_finish] to get the result of the operation.
</description>
<parameters>
@@ -4923,7 +4921,7 @@ call [func@content_serialize_finish] to get the result of the operation.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional #GCancellable object
+<parameter_description> optional `GCancellable` object
</parameter_description>
</parameter>
<parameter name="callback">
@@ -4963,7 +4961,7 @@ error occurred. In this case, @error is set
<description>
Gets the cancellable for the current operation.
-This is the `GCancellable` that was passed to [content_serialize_async].
+This is the `GCancellable` that was passed to [func@content_serialize_async].
</description>
@@ -5218,7 +5216,7 @@ it is used on does not support textured cursors.
</parameter>
</parameters>
<return> the fallback of the cursor or %NULL
-to use the default cursor as fallback.
+to use the default cursor as fallback
</return>
</function>
@@ -5295,7 +5293,7 @@ If the cursor is a named cursor, %NULL will be returned.
</description>
<parameters>
<parameter name="cursor">
-<parameter_description> a #GdkCursor.
+<parameter_description> a `GdkCursor`
</parameter_description>
</parameter>
</parameters>
@@ -5421,7 +5419,7 @@ Retrieves the current tool for @device.
</parameter_description>
</parameter>
</parameters>
-<return> the `GdkDeviceTool`, or %NULL
+<return> the `GdkDeviceTool`
</return>
</function>
@@ -5566,7 +5564,7 @@ See [method@Gdk.Device.get_vendor_id] for more information.
</parameter_description>
</parameter>
</parameters>
-<return> the product ID, or %NULL
+<return> the product ID
</return>
</function>
@@ -5596,7 +5594,7 @@ Returns the `GdkSeat` the device belongs to.
</description>
<parameters>
<parameter name="device">
-<parameter_description> A #GdkDevice
+<parameter_description> A `GdkDevice`
</parameter_description>
</parameter>
</parameters>
@@ -5623,7 +5621,7 @@ Determines the type of the device.
<function name="gdk_device_get_surface_at_position">
<description>
Obtains the surface underneath @device, returning the location of the
-device in @win_x and @win_y
+device in @win_x and @win_y.
</description>
@@ -5633,18 +5631,18 @@ device in @win_x and @win_y
</parameter_description>
</parameter>
<parameter name="win_x">
-<parameter_description> return location for the X coordinate of the device location,
-relative to the surface origin, or %NULL.
+<parameter_description> return location for the X coordinate
+of the device location relative to the surface origin
</parameter_description>
</parameter>
<parameter name="win_y">
-<parameter_description> return location for the Y coordinate of the device location,
-relative to the surface origin, or %NULL.
+<parameter_description> return location for the Y coordinate
+of the device location relative to the surface origin
</parameter_description>
</parameter>
</parameters>
<return> the `GdkSurface` under the
-device position, or %NULL
+device position
</return>
</function>
@@ -5709,7 +5707,7 @@ return settings;
</parameter_description>
</parameter>
</parameters>
-<return> the vendor ID, or %NULL
+<return> the vendor ID
</return>
</function>
@@ -5728,8 +5726,7 @@ This is only relevant for keyboard devices.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if there are layouts with both directions,
-%FALSE otherwise
+<return> %TRUE if there are layouts with both directions, %FALSE otherwise
</return>
</function>
@@ -5984,8 +5981,7 @@ applications on the given display.
</parameter_description>
</parameter>
</parameters>
-<return> a new `GdkAppLaunchContext` for @display.
-Free with g_object_unref() when done
+<return> a new `GdkAppLaunchContext` for @display
</return>
</function>
@@ -6040,22 +6036,6 @@ this function will return %NULL.
</return>
</function>
-<function name="gdk_display_get_keymap">
-<description>
-Returns the #GdkKeymap attached to @display.
-
-
-</description>
-<parameters>
-<parameter name="display">
-<parameter_description> the `GdkDisplay`
-</parameter_description>
-</parameter>
-</parameters>
-<return> the #GdkKeymap attached to @display.
-</return>
-</function>
-
<function name="gdk_display_get_monitor_at_surface">
<description>
Gets the monitor in which the largest area of @surface
@@ -6096,7 +6076,7 @@ this list to monitor changes to the monitor of this display.
</parameter_description>
</parameter>
</parameters>
-<return> a #GListModel of `GdkMonitor`
+<return> a `GListModel` of `GdkMonitor`
</return>
</function>
@@ -6175,7 +6155,7 @@ if no ID has been defined.
</parameter_description>
</parameter>
</parameters>
-<return> the startup notification ID for @display, or %NULL
+<return> the startup notification ID for @display
</return>
</function>
@@ -6298,8 +6278,7 @@ Gets the default `GdkDisplay`.
</parameter_description>
</parameter>
</parameters>
-<return> a `GdkDisplay`, or %NULL if
-there is no default display.
+<return> a `GdkDisplay`
</return>
</function>
@@ -6316,8 +6295,7 @@ List all currently open displays.
</parameter>
</parameters>
<return> a newly
-allocated `GSList` of `GdkDisplay` objects. Free with g_slist_free()
-when you are done with it.
+allocated `GSList` of `GdkDisplay` objects
</return>
</function>
@@ -6385,12 +6363,12 @@ Free the returned arrays with g_free().
</parameter>
<parameter name="keys">
<parameter_description> return
-location for array of `GdkKeymapKey`, or %NULL
+location for array of `GdkKeymapKey`
</parameter_description>
</parameter>
<parameter name="keyvals">
<parameter_description> return
-location for array of keyvals, or %NULL
+location for array of keyvals
</parameter_description>
</parameter>
<parameter name="n_entries">
@@ -6474,6 +6452,8 @@ notification process should be completed
<description>
Opens a display.
+If opening the display fails, `NULL` is returned.
+
</description>
<parameters>
@@ -6482,8 +6462,7 @@ Opens a display.
</parameter_description>
</parameter>
</parameters>
-<return> a `GdkDisplay`, or %NULL if the
-display could not be opened
+<return> a `GdkDisplay`
</return>
</function>
@@ -6595,21 +6574,20 @@ virtualized test environments.
</parameter_description>
</parameter>
<parameter name="keyval">
-<parameter_description> return location for keyval, or %NULL
+<parameter_description> return location for keyval
</parameter_description>
</parameter>
<parameter name="effective_group">
-<parameter_description> return location for effective
-group, or %NULL
+<parameter_description> return location for effective group
</parameter_description>
</parameter>
<parameter name="level">
-<parameter_description> return location for level, or %NULL
+<parameter_description> return location for level
</parameter_description>
</parameter>
<parameter name="consumed">
-<parameter_description> return location for modifiers
-that were used to determine the group or level, or %NULL
+<parameter_description> return location for modifiers that were used
+to determine the group or level
</parameter_description>
</parameter>
</parameters>
@@ -6698,8 +6676,7 @@ the source if [method Gdk Drag.get_selected_action] returns
</parameter_description>
</parameter>
</parameters>
-<return> a newly created [class Gdk Drag]
-or %NULL on error
+<return> a newly created `GdkDrag`
</return>
</function>
@@ -6813,7 +6790,7 @@ when the drag operation is over.
</parameter_description>
</parameter>
</parameters>
-<return> the drag surface, or %NULL
+<return> the drag surface
</return>
</function>
@@ -6933,7 +6910,7 @@ on screen.
Note that the @region passed to this function is the minimum region that
needs to be drawn and depending on implementation, windowing system and
hardware in use, it might be necessary to draw a larger region. Drawing
-implementation must use [method@Gdk.DrawContext.get_frame_region() to
+implementation must use [method@Gdk.DrawContext.get_frame_region] to
query the region that must be drawn.
When using GTK, the widget system automatically places calls to
@@ -6988,7 +6965,7 @@ Retrieves the `GdkDisplay` the @context is created for
</parameter_description>
</parameter>
</parameters>
-<return> a `GdkDisplay` or %NULL
+<return> the `GdkDisplay`
</return>
</function>
@@ -7007,12 +6984,11 @@ and [method@Gdk.DrawContext.end_frame], %NULL will be returned.
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GdkDrawContext
+<parameter_description> a `GdkDrawContext`
</parameter_description>
</parameter>
</parameters>
-<return> a Cairo region or %NULL if not drawing
-a frame.
+<return> a Cairo region
</return>
</function>
@@ -7028,7 +7004,7 @@ Retrieves the surface that @context is bound to.
</parameter_description>
</parameter>
</parameters>
-<return> a #GdkSurface or %NULL
+<return> a `GdkSurface`
</return>
</function>
@@ -7208,8 +7184,7 @@ pointer to an array of mime types
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> optional `GCancellable` object,
-%NULL to ignore
+<parameter_description> optional `GCancellable` object
</parameter_description>
</parameter>
<parameter name="callback">
@@ -7252,11 +7227,11 @@ See [method Gdk Drop.read_async].
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store error information on failure, or %NULL
+<parameter_description> location to store error information on failure
</parameter_description>
</parameter>
</parameters>
-<return> the `GInputStream`, or %NULL
+<return> the `GInputStream`
</return>
</function>
@@ -7321,7 +7296,7 @@ See [method Gdk Drop.read_value_async].
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a `GError` location to store the error occurring, or %NULL to ignore
+<parameter_description> a `GError` location to store the error occurring
</parameter_description>
</parameter>
</parameters>
@@ -7426,7 +7401,7 @@ Returns the device of an event.
</parameter_description>
</parameter>
</parameters>
-<return> a #GdkDevice.
+<return> a `GdkDevice`
</return>
</function>
@@ -7451,7 +7426,7 @@ persistently across runs, see [method@Gdk.DeviceTool.get_serial].
</parameter_description>
</parameter>
</parameters>
-<return> The current device tool, or %NULL
+<return> The current device tool
</return>
</function>
@@ -7467,7 +7442,7 @@ Retrieves the display associated to the @event.
</parameter_description>
</parameter>
</parameters>
-<return> a #GdkDisplay
+<return> a `GdkDisplay`
</return>
</function>
@@ -7602,7 +7577,7 @@ Returns the seat that originated the event.
</parameter_description>
</parameter>
</parameters>
-<return> a #GdkSeat.
+<return> a `GdkSeat`.
</return>
</function>
@@ -7618,7 +7593,7 @@ Extracts the surface associated with an event.
</parameter_description>
</parameter>
</parameters>
-<return> The #GdkSurface associated with the event
+<return> The `GdkSurface` associated with the event
</return>
</function>
@@ -8221,7 +8196,7 @@ Retrieves the current `GdkGLContext`.
</description>
<parameters>
</parameters>
-<return> the current `GdkGLContext`, or %NULL
+<return> the current `GdkGLContext`
</return>
</function>
@@ -8255,7 +8230,7 @@ Retrieves the display the @context is created for
</parameter_description>
</parameter>
</parameters>
-<return> a `GdkDisplay` or %NULL
+<return> a `GdkDisplay`
</return>
</function>
@@ -8313,7 +8288,7 @@ Retrieves the `GdkGLContext` that this @context share data with.
</parameter_description>
</parameter>
</parameters>
-<return> a `GdkGLContext` or %NULL
+<return> a `GdkGLContext`
</return>
</function>
@@ -8329,7 +8304,7 @@ Retrieves the surface used by the @context.
</parameter_description>
</parameter>
</parameters>
-<return> a `GdkSurface` or %NULL
+<return> a `GdkSurface`
</return>
</function>
@@ -8654,8 +8629,8 @@ See RFC 2048 for the syntax if mime types.
</parameter_description>
</parameter>
</parameters>
-<return> An interned string for the canonicalized mime type
-or %NULL if the string wasn't a valid mime type
+<return> An interned string for the canonicalized
+mime type or %NULL if the string wasn't a valid mime type
</return>
</function>
@@ -8813,326 +8788,11 @@ Note that we ignore Caps Lock for matching.
</return>
</function>
-<function name="gdk_keymap_get_caps_lock_state">
-<description>
-Returns whether the Caps Lock modifier is locked.
-
-
-</description>
-<parameters>
-<parameter name="keymap">
-<parameter_description> a #GdkKeymap
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if Caps Lock is on
-</return>
-</function>
-
-<function name="gdk_keymap_get_direction">
-<description>
-Returns the direction of effective layout of the keymap.
-
-The direction of a layout is the direction of the majority of its
-symbols. See pango_unichar_direction().
-
-
-</description>
-<parameters>
-<parameter name="keymap">
-<parameter_description> a #GdkKeymap
-</parameter_description>
-</parameter>
-</parameters>
-<return> %PANGO_DIRECTION_LTR or %PANGO_DIRECTION_RTL
-if it can determine the direction. %PANGO_DIRECTION_NEUTRAL
-otherwise.
-</return>
-</function>
-
-<function name="gdk_keymap_get_display">
-<description>
-Retrieves the #GdkDisplay associated to the @keymap.
-
-
-</description>
-<parameters>
-<parameter name="keymap">
-<parameter_description> a #GdkKeymap
-</parameter_description>
-</parameter>
-</parameters>
-<return> a #GdkDisplay
-</return>
-</function>
-
-<function name="gdk_keymap_get_entries_for_keycode">
-<description>
-Returns the keyvals bound to @hardware_keycode.
-The Nth #GdkKeymapKey in @keys is bound to the Nth
-keyval in @keyvals. Free the returned arrays with g_free().
-When a keycode is pressed by the user, the keyval from
-this list of entries is selected by considering the effective
-keyboard group and level. See gdk_keymap_translate_keyboard_state().
-
-
-</description>
-<parameters>
-<parameter name="keymap">
-<parameter_description> a #GdkKeymap
-</parameter_description>
-</parameter>
-<parameter name="hardware_keycode">
-<parameter_description> a keycode
-</parameter_description>
-</parameter>
-<parameter name="keys">
-<parameter_description> return
-location for array of #GdkKeymapKey, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="keyvals">
-<parameter_description> return
-location for array of keyvals, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="n_entries">
-<parameter_description> length of @keys and @keyvals
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if there were any entries
-</return>
-</function>
-
-<function name="gdk_keymap_get_entries_for_keyval">
-<description>
-Obtains a list of keycode/group/level combinations that will
-generate @keyval. Groups and levels are two kinds of keyboard mode;
-in general, the level determines whether the top or bottom symbol
-on a key is used, and the group determines whether the left or
-right symbol is used. On US keyboards, the shift key changes the
-keyboard level, and there are no groups. A group switch key might
-convert a keyboard between Hebrew to English modes, for example.
-#GdkEventKey contains a %group field that indicates the active
-keyboard group. The level is computed from the modifier mask.
-The returned array should be freed
-with g_free().
-
-
-</description>
-<parameters>
-<parameter name="keymap">
-<parameter_description> a #GdkKeymap
-</parameter_description>
-</parameter>
-<parameter name="keyval">
-<parameter_description> a keyval, such as %GDK_KEY_a, %GDK_KEY_Up, %GDK_KEY_Return, etc.
-</parameter_description>
-</parameter>
-<parameter name="keys">
-<parameter_description> return location
-for an array of #GdkKeymapKey
-</parameter_description>
-</parameter>
-<parameter name="n_keys">
-<parameter_description> return location for number of elements in returned array
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if keys were found and returned
-</return>
-</function>
-
-<function name="gdk_keymap_get_modifier_state">
-<description>
-Returns the current modifier state.
-
-
-</description>
-<parameters>
-<parameter name="keymap">
-<parameter_description> a #GdkKeymap
-</parameter_description>
-</parameter>
-</parameters>
-<return> the current modifier state.
-</return>
-</function>
-
-<function name="gdk_keymap_get_num_lock_state">
-<description>
-Returns whether the Num Lock modifier is locked.
-
-
-</description>
-<parameters>
-<parameter name="keymap">
-<parameter_description> a #GdkKeymap
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if Num Lock is on
-</return>
-</function>
-
-<function name="gdk_keymap_get_scroll_lock_state">
-<description>
-Returns whether the Scroll Lock modifier is locked.
-
-
-</description>
-<parameters>
-<parameter name="keymap">
-<parameter_description> a #GdkKeymap
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if Scroll Lock is on
-</return>
-</function>
-
-<function name="gdk_keymap_have_bidi_layouts">
-<description>
-Determines if keyboard layouts for both right-to-left and left-to-right
-languages are in use.
-
-
-</description>
-<parameters>
-<parameter name="keymap">
-<parameter_description> a #GdkKeymap
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if there are layouts in both directions, %FALSE otherwise
-</return>
-</function>
-
-<function name="gdk_keymap_lookup_key">
-<description>
-Looks up the keyval mapped to a keycode/group/level triplet.
-If no keyval is bound to @key, returns 0. For normal user input,
-you want to use gdk_keymap_translate_keyboard_state() instead of
-this function, since the effective group/level may not be
-the same as the current keyboard state.
-
-
-</description>
-<parameters>
-<parameter name="keymap">
-<parameter_description> a #GdkKeymap
-</parameter_description>
-</parameter>
-<parameter name="key">
-<parameter_description> a #GdkKeymapKey with keycode, group, and level initialized
-</parameter_description>
-</parameter>
-</parameters>
-<return> a keyval, or 0 if none was mapped to the given @key
-</return>
-</function>
-
-<function name="gdk_keymap_translate_keyboard_state">
-<description>
-Translates the contents of a #GdkEventKey into a keyval, effective
-group, and level. Modifiers that affected the translation and
-are thus unavailable for application use are returned in
-@consumed_modifiers.
-See [Groups][key-group-explanation] for an explanation of
-groups and levels. The @effective_group is the group that was
-actually used for the translation; some keys such as Enter are not
-affected by the active keyboard group. The @level is derived from
-@state. For convenience, #GdkEventKey already contains the translated
-keyval, so this function isn’t as useful as you might think.
-
-@consumed_modifiers gives modifiers that should be masked outfrom @state
-when comparing this key press to a hot key. For instance, on a US keyboard,
-the `plus` symbol is shifted, so when comparing a key press to a
-`<Control>plus` accelerator `<Shift>` should be masked out.
-
-|[<!-- language="C" -->
-// We want to ignore irrelevant modifiers like ScrollLock
-#define ALL_ACCELS_MASK (GDK_CONTROL_MASK | GDK_SHIFT_MASK | GDK_ALT_MASK)
-state = gdk_event_get_modifier_state (event);
-gdk_keymap_translate_keyboard_state (keymap,
-gdk_key_event_get_keycode (event),
-state,
-gdk_key_event_get_group (event),
-&keyval, NULL, NULL, &consumed);
-if (keyval == GDK_PLUS &&
-(state & ~consumed & ALL_ACCELS_MASK) == GDK_CONTROL_MASK)
-// Control was pressed
-]|
-
-An older interpretation @consumed_modifiers was that it contained
-all modifiers that might affect the translation of the key;
-this allowed accelerators to be stored with irrelevant consumed
-modifiers, by doing:
-|[<!-- language="C" -->
-// XXX Don’t do this XXX
-if (keyval == accel_keyval &&
-(state & ~consumed & ALL_ACCELS_MASK) == (accel_mods & ~consumed))
-// Accelerator was pressed
-]|
-
-However, this did not work if multi-modifier combinations were
-used in the keymap, since, for instance, `<Control>` would be
-masked out even if only `<Control><Alt>` was used in the keymap.
-To support this usage as well as well as possible, all single
-modifier combinations that could affect the key for any combination
-of modifiers will be returned in @consumed_modifiers; multi-modifier
-combinations are returned only when actually found in @state. When
-you store accelerators, you should always store them with consumed
-modifiers removed. Store `<Control>plus`, not `<Control><Shift>plus`,
-
-
-</description>
-<parameters>
-<parameter name="keymap">
-<parameter_description> a #GdkKeymap
-</parameter_description>
-</parameter>
-<parameter name="hardware_keycode">
-<parameter_description> a keycode
-</parameter_description>
-</parameter>
-<parameter name="state">
-<parameter_description> a modifier state
-</parameter_description>
-</parameter>
-<parameter name="group">
-<parameter_description> active keyboard group
-</parameter_description>
-</parameter>
-<parameter name="keyval">
-<parameter_description> return location for keyval, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="effective_group">
-<parameter_description> return location for effective
-group, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="level">
-<parameter_description> return location for level, or %NULL
-</parameter_description>
-</parameter>
-<parameter name="consumed_modifiers">
-<parameter_description> return location for modifiers
-that were used to determine the group or level, or %NULL
-</parameter_description>
-</parameter>
-</parameters>
-<return> %TRUE if there was a keyval bound to the keycode/state/group
-</return>
-</function>
-
<function name="gdk_keyval_convert_case">
<description>
Obtains the upper- and lower-case versions of the keyval @symbol.
-Examples of keyvals are #GDK_KEY_a, #GDK_KEY_Enter, #GDK_KEY_F1, etc.
+Examples of keyvals are `GDK_KEY_a`, `GDK_KEY_Enter`, `GDK_KEY_F1`, etc.
</description>
<parameters>
@@ -9224,8 +8884,7 @@ but without the leading “GDK_KEY_”.
</parameter>
</parameters>
<return> a string containing the name
-of the key, or %NULL if @keyval is not a valid key. The string
-should not be modified.
+of the key
</return>
</function>
@@ -9408,8 +9067,7 @@ The PNP ID registry is located at
</parameter_description>
</parameter>
</parameters>
-<return> the name of the manufacturer,
-or %NULL
+<return> the name of the manufacturer
</return>
</function>
@@ -9425,7 +9083,7 @@ Gets the string identifying the monitor model, if available.
</parameter_description>
</parameter>
</parameters>
-<return> the monitor model, or %NULL
+<return> the monitor model
</return>
</function>
@@ -9626,13 +9284,11 @@ no other constraints were given
</parameter_description>
</parameter>
<parameter name="concrete_width">
-<parameter_description> will be set to the concrete width
-computed.
+<parameter_description> will be set to the concrete width computed
</parameter_description>
</parameter>
<parameter name="concrete_height">
-<parameter_description> will be set to the concrete height
-computed.
+<parameter_description> will be set to the concrete height computed
</parameter_description>
</parameter>
</parameters>
@@ -9657,7 +9313,7 @@ If the @paintable is already immutable, it will return itself.
</parameter>
</parameters>
<return> An immutable paintable for the current
-contents of @paintable.
+contents of @paintable
</return>
</function>
@@ -9814,7 +9470,7 @@ it must not call this function.
Returns a paintable that has the given intrinsic size and draws nothing.
This is often useful for implementing the
-#GdkPaintableInterface.get_current_image() virtual function
+[vfunc@Gdk.Paintable.get_current_image] virtual function
when the paintable is in an incomplete state (like a
[class@Gtk.MediaStream] before receiving the first frame).
@@ -9939,9 +9595,8 @@ of text, such as when text is selected.
</parameter_description>
</parameter>
<parameter name="index_ranges">
-<parameter_description> array of byte indexes into the layout,
-where even members of array are start indexes and odd elements
-are end indexes
+<parameter_description> array of byte indexes into the layout, where even
+members of array are start indexes and odd elements are end indexes
</parameter_description>
</parameter>
<parameter name="n_ranges">
@@ -9955,7 +9610,8 @@ are end indexes
<function name="gdk_pipe_io_stream_new">
<description>
-Creates a #GIOStream whose input- and output-stream behave like a pipe.
+Creates a `GIOStream` whose input- and output-stream behave like a pipe.
+
Data written into the output stream becomes available for reading on
the input stream.
@@ -9966,7 +9622,7 @@ g_output_stream_splice().
</description>
<parameters>
</parameters>
-<return> a new #GIOStream
+<return> a new `GIOStream`
</return>
</function>
@@ -11558,7 +11214,7 @@ The pixbuf will contain an alpha channel if the @surface contains one.
</parameter>
</parameters>
<return> A newly-created pixbuf with a
-reference count of 1, or %NULL on error
+reference count of 1
</return>
</function>
@@ -11578,8 +11234,7 @@ to draw it on screen.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GdkPixbuf or %NULL
-in case of an error
+<return> a new `GdkPixbuf`
</return>
</function>
@@ -14491,7 +14146,7 @@ Decreases the reference count of @value.
<function name="gdk_popup_present">
<description>
-Present @popup after having processed the #GdkPopupLayout rules.
+Present @popup after having processed the `GdkPopupLayout` rules.
If the popup was previously now showing, it will be showed,
otherwise it will change position according to @layout.
@@ -14533,7 +14188,7 @@ the [signal@Gdk.Surface::layout] signal will not me emitted.
<function name="gdk_rectangle_contains_point">
<description>
-Returns #TRUE if @rect contains the point described by @x and @y.
+Returns %TRUE if @rect contains the point described by @x and @y.
</description>
@@ -14551,7 +14206,7 @@ Returns #TRUE if @rect contains the point described by @x and @y.
</parameter_description>
</parameter>
</parameters>
-<return> #TRUE if @rect contains the point
+<return> %TRUE if @rect contains the point
</return>
</function>
@@ -14598,7 +14253,7 @@ itself, pass %NULL for @dest.
</parameter>
<parameter name="dest">
<parameter_description> return location for the
-intersection of @src1 and @src2, or %NULL
+intersection of @src1 and @src2
</parameter_description>
</parameter>
</parameters>
@@ -14895,7 +14550,7 @@ Returns the devices that match the given capabilities.
</description>
<parameters>
<parameter name="seat">
-<parameter_description> a #GdkSeat
+<parameter_description> a `GdkSeat`
</parameter_description>
</parameter>
<parameter name="capabilities">
@@ -15077,8 +14732,7 @@ call [method@Gdk.GLContext.make_current] or [method@Gdk.GLContext.realize].
</parameter_description>
</parameter>
</parameters>
-<return> the newly created `GdkGLContext`,
-or %NULL on error
+<return> the newly created `GdkGLContext`
</return>
</function>
@@ -15179,6 +14833,8 @@ Retrieves a `GdkCursor` pointer for the cursor currently set on the
If the return value is %NULL then there is no custom cursor set on
the surface, and it is using the cursor for its parent surface.
+Use [method@Gdk.Surface.set_cursor] to unset the cursor of the surface.
+
</description>
<parameters>
@@ -15187,10 +14843,7 @@ the surface, and it is using the cursor for its parent surface.
</parameter_description>
</parameter>
</parameters>
-<return> a `GdkCursor`, or %NULL. The
-returned object is owned by the `GdkSurface` and should not be
-unreferenced directly. Use [method@Gdk.Surface.set_cursor] to
-unset the cursor of the surface
+<return> a `GdkCursor`
</return>
</function>
@@ -15202,6 +14855,8 @@ specified `GdkSurface`.
If the return value is %NULL then there is no custom cursor set on the
specified surface, and it is using the cursor for its parent surface.
+Use [method@Gdk.Surface.set_cursor] to unset the cursor of the surface.
+
</description>
<parameters>
@@ -15214,10 +14869,7 @@ specified surface, and it is using the cursor for its parent surface.
</parameter_description>
</parameter>
</parameters>
-<return> a `GdkCursor`, or %NULL. The
-returned object is owned by the `GdkSurface` and should not be
-unreferenced directly. Use [method@Gdk.Surface.set_cursor] to unset
-the cursor of the surface
+<return> a `GdkCursor`
</return>
</function>
@@ -15241,15 +14893,15 @@ Return: %TRUE if the device is over the surface
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> return locatio for the X coordinate of @device, or %NULL
+<parameter_description> return location for the X coordinate of @device
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> return location for the Y coordinate of @device, or %NULL
+<parameter_description> return location for the Y coordinate of @device
</parameter_description>
</parameter>
<parameter name="mask">
-<parameter_description> return location for the modifier mask, or %NULL
+<parameter_description> return location for the modifier mask
</parameter_description>
</parameter>
</parameters>
@@ -15582,7 +15234,7 @@ This function only works for toplevel surfaces.
GTK will update this property automatically if the @surface background
is opaque, as we know where the opaque regions are. If your surface
background is not opaque, please update this property in your
-#GtkWidgetClass.css_changed() handler.
+[vfunc@Gtk.Widget.css_changed] handler.
</description>
<parameters>
@@ -15591,7 +15243,8 @@ background is not opaque, please update this property in your
</parameter_description>
</parameter>
<parameter name="region">
-<parameter_description> a region, or %NULL
+<parameter_description> a region, or %NULL to make the entire
+surface opaque
</parameter_description>
</parameter>
</parameters>
@@ -15757,7 +15410,7 @@ If %NULL is returned, then @error will be set.
</parameter_description>
</parameter>
</parameters>
-<return> A newly-created `GdkTexture` or %NULL if an error occurred.
+<return> A newly-created `GdkTexture`
</return>
</function>
@@ -15819,7 +15472,7 @@ You might use this function to implement draggable titlebars.
</description>
<parameters>
<parameter name="toplevel">
-<parameter_description> a #GdkToplevel
+<parameter_description> a `GdkToplevel`
</parameter_description>
</parameter>
<parameter name="device">
@@ -15967,13 +15620,13 @@ request, or %NULL if none is available
<function name="gdk_toplevel_layout_copy">
<description>
-Create a new #GdkToplevelLayout and copy the contents of @layout into it.
+Create a new `GdkToplevelLayout` and copy the contents of @layout into it.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GdkToplevelLayout
+<parameter_description> a `GdkToplevelLayout`
</parameter_description>
</parameter>
</parameters>
@@ -15989,11 +15642,11 @@ Check whether @layout and @other has identical layout properties.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GdkToplevelLayout
+<parameter_description> a `GdkToplevelLayout`
</parameter_description>
</parameter>
<parameter name="other">
-<parameter_description> another #GdkToplevelLayout
+<parameter_description> another `GdkToplevelLayout`
</parameter_description>
</parameter>
</parameters>
@@ -16012,7 +15665,7 @@ fullscreen, or %FALSE, if it should go unfullscreen.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GdkToplevelLayout
+<parameter_description> a ``GdkToplevelLayout`
</parameter_description>
</parameter>
<parameter name="fullscreen">
@@ -16033,7 +15686,7 @@ the surface on.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GdkToplevelLayout
+<parameter_description> a `GdkToplevelLayout`
</parameter_description>
</parameter>
</parameters>
@@ -16051,7 +15704,7 @@ fullscreen, or %FALSE, if it should go unmaximized.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GdkToplevelLayout
+<parameter_description> a `GdkToplevelLayout`
</parameter_description>
</parameter>
<parameter name="maximized">
@@ -16072,7 +15725,7 @@ to resize the surface.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GdkToplevelLayout
+<parameter_description> a `GdkToplevelLayout`
</parameter_description>
</parameter>
</parameters>
@@ -16094,7 +15747,7 @@ The size is in ”application pixels”, not
</description>
<parameters>
</parameters>
-<return> newly created instance of #GdkToplevelLayout
+<return> newly created instance of `GdkToplevelLayout`
</return>
</function>
@@ -16106,7 +15759,7 @@ Increases the reference count of @layout.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GdkToplevelLayout
+<parameter_description> a `GdkToplevelLayout`
</parameter_description>
</parameter>
</parameters>
@@ -16122,7 +15775,7 @@ to be fullscreen when presented.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GdkToplevelLayout
+<parameter_description> a `GdkToplevelLayout`
</parameter_description>
</parameter>
<parameter name="fullscreen">
@@ -16145,7 +15798,7 @@ to be maximized when presented.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GdkToplevelLayout
+<parameter_description> a `GdkToplevelLayout`
</parameter_description>
</parameter>
<parameter name="maximized">
@@ -16164,7 +15817,7 @@ to resize the surface after it has been presented.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GdkToplevelLayout
+<parameter_description> a `GdkToplevelLayout`
</parameter_description>
</parameter>
<parameter name="resizable">
@@ -16182,7 +15835,7 @@ Decreases the reference count of @layout.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GdkToplevelLayout
+<parameter_description> a `GdkToplevelLayout`
</parameter_description>
</parameter>
</parameters>
@@ -16592,8 +16245,7 @@ tiled window states.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the desktop environment supports
-tiled window states
+<return> %TRUE if the desktop environment supports tiled window states
</return>
</function>
@@ -16724,7 +16376,7 @@ Gets the Vulkan device that this context is using.
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GdkVulkanContext
+<parameter_description> a `GdkVulkanContext`
</parameter_description>
</parameter>
</parameters>
diff --git a/gdk/src/gdk_docs_override.xml b/gdk/src/gdk_docs_override.xml
index f907622f..c5caf5b8 100644
--- a/gdk/src/gdk_docs_override.xml
+++ b/gdk/src/gdk_docs_override.xml
@@ -1,9 +1,14 @@
<root>
+<substitute_type_name from="GBytes" to="Glib::Bytes" />
+<substitute_type_name from="GValue" to="Glib::Value" />
<substitute_type_name from="GIcon" to="Gio::Icon" />
<substitute_type_name from="GAppInfo" to="Gio::AppInfo" />
<substitute_type_name from="GSettings" to="Gio::Settings" />
<substitute_type_name from="GInputStream" to="Gio::InputStream" />
<substitute_type_name from="GCancellable" to="Gio::Cancellable" />
+<substitute_type_name from="GAsyncResult" to="Gio::AsyncResult" />
+<substitute_type_name from="GListModel" to="Gio::ListModel" />
+<substitute_type_name from="GOutputStream" to="Gio::OutputStream" />
<substitute_type_name from="GdkCursorType" to="Gdk::Cursor::Type" />
<substitute_type_name from="GdkDeviceType" to="Gdk::Device::Type" />
<substitute_type_name from="GdkDeviceToolType" to="Gdk::DeviceTool::Type" />
@@ -16,6 +21,9 @@
<substitute_type_name from="GdkSurfaceTypeHint" to="Gdk::Surface::TypeHint" />
<substitute_type_name from="GdkToplevelState" to="Gdk::Toplevel::State" />
<substitute_type_name from="GdkVisualType" to="Gdk::Visual::Type" />
+<!-- These have no corresponding C++ type. Don't substitute. -->
+<substitute_type_name from="GType" to="GType" />
+<substitute_type_name from="VkFormat" to="VkFormat" />
<substitute_enumerator_name from_prefix="CAIRO_FORMAT_" to_prefix="Cairo::Surface::Format::" />
<substitute_enumerator_name from_prefix="PANGO_DIRECTION_" to_prefix="Pango::Direction::" />
@@ -68,13 +76,14 @@
<substitute_enumerator_name from="GDK_CONTROL_MASK" to="Gdk::ModifierType::CONTROL_MASK" />
<substitute_enumerator_name from="GDK_MOD2_MASK" to="Gdk::ModifierType::MOD2_MASK" />
<substitute_enumerator_name from="GDK_BLANK_CURSOR" to="Gdk::Cursor::Type::BLANK_CURSOR" />
-<!-- These are preprocessor defines. Don't substitute. -->
+<!-- These are not enumerator names. Don't substitute. -->
<substitute_enumerator_name from="GDK_CURRENT_TIME" to="GDK_CURRENT_TIME" />
<substitute_enumerator_name from="GDK_PIXBUF_ERROR" to="GDK_PIXBUF_ERROR" />
<substitute_enumerator_name from="G_TYPE_INVALID" to="G_TYPE_INVALID" />
<substitute_enumerator_name from="G_FILE_ERROR" to="G_FILE_ERROR" />
<substitute_enumerator_name from="G_IO_ERROR" to="G_IO_ERROR" />
<substitute_enumerator_name from="GDK_BUTTON_SECONDARY" to="GDK_BUTTON_SECONDARY" />
+<substitute_enumerator_name from="GDK_BACKEND" to="GDK_BACKEND" />
<function name="gdk_display_manager_list_displays">
<return> a vector of #GdkDisplay objects.
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index 8ddcebfb..4922c6f0 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -112,7 +112,7 @@ as links, see the introduction for more details.
<property name="GtkAboutDialog:license">
<description>
-The license of the program, as free form text.
+The license of the program, as free-form text.
This string is displayed in a text view in a secondary dialog, therefore
it is fine to use a long multi-paragraph text. Note that the text is only
@@ -174,7 +174,8 @@ This property overrides the [property@Gtk.AboutDialog:logo] property.
<description>
The name of the program.
-If this is not set, it defaults to `g_get_application_name()`.
+If this is not set, it defaults to the value returned by
+`g_get_application_name()`.
</description>
</property>
@@ -183,7 +184,7 @@ If this is not set, it defaults to `g_get_application_name()`.
<description>
Information about the system on which the program is running.
-This information is displayed in a separate tab, therefore it is fine
+This information is displayed in a separate page, therefore it is fine
to use a long multi-paragraph text. Note that the text should contain
the intended linebreaks.
@@ -319,7 +320,7 @@ The possible accessible properties of a `GtkAccessible`.
<parameter_description> Indicates whether inputting text
could trigger display of one or more predictions of the user's intended
value for a combobox, searchbox, or textbox and specifies how predictions
-would be presented if they were made. Value type: #GtkAccessibleAutocomplete
+would be presented if they were made. Value type: `GtkAccessibleAutocomplete`
</parameter_description>
</parameter>
<parameter name="GTK_ACCESSIBLE_PROPERTY_DESCRIPTION">
@@ -368,7 +369,7 @@ boolean
<parameter name="GTK_ACCESSIBLE_PROPERTY_ORIENTATION">
<parameter_description> Indicates whether the element's
orientation is horizontal, vertical, or unknown/ambiguous. Value type:
-#GtkOrientation
+`GtkOrientation`
</parameter_description>
</parameter>
<parameter name="GTK_ACCESSIBLE_PROPERTY_PLACEHOLDER">
@@ -396,7 +397,7 @@ author-localized description for the role of an element. Value type: string
<parameter name="GTK_ACCESSIBLE_PROPERTY_SORT">
<parameter_description> Indicates if items in a table or grid are
sorted in ascending or descending order. Possible property values are in
-the #GtkAccessibleSort enumeration. Value type: #GtkAccessibleSort
+the `GtkAccessibleSort` enumeration. Value type: `GtkAccessibleSort`
</parameter_description>
</parameter>
<parameter name="GTK_ACCESSIBLE_PROPERTY_VALUE_MAX">
@@ -622,7 +623,7 @@ information or require a response.
</parameter>
<parameter name="GTK_ACCESSIBLE_ROLE_GROUP">
<parameter_description> An element that groups multiple widgets. GTK uses
-this role for various containers, like #GtkBox, #GtkViewport, and #GtkHeaderBar.
+this role for various containers, like `GtkBox`, `GtkViewport`, and `GtkHeaderBar`.
</parameter_description>
</parameter>
<parameter name="GTK_ACCESSIBLE_ROLE_HEADING">
@@ -914,24 +915,24 @@ The possible accessible states of a `GtkAccessible`.
</parameter>
<parameter name="GTK_ACCESSIBLE_STATE_CHECKED">
<parameter_description> A “checked” state; indicates the current
-state of a #GtkCheckButton. Value type: #GtkAccessibleTristate
+state of a `GtkCheckButton`. Value type: `GtkAccessibleTristate`
</parameter_description>
</parameter>
<parameter name="GTK_ACCESSIBLE_STATE_DISABLED">
<parameter_description> A “disabled” state; corresponds to the
-#GtkWidget:sensitive property on #GtkWidget. It indicates a UI element
+`GtkWidget:sensitive` property on `GtkWidget`. It indicates a UI element
that is perceivable, but not editable or operable. Value type: boolean
</parameter_description>
</parameter>
<parameter name="GTK_ACCESSIBLE_STATE_EXPANDED">
<parameter_description> An “expanded” state; corresponds to the
-#GtkExpander:expanded property on #GtkExpander. Value type: boolean
+`GtkExpander:expanded` property on `GtkExpander`. Value type: boolean
or undefined
</parameter_description>
</parameter>
<parameter name="GTK_ACCESSIBLE_STATE_HIDDEN">
<parameter_description> A “hidden” state; corresponds to the
-#GtkWidget:visible property on #GtkWidget. You can use this state
+`GtkWidget:visible` property on `GtkWidget`. You can use this state
explicitly on UI elements that should not be exposed to an assistive
technology. Value type: boolean
See also: %GTK_ACCESSIBLE_STATE_DISABLED
@@ -939,12 +940,12 @@ See also: %GTK_ACCESSIBLE_STATE_DISABLED
</parameter>
<parameter name="GTK_ACCESSIBLE_STATE_INVALID">
<parameter_description> An “invalid” state; set when a widget
-is showing an error. Value type: #GtkAccessibleInvalidState
+is showing an error. Value type: `GtkAccessibleInvalidState`
</parameter_description>
</parameter>
<parameter name="GTK_ACCESSIBLE_STATE_PRESSED">
<parameter_description> A “pressed” state; indicates the current
-state of a #GtkToggleButton. Value type: #GtkAccessibleTristate
+state of a `GtkToggleButton`. Value type: `GtkAccessibleTristate`
enumeration
</parameter_description>
</parameter>
@@ -1096,23 +1097,20 @@ no meaningful way to stretch
</parameter_description>
</parameter>
<parameter name="GTK_ALIGN_START">
-<parameter_description> snap to left or top side, leaving space on right
-or bottom
+<parameter_description> snap to left or top side, leaving space on right or bottom
</parameter_description>
</parameter>
<parameter name="GTK_ALIGN_END">
-<parameter_description> snap to right or bottom side, leaving space on left
-or top
+<parameter_description> snap to right or bottom side, leaving space on left or top
</parameter_description>
</parameter>
<parameter name="GTK_ALIGN_CENTER">
-<parameter_description> center natural width of widget inside the
-allocation
+<parameter_description> center natural width of widget inside the allocation
</parameter_description>
</parameter>
<parameter name="GTK_ALIGN_BASELINE">
-<parameter_description> align the widget according to the baseline. See
-#GtkWidget
+<parameter_description> align the widget according to the baseline.
+See [class@Gtk.Widget].
</parameter_description>
</parameter>
</parameters>
@@ -1243,7 +1241,7 @@ Return or Enter.
</parameter_description>
</parameter>
<parameter name="application">
-<parameter_description> the activated #GAppInfo
+<parameter_description> the activated `GAppInfo`
</parameter_description>
</parameter>
</parameters>
@@ -1261,7 +1259,7 @@ Emitted when an application item is selected from the widget's list.
</parameter_description>
</parameter>
<parameter name="application">
-<parameter_description> the selected #GAppInfo
+<parameter_description> the selected `GAppInfo`
</parameter_description>
</parameter>
</parameters>
@@ -1632,7 +1630,7 @@ necessary before showing @page.
<property name="GtkAssistant:use-header-bar">
<description>
-%TRUE if the assistant uses a #GtkHeaderBar for action buttons
+%TRUE if the assistant uses a `GtkHeaderBar` for action buttons
instead of the action-area.
For technical reasons, this property is declared as an integer
@@ -1908,7 +1906,7 @@ The scope the builder is operating in
The translation domain used when translating property values that
have been marked as translatable.
-If the translation domain is %NULL, #GtkBuilder uses gettext(),
+If the translation domain is %NULL, `GtkBuilder` uses gettext(),
otherwise g_dgettext().
</description>
@@ -1919,7 +1917,7 @@ otherwise g_dgettext().
The list of flags that can be passed to gtk_builder_create_closure().
New values may be added in the future for new features, so external
-implementations of [interface@Gtk.BuilderScope] should test the flags
+implementations of [iface@Gtk.BuilderScope] should test the flags
for unknown values and raise a %GTK_BUILDER_ERROR_INVALID_ATTRIBUTE error
when they encounter one.
@@ -1936,32 +1934,32 @@ g_cclosure_new_swap() for details.
<enum name="GtkBuilderError">
<description>
Error codes that identify various errors that can occur while using
-#GtkBuilder.
+`GtkBuilder`.
</description>
<parameters>
<parameter name="GTK_BUILDER_ERROR_INVALID_TYPE_FUNCTION">
<parameter_description> A type-func attribute didn’t name
-a function that returns a #GType.
+a function that returns a `GType`.
</parameter_description>
</parameter>
<parameter name="GTK_BUILDER_ERROR_UNHANDLED_TAG">
-<parameter_description> The input contained a tag that #GtkBuilder
+<parameter_description> The input contained a tag that `GtkBuilder`
can’t handle.
</parameter_description>
</parameter>
<parameter name="GTK_BUILDER_ERROR_MISSING_ATTRIBUTE">
<parameter_description> An attribute that is required by
-#GtkBuilder was missing.
+`GtkBuilder` was missing.
</parameter_description>
</parameter>
<parameter name="GTK_BUILDER_ERROR_INVALID_ATTRIBUTE">
-<parameter_description> #GtkBuilder found an attribute that
+<parameter_description> `GtkBuilder` found an attribute that
it doesn’t understand.
</parameter_description>
</parameter>
<parameter name="GTK_BUILDER_ERROR_INVALID_TAG">
-<parameter_description> #GtkBuilder found a tag that
+<parameter_description> `GtkBuilder` found a tag that
it doesn’t understand.
</parameter_description>
</parameter>
@@ -1971,7 +1969,7 @@ missing.
</parameter_description>
</parameter>
<parameter name="GTK_BUILDER_ERROR_INVALID_VALUE">
-<parameter_description> #GtkBuilder couldn’t parse
+<parameter_description> `GtkBuilder` couldn’t parse
some attribute value.
</parameter_description>
</parameter>
@@ -2104,7 +2102,7 @@ to be used as mnemonic.
<enum name="GtkButtonRole">
<description>
-The role specifies the desired appearance of a #GtkModelButton.
+The role specifies the desired appearance of a GtkModelButton.
</description>
<parameters>
@@ -2241,9 +2239,6 @@ Emitted when user switched to the previous year.
<description>
The selected day (as a number between 1 and 31).
-This can be set to 0 to unselect the currently selected day.
-This property gets initially set to the current day.
-
</description>
</property>
@@ -2294,24 +2289,24 @@ should be added to the owning cell-layouting widget at @cell_area.
</description>
<parameters>
<parameter name="area">
-<parameter_description> the #GtkCellArea where editing started
+<parameter_description> the `GtkCellArea` where editing started
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> the #GtkCellRenderer that started the edited
+<parameter_description> the `GtkCellRenderer` that started the edited
</parameter_description>
</parameter>
<parameter name="editable">
-<parameter_description> the #GtkCellEditable widget to add
+<parameter_description> the `GtkCellEditable` widget to add
</parameter_description>
</parameter>
<parameter name="cell_area">
-<parameter_description> the #GtkWidget relative #GdkRectangle coordinates
+<parameter_description> the `GtkWidget` relative `GdkRectangle` coordinates
where @editable should be added
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> the #GtkTreePath string this edit was initiated for
+<parameter_description> the `GtkTreePath` string this edit was initiated for
</parameter_description>
</parameter>
</parameters>
@@ -2325,15 +2320,15 @@ This signal is emitted whenever applying attributes to @area from @model
</description>
<parameters>
<parameter name="area">
-<parameter_description> the #GtkCellArea to apply the attributes to
+<parameter_description> the `GtkCellArea` to apply the attributes to
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> the #GtkTreeModel to apply the attributes from
+<parameter_description> the `GtkTreeModel` to apply the attributes from
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter indicating which row to apply the attributes of
+<parameter_description> the `GtkTreeIter` indicating which row to apply the attributes of
</parameter_description>
</parameter>
<parameter name="is_expander">
@@ -2362,15 +2357,15 @@ same cell area for a different row of data.
</description>
<parameters>
<parameter name="area">
-<parameter_description> the #GtkCellArea where focus changed
+<parameter_description> the `GtkCellArea` where focus changed
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> the #GtkCellRenderer that has focus
+<parameter_description> the `GtkCellRenderer` that has focus
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> the current #GtkTreePath string set for @area
+<parameter_description> the current `GtkTreePath` string set for @area
</parameter_description>
</parameter>
</parameters>
@@ -2385,15 +2380,15 @@ should be removed from the owning cell-layouting widget.
</description>
<parameters>
<parameter name="area">
-<parameter_description> the #GtkCellArea where editing finished
+<parameter_description> the `GtkCellArea` where editing finished
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> the #GtkCellRenderer that finished editeding
+<parameter_description> the `GtkCellRenderer` that finished editeding
</parameter_description>
</parameter>
<parameter name="editable">
-<parameter_description> the #GtkCellEditable widget to remove
+<parameter_description> the `GtkCellEditable` widget to remove
</parameter_description>
</parameter>
</parameters>
@@ -2467,15 +2462,15 @@ The amount of space to reserve between cells.
<property name="GtkCellAreaContext:area">
<description>
-The #GtkCellArea this context was created by
+The `GtkCellArea` this context was created by
</description>
</property>
<property name="GtkCellAreaContext:minimum-height">
<description>
-The minimum height for the #GtkCellArea in this context
-for all #GtkTreeModel rows that this context was requested
+The minimum height for the `GtkCellArea` in this context
+for all `GtkTreeModel` rows that this context was requested
for using gtk_cell_area_get_preferred_height().
</description>
@@ -2483,8 +2478,8 @@ for using gtk_cell_area_get_preferred_height().
<property name="GtkCellAreaContext:minimum-width">
<description>
-The minimum width for the #GtkCellArea in this context
-for all #GtkTreeModel rows that this context was requested
+The minimum width for the `GtkCellArea` in this context
+for all `GtkTreeModel` rows that this context was requested
for using gtk_cell_area_get_preferred_width().
</description>
@@ -2492,8 +2487,8 @@ for using gtk_cell_area_get_preferred_width().
<property name="GtkCellAreaContext:natural-height">
<description>
-The natural height for the #GtkCellArea in this context
-for all #GtkTreeModel rows that this context was requested
+The natural height for the `GtkCellArea` in this context
+for all `GtkTreeModel` rows that this context was requested
for using gtk_cell_area_get_preferred_height().
</description>
@@ -2501,8 +2496,8 @@ for using gtk_cell_area_get_preferred_height().
<property name="GtkCellAreaContext:natural-width">
<description>
-The natural width for the #GtkCellArea in this context
-for all #GtkTreeModel rows that this context was requested
+The natural width for the `GtkCellArea` in this context
+for all `GtkTreeModel` rows that this context was requested
for using gtk_cell_area_get_preferred_width().
</description>
@@ -2513,14 +2508,14 @@ for using gtk_cell_area_get_preferred_width().
This signal is a sign for the cell renderer to update its
value from the @cell_editable.
-Implementations of #GtkCellEditable are responsible for
+Implementations of `GtkCellEditable` are responsible for
emitting this signal when they are done editing, e.g.
-#GtkEntry emits this signal when the user presses Enter. Typical things to
+`GtkEntry` emits this signal when the user presses Enter. Typical things to
do in a handler for ::editing-done are to capture the edited value,
-disconnect the @cell_editable from signals on the #GtkCellRenderer, etc.
+disconnect the @cell_editable from signals on the `GtkCellRenderer`, etc.
gtk_cell_editable_editing_done() is a convenience method
-for emitting #GtkCellEditable::editing-done.
+for emitting `GtkCellEditable::editing-done`.
</description>
<parameters>
@@ -2538,14 +2533,14 @@ This signal is meant to indicate that the cell is finished
editing, and the @cell_editable widget is being removed and may
subsequently be destroyed.
-Implementations of #GtkCellEditable are responsible for
+Implementations of `GtkCellEditable` are responsible for
emitting this signal when they are done editing. It must
-be emitted after the #GtkCellEditable::editing-done signal,
+be emitted after the `GtkCellEditable::editing-done` signal,
to give the cell renderer a chance to update the cell's value
before the widget is removed.
gtk_cell_editable_remove_widget() is a convenience method
-for emitting #GtkCellEditable::remove-widget.
+for emitting `GtkCellEditable::remove-widget`.
</description>
<parameters>
@@ -2586,8 +2581,8 @@ See also: gtk_cell_renderer_stop_editing().
<description>
This signal gets emitted when a cell starts to be edited.
The intended use of this signal is to do special setup
-on @editable, e.g. adding a #GtkEntryCompletion or setting
-up additional columns in a #GtkComboBox.
+on @editable, e.g. adding a `GtkEntryCompletion` or setting
+up additional columns in a `GtkComboBox`.
See gtk_cell_editable_start_editing() for information on the lifecycle of
the @editable and a way to do setup that doesn’t depend on the @renderer.
@@ -2621,7 +2616,7 @@ gtk_entry_set_completion (entry, completion);
</parameter_description>
</parameter>
<parameter name="editable">
-<parameter_description> the #GtkCellEditable
+<parameter_description> the `GtkCellEditable`
</parameter_description>
</parameter>
<parameter name="path">
@@ -2634,7 +2629,7 @@ gtk_entry_set_completion (entry, completion);
<property name="GtkCellRenderer:cell-background-rgba">
<description>
-Cell background as a #GdkRGBA
+Cell background as a `GdkRGBA`
</description>
</property>
@@ -2799,7 +2794,7 @@ Note that this refers to the model specified in the model property,
not the model backing the tree view to which
this cell renderer is attached.
-#GtkCellRendererCombo automatically adds a text cell renderer for
+`GtkCellRendererCombo` automatically adds a text cell renderer for
this column to its combo box.
</description>
@@ -2848,7 +2843,7 @@ This property only has an effect if not overridden by the "pixbuf" pro
<property name="GtkCellRendererPixbuf:icon-size">
<description>
-The #GtkIconSize value that specifies the size of the rendered icon.
+The `GtkIconSize` value that specifies the size of the rendered icon.
</description>
</property>
@@ -2938,7 +2933,7 @@ The number of decimal places to display.
Pulse of the spinner. Increment this value to draw the next frame of the
spinner animation. Usually, you would update this value in a timeout.
-By default, the #GtkSpinner widget draws one full cycle of the animation,
+By default, the `GtkSpinner` widget draws one full cycle of the animation,
consisting of 12 frames, in 750 milliseconds.
</description>
@@ -2946,7 +2941,7 @@ consisting of 12 frames, in 750 milliseconds.
<property name="GtkCellRendererSpinner:size">
<description>
-The #GtkIconSize value that specifies the size of the rendered spinner.
+The `GtkIconSize` value that specifies the size of the rendered spinner.
</description>
</property>
@@ -3019,7 +3014,7 @@ and store @new_text at the position indicated by @path.
Specifies how to align the lines of text with respect to each other.
Note that this property describes how to align the lines of text in
-case there are several of them. The "xalign" property of #GtkCellRenderer,
+case there are several of them. The "xalign" property of `GtkCellRenderer`,
on the other hand, sets the horizontal alignment of the whole text.
</description>
@@ -3027,7 +3022,7 @@ on the other hand, sets the horizontal alignment of the whole text.
<property name="GtkCellRendererText:background-rgba">
<description>
-Background color as a #GdkRGBA
+Background color as a `GdkRGBA`
</description>
</property>
@@ -3044,7 +3039,7 @@ for another way of making the text fit into a given width.
<property name="GtkCellRendererText:foreground-rgba">
<description>
-Foreground color as a #GdkRGBA
+Foreground color as a `GdkRGBA`
</description>
</property>
@@ -3057,7 +3052,7 @@ is set to -1, the width will be calculated automatically.
For cell renderers that ellipsize or wrap text; this property
controls the maximum reported width of the cell. The
cell should not receive any greater allocation unless it is
-set to expand in its #GtkCellLayout and all of the cell's siblings
+set to expand in its `GtkCellLayout` and all of the cell's siblings
have received their natural width.
</description>
@@ -3065,8 +3060,8 @@ have received their natural width.
<property name="GtkCellRendererText:placeholder-text">
<description>
-The text that will be displayed in the #GtkCellRenderer if
-#GtkCellRendererText:editable is %TRUE and the cell is empty.
+The text that will be displayed in the `GtkCellRenderer` if
+`GtkCellRendererText:editable` is %TRUE and the cell is empty.
</description>
</property>
@@ -3113,7 +3108,7 @@ opposite of the value currently stored at @path.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> string representation of #GtkTreePath describing the
+<parameter_description> string representation of `GtkTreePath` describing the
event location
</parameter_description>
</parameter>
@@ -3123,10 +3118,10 @@ event location
<property name="GtkCellView:cell-area">
<description>
-The #GtkCellArea rendering cells
+The `GtkCellArea` rendering cells
If no area is specified when creating the cell view with gtk_cell_view_new_with_context()
-a horizontally oriented #GtkCellAreaBox will be used.
+a horizontally oriented `GtkCellArea`Box will be used.
since 3.0
@@ -3135,13 +3130,13 @@ since 3.0
<property name="GtkCellView:cell-area-context">
<description>
-The #GtkCellAreaContext used to compute the geometry of the cell view.
+The `GtkCellAreaContext` used to compute the geometry of the cell view.
A group of cell views can be assigned the same context in order to
ensure the sizes and cell alignments match across all the views with
the same context.
-#GtkComboBox menus uses this to assign the same context to all cell views
+`GtkComboBox` menus uses this to assign the same context to all cell views
in the menu items for a single menu (each submenu creates its own
context since the size of each submenu does not depend on parent
or sibling menus).
@@ -3753,8 +3748,8 @@ The order relation between the terms of the constraint.
The source of the constraint.
The constraint will set the [property@Gtk.Constraint:target-attribute]
-of the target using the [property@Gtk.Constraint:source-attribute]
-of the source.
+property of the target using the [property@Gtk.Constraint:source-attribute]
+property of the source.
</description>
</property>
@@ -3782,9 +3777,9 @@ value.
<description>
The target of the constraint.
-The constraint will set the #GtkConstraint:target-attribute of the
-target using the #GtkConstraint:source-attribute of the source
-widget.
+The constraint will set the [property@Gtk.Constraint:target-attribute]
+property of the target using the [property@Gtk.Constraint:source-attribute]
+property of the source widget.
@@ -3793,7 +3788,7 @@ widget.
<property name="GtkConstraint:target-attribute">
<description>
-The attribute of the #GtkConstraint:target set by the constraint.
+The attribute of the [property@Gtk.Constraint:target] set by the constraint.
</description>
</property>
@@ -3946,7 +3941,7 @@ The relation between two terms of a constraint.
<description>
The strength of a constraint, expressed as a symbolic constant.
-The strength of a #GtkConstraint can be expressed with any positive
+The strength of a `GtkConstraint` can be expressed with any positive
integer; the values of this enumeration can be used for readability.
</description>
@@ -4049,8 +4044,7 @@ to be ignored.
</parameter_description>
</parameter>
<parameter name="GTK_CSS_PARSER_ERROR_SYNTAX">
-<parameter_description> The given text does not form valid
-syntax
+<parameter_description> The given text does not form valid syntax
</parameter_description>
</parameter>
<parameter name="GTK_CSS_PARSER_ERROR_IMPORT">
@@ -4062,8 +4056,7 @@ syntax
</parameter_description>
</parameter>
<parameter name="GTK_CSS_PARSER_ERROR_UNKNOWN_VALUE">
-<parameter_description> The given value is not
-correct
+<parameter_description> The given value is not correct
</parameter_description>
</parameter>
</parameters>
@@ -4073,7 +4066,7 @@ correct
<description>
Warnings that can occur while parsing CSS.
-Unlike #GtkCssParserErrors, warnings do not cause the parser to
+Unlike `GtkCssParserError`s, warnings do not cause the parser to
skip any input, but they indicate issues that should be fixed.
</description>
@@ -4089,8 +4082,7 @@ that should be avoided
</parameter_description>
</parameter>
<parameter name="GTK_CSS_PARSER_WARNING_UNIMPLEMENTED">
-<parameter_description> A feature is not
-implemented
+<parameter_description> A feature is not implemented
</parameter_description>
</parameter>
</parameters>
@@ -4130,6 +4122,95 @@ than when a loading function was called.
<return></return>
</signal>
+<enum name="GtkDebugFlags">
+<description>
+Flags to use with gtk_set_debug_flags().
+
+Settings these flags causes GTK to print out different
+types of debugging information. Some of these flags are
+only available when GTK has been configured with `-Ddebug=true`.
+
+</description>
+<parameters>
+<parameter name="GTK_DEBUG_TEXT">
+<parameter_description> Information about GtkTextView
+</parameter_description>
+</parameter>
+<parameter name="GTK_DEBUG_TREE">
+<parameter_description> Information about GtkTreeView
+</parameter_description>
+</parameter>
+<parameter name="GTK_DEBUG_KEYBINDINGS">
+<parameter_description> Information about keyboard shortcuts
+</parameter_description>
+</parameter>
+<parameter name="GTK_DEBUG_MODULES">
+<parameter_description> Information about modules and extensions
+</parameter_description>
+</parameter>
+<parameter name="GTK_DEBUG_GEOMETRY">
+<parameter_description> Information about size allocation
+</parameter_description>
+</parameter>
+<parameter name="GTK_DEBUG_ICONTHEME">
+<parameter_description> Information about icon themes
+</parameter_description>
+</parameter>
+<parameter name="GTK_DEBUG_PRINTING">
+<parameter_description> Information about printing
+</parameter_description>
+</parameter>
+<parameter name="GTK_DEBUG_BUILDER">
+<parameter_description> Trace GtkBuilder operation
+</parameter_description>
+</parameter>
+<parameter name="GTK_DEBUG_SIZE_REQUEST">
+<parameter_description> Information about size requests
+</parameter_description>
+</parameter>
+<parameter name="GTK_DEBUG_NO_CSS_CACHE">
+<parameter_description> Disable the style property cache
+</parameter_description>
+</parameter>
+<parameter name="GTK_DEBUG_INTERACTIVE">
+<parameter_description> Open the GTK inspector
+</parameter_description>
+</parameter>
+<parameter name="GTK_DEBUG_TOUCHSCREEN">
+<parameter_description> Pretend the pointer is a touchscreen
+</parameter_description>
+</parameter>
+<parameter name="GTK_DEBUG_ACTIONS">
+<parameter_description> Information about actions and menu models
+</parameter_description>
+</parameter>
+<parameter name="GTK_DEBUG_LAYOUT">
+<parameter_description> Information from layout managers
+</parameter_description>
+</parameter>
+<parameter name="GTK_DEBUG_SNAPSHOT">
+<parameter_description> Include debug render nodes in the generated snapshots
+</parameter_description>
+</parameter>
+<parameter name="GTK_DEBUG_CONSTRAINTS">
+<parameter_description> Information from the constraints solver
+</parameter_description>
+</parameter>
+<parameter name="GTK_DEBUG_BUILDER_OBJECTS">
+<parameter_description> Log unused GtkBuilder objects
+</parameter_description>
+</parameter>
+<parameter name="GTK_DEBUG_A11Y">
+<parameter_description> Information about accessibility state changes
+</parameter_description>
+</parameter>
+<parameter name="GTK_DEBUG_ICONFALLBACK">
+<parameter_description> Information about icon fallback
+</parameter_description>
+</parameter>
+</parameters>
+</enum>
+
<enum name="GtkDeleteType">
<description>
Passed to various keybinding signals for deleting text.
@@ -4443,7 +4524,7 @@ property ahead of time, you don't need to connect to this signal.
</parameter_description>
</parameter>
</parameters>
-<return> a `GdkContentProvider`, or %NULL
+<return> a `GdkContentProvider`
</return>
</signal>
@@ -4724,7 +4805,7 @@ and performing the drop operation.
</parameter_description>
</parameter>
<parameter name="value">
-<parameter_description> the #GValue being dropped
+<parameter_description> the `GValue` being dropped
</parameter_description>
</parameter>
<parameter name="x">
@@ -4895,7 +4976,7 @@ reject the drop later, it should call [method@Gtk.DropTargetAsync.reject_drop].
</parameter_description>
</parameter>
<parameter name="drop">
-<parameter_description> the #GdkDrop
+<parameter_description> the `GdkDrop`
</parameter_description>
</parameter>
</parameters>
@@ -4917,7 +4998,7 @@ It can be used to set up custom highlighting.
</parameter_description>
</parameter>
<parameter name="drop">
-<parameter_description> the #GdkDrop
+<parameter_description> the `GdkDrop`
</parameter_description>
</parameter>
<parameter name="x">
@@ -4947,7 +5028,7 @@ Its main purpose it to undo things done in
</parameter_description>
</parameter>
<parameter name="drop">
-<parameter_description> the #GdkDrop
+<parameter_description> the `GdkDrop`
</parameter_description>
</parameter>
</parameters>
@@ -4966,7 +5047,7 @@ Emitted while the pointer is moving over the drop target.
</parameter_description>
</parameter>
<parameter name="drop">
-<parameter_description> the #GdkDrop
+<parameter_description> the `GdkDrop`
</parameter_description>
</parameter>
<parameter name="x">
@@ -5007,7 +5088,7 @@ To receive the data, use one of the read functions provided by
</parameter_description>
</parameter>
<parameter name="drop">
-<parameter_description> the #GdkDrop
+<parameter_description> the `GdkDrop`
</parameter_description>
</parameter>
<parameter name="x">
@@ -5293,7 +5374,7 @@ A list of Pango attributes to apply to the text of the entry.
This is mainly useful to change the size or weight of the text.
-The #PangoAttribute's @start_index and @end_index must refer to the
+The `PangoAttribute`'s @start_index and @end_index must refer to the
[class@Gtk.EntryBuffer] text, i.e. without the preedit string.
</description>
@@ -5611,7 +5692,7 @@ use %G_CONNECT_AFTER.
</description>
<parameters>
<parameter name="buffer">
-<parameter_description> a #GtkEntryBuffer
+<parameter_description> a `GtkEntryBuffer`
</parameter_description>
</parameter>
<parameter name="position">
@@ -5633,7 +5714,7 @@ This signal is emitted after text is inserted into the buffer.
</description>
<parameters>
<parameter name="buffer">
-<parameter_description> a #GtkEntryBuffer
+<parameter_description> a `GtkEntryBuffer`
</parameter_description>
</parameter>
<parameter name="position">
@@ -5713,7 +5794,7 @@ whole prefix and select the newly inserted part.
Applications may connect to this signal in order to insert only a
smaller part of the @prefix into the entry - e.g. the entry used in
-the #GtkFileChooser inserts only the part of the prefix up to the
+the `GtkFileChooser` inserts only the part of the prefix up to the
next '/'.
@@ -6002,7 +6083,7 @@ Emitted whenever a key is pressed.
</parameter_description>
</parameter>
<parameter name="state">
-<parameter_description> the bitmask, representing the state of modifier keys and pointer buttons. See
#GdkModifierType.
+<parameter_description> the bitmask, representing the state of modifier keys and pointer buttons. See
`GdkModifierType`.
</parameter_description>
</parameter>
</parameters>
@@ -6029,7 +6110,7 @@ Emitted whenever a key is released.
</parameter_description>
</parameter>
<parameter name="state">
-<parameter_description> the bitmask, representing the state of modifier keys and pointer buttons. See
#GdkModifierType.
+<parameter_description> the bitmask, representing the state of modifier keys and pointer buttons. See
`GdkModifierType`.
</parameter_description>
</parameter>
</parameters>
@@ -6052,7 +6133,7 @@ Emitted whenever the state of modifier keys and pointer buttons change.
</parameter>
<parameter name="state">
<parameter_description> the bitmask, representing the new state of modifier keys and
-pointer buttons. See #GdkModifierType.
+pointer buttons. See `GdkModifierType`.
</parameter_description>
</parameter>
</parameters>
@@ -6795,7 +6876,7 @@ documentation for details.
</description>
<parameters>
<parameter name="self">
-<parameter_description> The #GtkFilter
+<parameter_description> The `GtkFilter`
</parameter_description>
</parameter>
<parameter name="change">
@@ -6968,7 +7049,7 @@ move by individual children
</parameter_description>
</parameter>
<parameter name="step">
-<parameter_description> the granularity fo the move, as a #GtkMovementStep
+<parameter_description> the granularity fo the move, as a `GtkMovementStep`
</parameter_description>
</parameter>
<parameter name="count">
@@ -8080,7 +8161,7 @@ The amount of space between two consecutive rows.
<property name="GtkGridLayout:baseline-row">
<description>
-The row to align to the baseline, when #GtkWidget:valign is set
+The row to align to the baseline, when `GtkWidget:valign` is set
to %GTK_ALIGN_BASELINE.
</description>
@@ -8483,7 +8564,7 @@ to be extended by adding icons in the user’s home directory.)
The name of the icon theme that is being used.
Unless set to a different value, this will be the value of
-the #GtkSettings:gtk-icon-theme-name property of the #GtkSettings
+the `GtkSettings:gtk-icon-theme-name` property of the `GtkSettings`
object associated to the display of the icontheme object.
</description>
@@ -8545,7 +8626,7 @@ Space, Return or Enter is pressed.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> the #GtkTreePath for the activated item
+<parameter_description> the `GtkTreePath` for the activated item
</parameter_description>
</parameter>
</parameters>
@@ -8576,7 +8657,7 @@ the Shift modifier.
</parameter_description>
</parameter>
<parameter name="step">
-<parameter_description> the granularity of the move, as a #GtkMovementStep
+<parameter_description> the granularity of the move, as a `GtkMovementStep`
</parameter_description>
</parameter>
<parameter name="count">
@@ -8707,10 +8788,10 @@ will be emitted after a single click.
<property name="GtkIconView:cell-area">
<description>
-The #GtkCellArea used to layout cell renderers for this view.
+The `GtkCellArea` used to layout cell renderers for this view.
If no area is specified when creating the icon view with gtk_icon_view_new_with_area()
-a #GtkCellAreaBox will be used.
+a `GtkCellAreaBox` will be used.
</description>
</property>
@@ -8769,7 +8850,7 @@ at the edges of the icon view.
<description>
The ::markup-column property contains the number of the model column
containing markup information to be displayed. The markup column must be
-of type #G_TYPE_STRING. If this property and the :text-column property
+of type `G_TYPE_STRING`. If this property and the :text-column property
are both set to column numbers, it overrides the text column.
If both are set to -1, no texts are displayed.
@@ -8780,7 +8861,7 @@ If both are set to -1, no texts are displayed.
<description>
The ::pixbuf-column property contains the number of the model column
containing the pixbufs which are displayed. The pixbuf column must be
-of type #GDK_TYPE_PIXBUF. Setting this property to -1 turns off the
+of type `GDK_TYPE_PIXBUF`. Setting this property to -1 turns off the
display of pixbufs.
</description>
@@ -8805,7 +8886,7 @@ the rows of the icon view.
<property name="GtkIconView:selection-mode">
<description>
The ::selection-mode property specifies the selection mode of
-icon view. If the mode is #GTK_SELECTION_MULTIPLE, rubberband selection
+icon view. If the mode is %GTK_SELECTION_MULTIPLE, rubberband selection
is enabled, for the other modes, only keyboard selection is possible.
</description>
@@ -8823,7 +8904,7 @@ the cells (i.e. the icon and the text) of an item.
<description>
The ::text-column property contains the number of the model column
containing the texts which are displayed. The text column must be
-of type #G_TYPE_STRING. If this property and the :markup-column
+of type `G_TYPE_STRING`. If this property and the :markup-column
property are both set to -1, no texts are displayed.
</description>
@@ -8960,11 +9041,11 @@ functions), but they will all return %NULL values.
</parameter_description>
</parameter>
<parameter name="GTK_IMAGE_GICON">
-<parameter_description> the widget contains a #GIcon
+<parameter_description> the widget contains a `GIcon`
</parameter_description>
</parameter>
<parameter name="GTK_IMAGE_PAINTABLE">
-<parameter_description> the widget contains a #GdkPaintable
+<parameter_description> the widget contains a `GdkPaintable`
</parameter_description>
</parameter>
</parameters>
@@ -9303,7 +9384,7 @@ There are too many key combinations to list them all here.
</parameter_description>
</parameter>
<parameter name="step">
-<parameter_description> the granularity of the move, as a #GtkMovementStep
+<parameter_description> the granularity of the move, as a `GtkMovementStep`
</parameter_description>
</parameter>
<parameter name="count">
@@ -9568,9 +9649,9 @@ Determines the minimum value of the interval that can be displayed by the bar.
Determines the way `GtkLevelBar` interprets the value properties to draw the
level fill area.
-Specifically, when the value is #GTK_LEVEL_BAR_MODE_CONTINUOUS,
+Specifically, when the value is %GTK_LEVEL_BAR_MODE_CONTINUOUS,
`GtkLevelBar` will draw a single block representing the current value in
-that area; when the value is #GTK_LEVEL_BAR_MODE_DISCRETE,
+that area; when the value is %GTK_LEVEL_BAR_MODE_DISCRETE,
the widget will draw a succession of separate blocks filling the
draw area, with the number of blocks being equal to the units separating
the integral roundings of [property@Gtk.LevelBar:min-value] and
@@ -9705,7 +9786,7 @@ by returning %TRUE from your handler.
</description>
<parameters>
<parameter name="button">
-<parameter_description> the #GtkLinkButton that emitted the signal
+<parameter_description> the `GtkLinkButton` that emitted the signal
</parameter_description>
</parameter>
</parameters>
@@ -10214,6 +10295,15 @@ The `GtkPopover` that will be popped up when the button is clicked.
</description>
</property>
+<property name="GtkMenuButton:primary">
+<description>
+Whether the menu button acts as a primary menu.
+
+Primary menus can be opened using the <kbd>F10</kbd> key
+
+</description>
+</property>
+
<property name="GtkMenuButton:use-underline">
<description>
If set an underscore in the text indicates a mnemonic.
@@ -10311,14 +10401,14 @@ The key value for the trigger.
<property name="GtkModelButton:active">
<description>
The state of the button. This is reflecting the state of the associated
-#GAction.
+GAction.
</description>
</property>
<property name="GtkModelButton:icon">
<description>
-A #GIcon that will be used if iconic appearance for the button is
+A GIcon that will be used if iconic appearance for the button is
desired.
</description>
@@ -10335,7 +10425,7 @@ horizontal sections of linked buttons.
<property name="GtkModelButton:indicator-size-group">
<description>
-Containers like #GtkPopoverMenu can provide a size group
+Containers like GtkPopoverMenu can provide a size group
in this property to align the checks and radios of all
the model buttons in a menu.
@@ -10352,7 +10442,7 @@ The name of a submenu to open when the button is activated. * If this is set, t
<property name="GtkModelButton:role">
<description>
Specifies whether the button is a plain, check or radio button.
-When #GtkActionable:action-name is set, the role will be determined
+When GtkActionable:action-name is set, the role will be determined
from the action and does not have to be set explicitly.
</description>
@@ -10540,8 +10630,8 @@ necessary properties to the notebook (e.g. the
</parameter_description>
</parameter>
</parameters>
-<return> a `GtkNotebook` that @page should be
-added to, or %NULL.
+<return> a `GtkNotebook` that
+@page should be added to
</return>
</signal>
@@ -10557,7 +10647,7 @@ right after a page is added to the notebook.
</parameter_description>
</parameter>
<parameter name="child">
-<parameter_description> the child #GtkWidget affected
+<parameter_description> the child `GtkWidget` affected
</parameter_description>
</parameter>
<parameter name="page_num">
@@ -10580,7 +10670,7 @@ right after a page is removed from the notebook.
</parameter_description>
</parameter>
<parameter name="child">
-<parameter_description> the child #GtkWidget affected
+<parameter_description> the child `GtkWidget` affected
</parameter_description>
</parameter>
<parameter name="page_num">
@@ -10603,7 +10693,7 @@ right after a page has been reordered.
</parameter_description>
</parameter>
<parameter name="child">
-<parameter_description> the child #GtkWidget affected
+<parameter_description> the child `GtkWidget` affected
</parameter_description>
</parameter>
<parameter name="page_num">
@@ -10931,7 +11021,7 @@ to its contents.
</description>
<parameters>
<parameter name="overlay">
-<parameter_description> the #GtkOverlay
+<parameter_description> the `GtkOverlay`
</parameter_description>
</parameter>
<parameter name="widget">
@@ -11173,7 +11263,7 @@ This is a [keybinding signal](class.SignalAction.html).
</parameter_description>
</parameter>
<parameter name="scroll_type">
-<parameter_description> a #GtkScrollType
+<parameter_description> a `GtkScrollType`
</parameter_description>
</parameter>
</parameters>
@@ -11350,7 +11440,7 @@ Flags that influence the behavior of gtk_widget_pick().
</parameter_description>
</parameter>
<parameter name="GTK_PICK_NON_TARGETABLE">
-<parameter_description> Include widgets that are marked as non-targetable. See #GtkWidget:can-target
+<parameter_description> Include widgets that are marked as non-targetable. See `GtkWidget:can-target`
</parameter_description>
</parameter>
</parameters>
@@ -11693,7 +11783,7 @@ to obtain the new status.
</description>
<parameters>
<parameter name="job">
-<parameter_description> the #GtkPrintJob object on which the signal was emitted
+<parameter_description> the `GtkPrintJob` object on which the signal was emitted
</parameter_description>
</parameter>
</parameters>
@@ -11783,7 +11873,7 @@ information you need from the widgets.
</parameter>
</parameters>
<return> A custom widget that gets embedded in
-the print dialog, or %NULL
+the print dialog
</return>
</signal>
@@ -11999,7 +12089,7 @@ finished by calling [method@Gtk.PrintOperationPreview.end_preview]
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> the `GtkWindow` to use as window parent, or %NULL
+<parameter_description> the `GtkWindow` to use as window parent
</parameter_description>
</parameter>
</parameters>
@@ -12365,7 +12455,7 @@ A handler for this signal can be used for setup tasks.
</parameter_description>
</parameter>
<parameter name="context">
-<parameter_description> the current #GtkPrintContext
+<parameter_description> the current `GtkPrintContext`
</parameter_description>
</parameter>
</parameters>
@@ -12570,7 +12660,7 @@ actually obtained.
</description>
<parameters>
<parameter name="printer">
-<parameter_description> the #GtkPrinter on which the signal is emitted
+<parameter_description> the `GtkPrinter` on which the signal is emitted
</parameter_description>
</parameter>
<parameter name="success">
@@ -12734,7 +12824,7 @@ target is.
</parameter>
<parameter name="GTK_LIMIT_SAME_NATIVE">
<parameter_description> Events are only handled if their target
-is in the same #GtkNative as the event controllers widget. Note
+is in the same `GtkNative` as the event controllers widget. Note
that some event types have two targets (origin and destination).
</parameter_description>
</parameter>
@@ -12775,7 +12865,7 @@ grab broken handlers for controllers in this phase to be run.
<property name="GtkPropertyLookupListModel:item-type">
<description>
-The #GType for elements of this object
+The `GType` for elements of this object
</description>
</property>
@@ -12965,7 +13055,7 @@ The size of the recently used resources list.
<enum name="GtkRecentManagerError">
<description>
-Error codes for #GtkRecentManager operations
+Error codes for `GtkRecentManager` operations
</description>
<parameters>
@@ -13253,7 +13343,7 @@ the @icons array, the first one will be used for the bottom
50% of the scale, and the second one for the top 50%.
It is recommended to use at least 3 icons so that the
-#GtkScaleButton reflects the current value of the scale
+`GtkScaleButton` reflects the current value of the scale
better for the users.
</description>
@@ -14218,7 +14308,7 @@ scrollbars.
<property name="GtkSettings:gtk-primary-button-warps-slider">
<description>
If the value of this setting is %TRUE, clicking the primary button in a
-#GtkRange trough will move the slider, and hence set the range’s value, to
+`GtkRange` trough will move the slider, and hence set the range’s value, to
the point that you clicked.
If it is %FALSE, a primary click will cause the slider/value to move
@@ -14504,7 +14594,7 @@ the widget the controller belongs to.
</parameter>
<parameter name="GTK_SHORTCUT_SCOPE_MANAGED">
<parameter_description> Shortcuts are handled by
-the first ancestor that is a #GtkShortcutManager
+the first ancestor that is a `GtkShortcutManager`
</parameter_description>
</parameter>
<parameter name="GTK_SHORTCUT_SCOPE_GLOBAL">
@@ -14874,7 +14964,7 @@ in this signal.
</parameter_description>
</parameter>
<parameter name="listitem">
-<parameter_description> The #GtkListItem to bind
+<parameter_description> The `GtkListItem` to bind
</parameter_description>
</parameter>
</parameters>
@@ -14897,7 +14987,7 @@ of this signal and can be used to undo everything done in this signal.
</parameter_description>
</parameter>
<parameter name="listitem">
-<parameter_description> The #GtkListItem to set up
+<parameter_description> The `GtkListItem` to set up
</parameter_description>
</parameter>
</parameters>
@@ -14920,7 +15010,7 @@ signal and should be used to undo everything done in that signal.
</parameter_description>
</parameter>
<parameter name="listitem">
-<parameter_description> The #GtkListItem to teardown
+<parameter_description> The `GtkListItem` to teardown
</parameter_description>
</parameter>
</parameters>
@@ -14942,7 +15032,7 @@ signal and should be used to undo everything done in that signal.
</parameter_description>
</parameter>
<parameter name="listitem">
-<parameter_description> The #GtkListItem to unbind
+<parameter_description> The `GtkListItem` to unbind
</parameter_description>
</parameter>
</parameters>
@@ -15121,7 +15211,7 @@ the sort order without a full resorting. Refer to the
</description>
<parameters>
<parameter name="self">
-<parameter_description> The #GtkSorter
+<parameter_description> The `GtkSorter`
</parameter_description>
</parameter>
<parameter name="change">
@@ -15170,7 +15260,7 @@ Describes the type of order that a `GtkSorter` may produce.
</description>
<parameters>
<parameter name="GTK_SORTER_ORDER_PARTIAL">
-<parameter_description> A partial order. Any #GtkOrdering is possible.
+<parameter_description> A partial order. Any `GtkOrdering` is possible.
</parameter_description>
</parameter>
<parameter name="GTK_SORTER_ORDER_NONE">
@@ -15206,7 +15296,7 @@ The default bindings for this signal are Up/Down and PageUp/PageDown.
</parameter_description>
</parameter>
<parameter name="scroll">
-<parameter_description> a #GtkScrollType to specify the speed and amount of change
+<parameter_description> a `GtkScrollType` to specify the speed and amount of change
</parameter_description>
</parameter>
</parameters>
@@ -15375,12 +15465,12 @@ See [method@Gtk.SpinButton.set_update_policy].
</description>
<parameters>
<parameter name="GTK_UPDATE_ALWAYS">
-<parameter_description> When refreshing your #GtkSpinButton, the value is
+<parameter_description> When refreshing your `GtkSpinButton`, the value is
always displayed
</parameter_description>
</parameter>
<parameter name="GTK_UPDATE_IF_VALID">
-<parameter_description> When refreshing your #GtkSpinButton, the value is
+<parameter_description> When refreshing your `GtkSpinButton`, the value is
only displayed if it is valid within the bounds of the spin button's
adjustment
</parameter_description>
@@ -15883,7 +15973,7 @@ CSS properties for each node
</parameter_description>
</parameter>
<parameter name="GTK_STYLE_CONTEXT_PRINT_SHOW_CHANGE">
-<parameter_description> Show information about
+<parameter_description> Show information about
what changes affect the styles
</parameter_description>
</parameter>
@@ -15959,7 +16049,7 @@ See [signal@GtkSwitch::state-set] for details.
<enum name="GtkSystemSetting">
<description>
-Values that can be passed to the GtkWidgetClass.system_setting_changed
+Values that can be passed to the [vfunc@Gtk.Widget.system_setting_changed]
vfunc.
The values indicate which system setting has changed.
@@ -15972,19 +16062,21 @@ More values may be added over time.
</description>
<parameters>
<parameter name="GTK_SYSTEM_SETTING_DPI">
-<parameter_description> the #GtkSettings:gtk-xft-dpi setting has changed
+<parameter_description> the [property@Gtk.Settings:gtk-xft-dpi] setting has changed
</parameter_description>
</parameter>
<parameter name="GTK_SYSTEM_SETTING_FONT_NAME">
-<parameter_description> The #GtkSettings:gtk-font-name setting has changed
+<parameter_description> The [property@Gtk.Settings:gtk-font-name] setting has changed
</parameter_description>
</parameter>
<parameter name="GTK_SYSTEM_SETTING_FONT_CONFIG">
<parameter_description> The font configuration has changed in a way that
requires text to be redrawn. This can be any of the
-#GtkSettings:gtk-xft-antialias, #GtkSettings:gtk-xft-hinting,
-#GtkSettings:gtk-xft-hintstyle, #GtkSettings:gtk-xft-rgba or
-#GtkSettings:gtk-fontconfig-timestamp settings
+[property@Gtk.Settings:gtk-xft-antialias],
+[property@Gtk.Settings:gtk-xft-hinting],
+[property@Gtk.Settings:gtk-xft-hintstyle],
+[property@Gtk.Settings:gtk-xft-rgba] or
+[property@Gtk.Settings:gtk-fontconfig-timestamp] settings
</parameter_description>
</parameter>
<parameter name="GTK_SYSTEM_SETTING_DISPLAY">
@@ -16096,7 +16188,7 @@ for deleting a word.
</parameter_description>
</parameter>
<parameter name="type">
-<parameter_description> the granularity of the deletion, as a #GtkDeleteType
+<parameter_description> the granularity of the deletion, as a `GtkDeleteType`
</parameter_description>
</parameter>
<parameter name="count">
@@ -16132,7 +16224,7 @@ This signal has no default bindings.
<signal name="GtkText::insert-emoji">
<description>
-Emitted to present the Emoji chooser for the @self.
+Emitted to present the Emoji chooser for the widget.
This is a [keybinding signal](class.SignalAction.html).
@@ -16180,7 +16272,7 @@ move by individual characters/lines
</parameter_description>
</parameter>
<parameter name="step">
-<parameter_description> the granularity of the move, as a #GtkMovementStep
+<parameter_description> the granularity of the move, as a `GtkMovementStep`
</parameter_description>
</parameter>
<parameter name="count">
@@ -16606,7 +16698,7 @@ it must not invalidate the @location iter (or has to
revalidate it). The default signal handler revalidates
it to point to the end of the inserted text.
-See also: [method@Gtk,TextBuffer.insert],
+See also: [method@Gtk.TextBuffer.insert],
[method@Gtk.TextBuffer.insert_range].
</description>
@@ -16819,6 +16911,13 @@ Whether the buffer has some text currently selected.
</description>
</property>
+<property name="GtkTextBuffer:tag-table">
+<description>
+The GtkTextTagTable for the buffer.
+
+</description>
+</property>
+
<property name="GtkTextBuffer:text">
<description>
The text content of the buffer.
@@ -16853,7 +16952,7 @@ Reading directions for text.
<enum name="GtkTextExtendSelection">
<description>
Granularity types that extend the text selection. Use the
-#GtkTextView::extend-selection signal to customize the selection.
+`GtkTextView::extend-selection` signal to customize the selection.
</description>
<parameters>
@@ -17426,7 +17525,7 @@ deleting a word backwards.
</parameter_description>
</parameter>
<parameter name="type">
-<parameter_description> the granularity of the deletion, as a #GtkDeleteType
+<parameter_description> the granularity of the deletion, as a `GtkDeleteType`
</parameter_description>
</parameter>
<parameter name="count">
@@ -17546,7 +17645,7 @@ move horizontally by pages
</parameter_description>
</parameter>
<parameter name="step">
-<parameter_description> the granularity of the move, as a #GtkMovementStep
+<parameter_description> the granularity of the move, as a `GtkMovementStep`
</parameter_description>
</parameter>
<parameter name="count">
@@ -17579,7 +17678,7 @@ There are no default bindings for this signal.
</parameter_description>
</parameter>
<parameter name="step">
-<parameter_description> the granularity of the movement, as a #GtkScrollStep
+<parameter_description> the granularity of the movement, as a `GtkScrollStep`
</parameter_description>
</parameter>
<parameter name="count">
@@ -17856,15 +17955,15 @@ Don't confuse this property with [property@Gtk.Widget:margin-top].
<property name="GtkTextViewChild:window-type">
<description>
-The "window-type" property is the #GtkTextWindowType of the
-#GtkTextView that the child is attached.
+The "window-type" property is the `GtkTextWindowType` of the
+`GtkTextView` that the child is attached.
</description>
</property>
<enum name="GtkTextViewLayer">
<description>
-Used to reference the layers of #GtkTextView for the purpose of customized
+Used to reference the layers of `GtkTextView` for the purpose of customized
drawing with the ::snapshot_layer vfunc.
</description>
@@ -17882,7 +17981,7 @@ drawing with the ::snapshot_layer vfunc.
<enum name="GtkTextWindowType">
<description>
-Used to reference the parts of #GtkTextView.
+Used to reference the parts of `GtkTextView`.
</description>
<parameters>
@@ -18085,15 +18184,15 @@ This signal is emitted when a row in the model has changed.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> the #GtkTreeModel on which the signal is emitted
+<parameter_description> the `GtkTreeModel` on which the signal is emitted
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct identifying the changed row
+<parameter_description> a `GtkTreePath` identifying the changed row
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a valid #GtkTreeIter-struct pointing to the changed row
+<parameter_description> a valid `GtkTreeIter` pointing to the changed row
</parameter_description>
</parameter>
</parameters>
@@ -18114,11 +18213,11 @@ the row previously was at. It may not be a valid location anymore.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> the #GtkTreeModel on which the signal is emitted
+<parameter_description> the `GtkTreeModel` on which the signal is emitted
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct identifying the row
+<parameter_description> a `GtkTreePath` identifying the row
</parameter_description>
</parameter>
</parameters>
@@ -18133,15 +18232,15 @@ row or lost its last child row.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> the #GtkTreeModel on which the signal is emitted
+<parameter_description> the `GtkTreeModel` on which the signal is emitted
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct identifying the row
+<parameter_description> a `GtkTreePath` identifying the row
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a valid #GtkTreeIter-struct pointing to the row
+<parameter_description> a valid `GtkTreeIter` pointing to the row
</parameter_description>
</parameter>
</parameters>
@@ -18160,15 +18259,15 @@ then fill it with the desired values.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> the #GtkTreeModel on which the signal is emitted
+<parameter_description> the `GtkTreeModel` on which the signal is emitted
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct identifying the new row
+<parameter_description> a `GtkTreePath` identifying the new row
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a valid #GtkTreeIter-struct pointing to the new row
+<parameter_description> a valid `GtkTreeIter` pointing to the new row
</parameter_description>
</parameter>
</parameters>
@@ -18178,7 +18277,7 @@ then fill it with the desired values.
<signal name="GtkTreeModel::rows-reordered">
<description>
This signal is emitted when the children of a node in the
-#GtkTreeModel have been reordered.
+`GtkTreeModel` have been reordered.
Note that this signal is not emitted
when rows are reordered by DND, since this is implemented
@@ -18187,16 +18286,16 @@ by removing and then reinserting the row.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> the #GtkTreeModel on which the signal is emitted
+<parameter_description> the `GtkTreeModel` on which the signal is emitted
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct identifying the tree node whose children
+<parameter_description> a `GtkTreePath` identifying the tree node whose children
have been reordered
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a valid #GtkTreeIter-struct pointing to the node whose children
+<parameter_description> a valid `GtkTreeIter` pointing to the node whose children
have been reordered, or %NULL if the depth of @path is 0
</parameter_description>
</parameter>
@@ -18212,11 +18311,11 @@ i.e. @new_order`[newpos] = oldpos`
<enum name="GtkTreeModelFlags">
<description>
-These flags indicate various properties of a #GtkTreeModel.
+These flags indicate various properties of a `GtkTreeModel`.
-They are returned by gtk_tree_model_get_flags(), and must be
+They are returned by [method@Gtk.TreeModel.get_flags], and must be
static for the lifetime of the object. A more complete description
-of #GTK_TREE_MODEL_ITERS_PERSIST can be found in the overview of
+of %GTK_TREE_MODEL_ITERS_PERSIST can be found in the overview of
this section.
</description>
@@ -18305,7 +18404,7 @@ The position of the cursor (focused cell) has changed.
<signal name="GtkTreeView::move-cursor">
<description>
-The #GtkTreeView::move-cursor signal is a [keybinding
+The `GtkTreeView`::move-cursor signal is a [keybinding
signal][GtkSignalAction] which gets emitted when the user
presses one of the cursor keys.
@@ -18313,7 +18412,7 @@ Applications should not connect to it, but may emit it with
g_signal_emit_by_name() if they need to control the cursor
programmatically. In contrast to gtk_tree_view_set_cursor() and
gtk_tree_view_set_cursor_on_cell() when moving horizontally
-#GtkTreeView::move-cursor does not reset the current selection.
+`GtkTreeView`::move-cursor does not reset the current selection.
</description>
@@ -18323,7 +18422,7 @@ gtk_tree_view_set_cursor_on_cell() when moving horizontally
</parameter_description>
</parameter>
<parameter name="step">
-<parameter_description> the granularity of the move, as a #GtkMovementStep.
+<parameter_description> the granularity of the move, as a `GtkMovementStep`.
%GTK_MOVEMENT_LOGICAL_POSITIONS, %GTK_MOVEMENT_VISUAL_POSITIONS,
%GTK_MOVEMENT_DISPLAY_LINES, %GTK_MOVEMENT_PAGES and
%GTK_MOVEMENT_BUFFER_ENDS are supported.
@@ -18361,7 +18460,7 @@ Space, Shift+Space, Return or Enter is pressed.
For selection handling refer to the
[tree widget conceptual overview][TreeWidget]
-as well as #GtkTreeSelection.
+as well as `GtkTreeSelection`.
</description>
<parameters>
@@ -18370,11 +18469,11 @@ as well as #GtkTreeSelection.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> the #GtkTreePath for the activated row
+<parameter_description> the `GtkTreePath` for the activated row
</parameter_description>
</parameter>
<parameter name="column">
-<parameter_description> the #GtkTreeViewColumn in which the activation occurred
+<parameter_description> the `GtkTreeViewColumn` in which the activation occurred
</parameter_description>
</parameter>
</parameters>
@@ -18486,7 +18585,7 @@ will be emitted after a single click.
<property name="GtkTreeView:fixed-height-mode">
<description>
Setting the ::fixed-height-mode property to %TRUE speeds up
-#GtkTreeView by assuming that all rows have the same height.
+`GtkTreeView` by assuming that all rows have the same height.
Only enable this option if all rows are the same height.
Please see gtk_tree_view_set_fixed_height_mode() for more
information on this option.
@@ -18501,7 +18600,7 @@ Hover expansion makes rows expand or collapse if the pointer moves
over them.
This mode is primarily intended for treeviews in popups, e.g.
-in #GtkComboBox or #GtkEntryCompletion.
+in `GtkComboBox` or `GtkEntryCompletion`.
</description>
</property>
@@ -18514,7 +18613,7 @@ Currently, this works only for the selection modes
%GTK_SELECTION_SINGLE and %GTK_SELECTION_BROWSE.
This mode is primarily intended for treeviews in popups, e.g.
-in #GtkComboBox or #GtkEntryCompletion.
+in `GtkComboBox` or `GtkEntryCompletion`.
</description>
</property>
@@ -18540,7 +18639,7 @@ Emitted when the column's header has been clicked.
</description>
<parameters>
<parameter name="column">
-<parameter_description> the #GtkTreeViewColumn that emitted the signal
+<parameter_description> the `GtkTreeViewColumn` that emitted the signal
</parameter_description>
</parameter>
</parameters>
@@ -18549,10 +18648,10 @@ Emitted when the column's header has been clicked.
<property name="GtkTreeViewColumn:cell-area">
<description>
-The #GtkCellArea used to layout cell renderers for this column.
+The `GtkCellArea` used to layout cell renderers for this column.
If no area is specified when creating the tree view column with gtk_tree_view_column_new_with_area()
-a horizontally oriented #GtkCellAreaBox will be used.
+a horizontally oriented `GtkCellAreaBox` will be used.
</description>
</property>
@@ -18893,7 +18992,7 @@ been emitted, relative to @widget's top
</parameter_description>
</parameter>
<parameter name="tooltip">
-<parameter_description> a #GtkTooltip
+<parameter_description> a `GtkTooltip`
</parameter_description>
</parameter>
</parameters>
@@ -19685,7 +19784,7 @@ freeze and thaw calls are balanced.
</description>
<parameters>
<parameter name="model">
-<parameter_description> a #GtkFileSystemModel
+<parameter_description> a `GtkFileSystemModel`
</parameter_description>
</parameter>
</parameters>
@@ -19716,8 +19815,8 @@ Creates a new section in the "Credits" page.
<function name="gtk_about_dialog_get_artists">
<description>
-Returns the string which are displayed in the "Artists" tab
-of the secondary credits dialog.
+Returns the names of the artists which are displayed
+in the credits page.
</description>
@@ -19728,15 +19827,14 @@ of the secondary credits dialog.
</parameter>
</parameters>
<return> A
-`NULL`-terminated string array containing the artists. The array is
-owned by the about dialog and must not be modified.
+`NULL`-terminated string array containing the artists
</return>
</function>
<function name="gtk_about_dialog_get_authors">
<description>
-Returns the string which are displayed in the authors tab
-of the secondary credits dialog.
+Returns the names of the authors which are displayed
+in the credits page.
</description>
@@ -19747,8 +19845,7 @@ of the secondary credits dialog.
</parameter>
</parameters>
<return> A
-`NULL`-terminated string array containing the authors. The array is
-owned by the about dialog and must not be modified.
+`NULL`-terminated string array containing the authors
</return>
</function>
@@ -19764,8 +19861,7 @@ Returns the comments string.
</parameter_description>
</parameter>
</parameters>
-<return> The comments. The string is owned by the about
-dialog and must not be modified.
+<return> The comments
</return>
</function>
@@ -19781,15 +19877,14 @@ Returns the copyright string.
</parameter_description>
</parameter>
</parameters>
-<return> The copyright string. The string is owned by the about
-dialog and must not be modified.
+<return> The copyright string
</return>
</function>
<function name="gtk_about_dialog_get_documenters">
<description>
-Returns the string which are displayed in the "Documenters"
-tab of the secondary credits dialog.
+Returns the name of the documenters which are displayed
+in the credits page.
</description>
@@ -19800,8 +19895,7 @@ tab of the secondary credits dialog.
</parameter>
</parameters>
<return> A
-`NULL`-terminated string array containing the documenters. The
-array is owned by the about dialog and must not be modified.
+`NULL`-terminated string array containing the documenters
</return>
</function>
@@ -19817,8 +19911,7 @@ Returns the license information.
</parameter_description>
</parameter>
</parameters>
-<return> The license information. The string is owned by the about
-dialog and must not be modified.
+<return> The license information
</return>
</function>
@@ -19852,8 +19945,7 @@ Returns the paintable displayed as logo in the about dialog.
</parameters>
<return> the paintable displayed as
logo or `NULL` if the logo is unset or has been set via
-[method@Gtk.AboutDialog.set_logo_icon_name]. The
-paintable is owned by the about dialog.
+[method@Gtk.AboutDialog.set_logo_icon_name]
</return>
</function>
@@ -19870,8 +19962,7 @@ Returns the icon name displayed as logo in the about dialog.
</parameter>
</parameters>
<return> the icon name displayed as logo,
-or `NULL` if the logo has been set via [method@Gtk.AboutDialog.set_logo].
-The string is owned by the dialog.
+or `NULL` if the logo has been set via [method@Gtk.AboutDialog.set_logo]
</return>
</function>
@@ -19887,8 +19978,7 @@ Returns the program name displayed in the about dialog.
</parameter_description>
</parameter>
</parameters>
-<return> The program name. The string is owned by the about
-dialog and must not be modified.
+<return> The program name
</return>
</function>
@@ -19911,7 +20001,7 @@ Returns the system information that is shown in the about dialog.
<function name="gtk_about_dialog_get_translator_credits">
<description>
Returns the translator credits string which is displayed
-in the translators tab of the secondary credits dialog.
+in the credits page.
</description>
@@ -19921,7 +20011,7 @@ in the translators tab of the secondary credits dialog.
</parameter_description>
</parameter>
</parameters>
-<return> The translator credits string.
+<return> The translator credits string
</return>
</function>
@@ -19937,8 +20027,7 @@ Returns the version string.
</parameter_description>
</parameter>
</parameters>
-<return> The version string. The string is owned by the about
-dialog and must not be modified.
+<return> The version string
</return>
</function>
@@ -19970,7 +20059,7 @@ Returns the label used for the website link.
</parameter_description>
</parameter>
</parameters>
-<return> The label used for the website link.
+<return> The label used for the website link
</return>
</function>
@@ -20005,8 +20094,8 @@ Creates a new `GtkAboutDialog`.
<function name="gtk_about_dialog_set_artists">
<description>
-Sets the strings which are displayed in the "Artists" tab
-of the secondary credits dialog.
+Sets the names of the artists to be displayed
+in the "Credits" page.
</description>
<parameters>
@@ -20025,8 +20114,8 @@ of the application
<function name="gtk_about_dialog_set_authors">
<description>
-Sets the strings which are displayed in the "Authors" tab
-of the secondary credits dialog.
+Sets the names of the authors which are displayed
+in the "Credits" page of the about dialog.
</description>
<parameters>
@@ -20084,8 +20173,8 @@ This should be a short string of one or two lines.
<function name="gtk_about_dialog_set_documenters">
<description>
-Sets the strings which are displayed in the "Documenters" tab
-of the credits dialog.
+Sets the names of the documenters which are displayed
+in the "Credits" page.
</description>
<parameters>
@@ -20104,10 +20193,10 @@ of the application
<function name="gtk_about_dialog_set_license">
<description>
-Sets the license information to be displayed in the secondary
-license dialog.
+Sets the license information to be displayed in the
+about dialog.
-If `license` is `NULL`, the license button is hidden.
+If `license` is `NULL`, the license page is hidden.
</description>
<parameters>
@@ -20185,7 +20274,8 @@ Sets the icon name to be displayed as logo in the about dialog.
<description>
Sets the name to display in the about dialog.
-If `name` is not set, it defaults to `g_get_application_name()`.
+If `name` is not set, the string returned
+by `g_get_application_name()` is used.
</description>
<parameters>
@@ -20207,7 +20297,7 @@ Sets the system information to be displayed in the about
dialog.
If `system_information` is `NULL`, the system information
-tab is hidden.
+page is hidden.
See [property@Gtk.AboutDialog:system-information].
@@ -20228,7 +20318,7 @@ See [property@Gtk.AboutDialog:system-information].
<function name="gtk_about_dialog_set_translator_credits">
<description>
Sets the translator credits string which is displayed in
-the translators tab of the secondary credits dialog.
+the credits page.
The intended use for this string is to display the translator
of the language which is currently used in the user interface.
@@ -20241,10 +20331,10 @@ gtk_about_dialog_set_translator_credits (GTK_ABOUT_DIALOG (about),
_("translator-credits"));
```
-It is a good idea to use the customary `msgid` “translator-credits” for this
-purpose, since translators will already know the purpose of that `msgid`, and
-since `GtkAboutDialog` will detect if “translator-credits” is untranslated
-and hide the tab.
+It is a good idea to use the customary `msgid` “translator-credits”
+for this purpose, since translators will already know the purpose of
+that `msgid`, and since `GtkAboutDialog` will detect if “translator-credits”
+is untranslated and omit translator credits.
</description>
<parameters>
@@ -20366,7 +20456,7 @@ which can be used to represent the accelerator to the user.
</parameter_description>
</parameter>
</parameters>
-<return> a newly-allocated string representing the accelerator.
+<return> a newly-allocated string representing the accelerator
</return>
</function>
@@ -20378,16 +20468,15 @@ into a string that can be displayed to the user.
The string may be translated.
This function is similar to [func@Gtk.accelerator_get_label],
-but handling keycodes.
-
-This is only useful for system-level components, applications
-should use gtk_accelerator_parse() instead.
+but handling keycodes. This is only useful for system-level
+components, applications should use [func@Gtk.accelerator_get_label]
+instead.
</description>
<parameters>
<parameter name="display">
-<parameter_description> a #GdkDisplay or %NULL to use the default display
+<parameter_description> a `GdkDisplay` or %NULL to use the default display
</parameter_description>
</parameter>
<parameter name="accelerator_key">
@@ -20403,7 +20492,7 @@ should use gtk_accelerator_parse() instead.
</parameter_description>
</parameter>
</parameters>
-<return> a newly-allocated string representing the accelerator.
+<return> a newly-allocated string representing the accelerator
</return>
</function>
@@ -20441,13 +20530,13 @@ into a string parseable by gtk_accelerator_parse_with_keycode().
This is similar to [func@Gtk.accelerator_name] but handling keycodes.
This is only useful for system-level components, applications
-should use gtk_accelerator_parse() instead.
+should use [func@Gtk.accelerator_name] instead.
</description>
<parameters>
<parameter name="display">
-<parameter_description> a #GdkDisplay or %NULL to use the default display
+<parameter_description> a `GdkDisplay` or %NULL to use the default display
</parameter_description>
</parameter>
<parameter name="accelerator_key">
@@ -20489,13 +20578,12 @@ be set to 0 (zero).
</parameter_description>
</parameter>
<parameter name="accelerator_key">
-<parameter_description> return location for accelerator
-keyval, or %NULL
+<parameter_description> return location for accelerator keyval
</parameter_description>
</parameter>
<parameter name="accelerator_mods">
<parameter_description> return location for accelerator
-modifier mask, %NULL
+modifier mask
</parameter_description>
</parameter>
</parameters>
@@ -20508,7 +20596,7 @@ Parses a string representing an accelerator.
This is similar to [func@Gtk.accelerator_parse] but handles keycodes as
well. This is only useful for system-level components, applications should
-use gtk_accelerator_parse() instead.
+use [func@Gtk.accelerator_parse] instead.
If @accelerator_codes is given and the result stored in it is non-%NULL,
the result must be freed with g_free().
@@ -20527,22 +20615,21 @@ If the parse fails, @accelerator_key, @accelerator_mods and
</parameter_description>
</parameter>
<parameter name="display">
-<parameter_description> the #GdkDisplay to look up @accelerator_codes in
+<parameter_description> the `GdkDisplay` to look up @accelerator_codes in
</parameter_description>
</parameter>
<parameter name="accelerator_key">
-<parameter_description> return location for accelerator
-keyval, or %NULL
+<parameter_description> return location for accelerator keyval
</parameter_description>
</parameter>
<parameter name="accelerator_codes">
<parameter_description>
-return location for accelerator keycodes, or %NULL
+return location for accelerator keycodes
</parameter_description>
</parameter>
<parameter name="accelerator_mods">
<parameter_description> return location for accelerator
-modifier mask, %NULL
+modifier mask
</parameter_description>
</parameter>
</parameters>
@@ -20601,11 +20688,11 @@ with gtk_accessible_update_property_value().
</description>
<parameters>
<parameter name="property">
-<parameter_description> a #GtkAccessibleProperty
+<parameter_description> a `GtkAccessibleProperty`
</parameter_description>
</parameter>
<parameter name="value">
-<parameter_description> an uninitialized #GValue
+<parameter_description> an uninitialized `GValue`
</parameter_description>
</parameter>
</parameters>
@@ -20622,11 +20709,11 @@ with gtk_accessible_update_relation_value().
</description>
<parameters>
<parameter name="relation">
-<parameter_description> a #GtkAccessibleRelation
+<parameter_description> a `GtkAccessibleRelation`
</parameter_description>
</parameter>
<parameter name="value">
-<parameter_description> an uninitialized #GValue
+<parameter_description> an uninitialized `GValue`
</parameter_description>
</parameter>
</parameters>
@@ -20697,11 +20784,11 @@ with gtk_accessible_update_relation_state().
</description>
<parameters>
<parameter name="state">
-<parameter_description> a #GtkAccessibleState
+<parameter_description> a `GtkAccessibleState`
</parameter_description>
</parameter>
<parameter name="value">
-<parameter_description> an uninitialized #GValue
+<parameter_description> an uninitialized `GValue`
</parameter_description>
</parameter>
</parameters>
@@ -20921,7 +21008,7 @@ Retrieves the center bar widget of the bar.
</parameter_description>
</parameter>
</parameters>
-<return> the center `GtkWidget` or %NULL.
+<return> the center `GtkWidget`
</return>
</function>
@@ -20938,7 +21025,7 @@ Gets whether the contents of the action bar are revealed.
</parameter>
</parameters>
<return> the current value of the [property@Gtk.ActionBar:revealed]
-property.
+property
</return>
</function>
@@ -21058,7 +21145,7 @@ Registers @observer as being interested in changes to @action_name on
</description>
<parameters>
<parameter name="observable">
-<parameter_description> a #GtkActionObservable
+<parameter_description> a `GtkActionObservable`
</parameter_description>
</parameter>
<parameter name="action_name">
@@ -21066,7 +21153,7 @@ Registers @observer as being interested in changes to @action_name on
</parameter_description>
</parameter>
<parameter name="observer">
-<parameter_description> the #GtkActionObserver to which the events will be reported
+<parameter_description> the `GtkActionObserver` to which the events will be reported
</parameter_description>
</parameter>
</parameters>
@@ -21084,7 +21171,7 @@ unregistered an equal number of times.
</description>
<parameters>
<parameter name="observable">
-<parameter_description> a #GtkActionObservable
+<parameter_description> a `GtkActionObservable`
</parameter_description>
</parameter>
<parameter name="action_name">
@@ -21092,7 +21179,7 @@ unregistered an equal number of times.
</parameter_description>
</parameter>
<parameter name="observer">
-<parameter_description> the #GtkActionObserver to which the events will be reported
+<parameter_description> the `GtkActionObserver` to which the events will be reported
</parameter_description>
</parameter>
</parameters>
@@ -21111,7 +21198,7 @@ Gets the action name for @actionable.
</parameter_description>
</parameter>
</parameters>
-<return> the action name, or %NULL if none is set
+<return> the action name
</return>
</function>
@@ -21154,7 +21241,7 @@ associated with the window.
</parameter_description>
</parameter>
<parameter name="action_name">
-<parameter_description> an action name, or %NULL
+<parameter_description> an action name
</parameter_description>
</parameter>
</parameters>
@@ -21219,7 +21306,7 @@ rendered inactive).
</parameter_description>
</parameter>
<parameter name="target_value">
-<parameter_description> a #GVariant to set as the target value, or %NULL
+<parameter_description> a `GVariant` to set as the target value
</parameter_description>
</parameter>
</parameters>
@@ -21989,7 +22076,7 @@ The dialog will show applications that can open the file.
</description>
<parameters>
<parameter name="parent">
-<parameter_description> a `GtkWindow`, or %NULL
+<parameter_description> a `GtkWindow`
</parameter_description>
</parameter>
<parameter name="flags">
@@ -22015,7 +22102,7 @@ The dialog will show applications that can open the content type.
</description>
<parameters>
<parameter name="parent">
-<parameter_description> a `GtkWindow`, or %NULL
+<parameter_description> a `GtkWindow`
</parameter_description>
</parameter>
<parameter name="flags">
@@ -22064,8 +22151,7 @@ Returns the currently selected application.
</parameter>
</parameters>
<return> a `GAppInfo` for the
-currently selected application, or %NULL if none is selected.
-Free with g_object_unref()
+currently selected application
</return>
</function>
@@ -22456,7 +22542,7 @@ for more information.
</description>
<parameters>
<parameter name="application">
-<parameter_description> a #GtkApplication
+<parameter_description> a `GtkApplication`
</parameter_description>
</parameter>
<parameter name="id">
@@ -22774,7 +22860,7 @@ See [method@Gtk.ApplicationWindow.set_help_overlay].
</parameter>
</parameters>
<return> the help overlay associated
-with @window, or %NULL
+with @window
</return>
</function>
@@ -23156,7 +23242,7 @@ Returns the page number of the current page.
</parameters>
<return> The index (starting from 0) of the current
page in the @assistant, or -1 if the @assistant has no pages,
-or no current page.
+or no current page
</return>
</function>
@@ -23486,7 +23572,7 @@ next visible page.
</parameter_description>
</parameter>
<parameter name="page_func">
-<parameter_description> the `GtkAssistant`PageFunc, or %NULL
+<parameter_description> the `GtkAssistantPageFunc`, or %NULL
to use the default one
</parameter_description>
</parameter>
@@ -23687,7 +23773,7 @@ Adds @value to @self if it wasn't part of it before.
</parameter>
</parameters>
<return> %TRUE if @value was not part of @self and @self
-was changed.
+was changed
</return>
</function>
@@ -24230,7 +24316,7 @@ Removes @value from @self if it was part of it before.
</parameter>
</parameters>
<return> %TRUE if @value was part of @self and @self
-was changed.
+was changed
</return>
</function>
@@ -24557,7 +24643,7 @@ Creates a new `GtkBookmarkList` with the given @attributes.
Sets the @attributes to be enumerated and starts the enumeration.
If @attributes is %NULL, no attributes will be queried, but a list
-of #GFileInfos will still be created.
+of `GFileInfo`s will still be created.
</description>
<parameters>
@@ -24635,7 +24721,6 @@ Creates a new bool filter.
<parameters>
<parameter name="expression">
<parameter_description> The expression to evaluate
-or %NULL for none
</parameter_description>
</parameter>
</parameters>
@@ -24684,13 +24769,13 @@ Sets whether the filter should invert the expression.
<function name="gtk_border_copy">
<description>
-Copies a #GtkBorder-struct.
+Copies a `GtkBorder`.
</description>
<parameters>
<parameter name="border_">
-<parameter_description> a #GtkBorder-struct
+<parameter_description> a `GtkBorder` struct
</parameter_description>
</parameter>
</parameters>
@@ -24700,12 +24785,12 @@ Copies a #GtkBorder-struct.
<function name="gtk_border_free">
<description>
-Frees a #GtkBorder-struct.
+Frees a `GtkBorder`.
</description>
<parameters>
<parameter name="border_">
-<parameter_description> a #GtkBorder-struct
+<parameter_description> a `GtkBorder` struct
</parameter_description>
</parameter>
</parameters>
@@ -24714,14 +24799,14 @@ Frees a #GtkBorder-struct.
<function name="gtk_border_new">
<description>
-Allocates a new #GtkBorder-struct and initializes its elements to zero.
+Allocates a new `GtkBorder` struct and initializes its elements to zero.
</description>
<parameters>
</parameters>
-<return> a newly allocated #GtkBorder-struct.
-Free with gtk_border_free()
+<return> a newly allocated `GtkBorder` struct.
+Free with [method Gtk Border free]
</return>
</function>
@@ -25020,7 +25105,7 @@ If @sibling is %NULL, move @child to the first position.
</parameter_description>
</parameter>
<parameter name="sibling">
-<parameter_description> the sibling to move @child after, or %NULL
+<parameter_description> the sibling to move @child after
</parameter_description>
</parameter>
</parameters>
@@ -25120,11 +25205,11 @@ elements, see gtk_buildable_parse_context_get_element_stack().
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkBuildablParseContext
+<parameter_description> a `GtkBuildablParseContext`
</parameter_description>
</parameter>
</parameters>
-<return> the name of the currently open element, or %NULL
+<return> the name of the currently open element
</return>
</function>
@@ -25132,7 +25217,7 @@ elements, see gtk_buildable_parse_context_get_element_stack().
<description>
Retrieves the element stack from the internal state of the parser.
-The returned #GPtrArray is an array of strings where the last item is
+The returned `GPtrArray` is an array of strings where the last item is
the currently open tag (as would be returned by
gtk_buildable_parse_context_get_element()) and the previous item is its
immediate parent.
@@ -25146,7 +25231,7 @@ processed.
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkBuildableParseContext
+<parameter_description> a `GtkBuildableParseContext`
</parameter_description>
</parameter>
</parameters>
@@ -25164,15 +25249,15 @@ semantics for what constitutes the "current" line number other than
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkBuildableParseContext
+<parameter_description> a `GtkBuildableParseContext`
</parameter_description>
</parameter>
<parameter name="line_number">
-<parameter_description> return location for a line number, or %NULL
+<parameter_description> return location for a line number
</parameter_description>
</parameter>
<parameter name="char_number">
-<parameter_description> return location for a char-on-line number, or %NULL
+<parameter_description> return location for a char-on-line number
</parameter_description>
</parameter>
</parameters>
@@ -25199,7 +25284,7 @@ interface.
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkBuildableParseContext
+<parameter_description> a `GtkBuildableParseContext`
</parameter_description>
</parameter>
</parameters>
@@ -25212,7 +25297,7 @@ interface.
Temporarily redirects markup data to a sub-parser.
This function may only be called from the start_element handler of
-a #GtkBuildableParser. It must be matched with a corresponding call to
+a `GtkBuildableParser`. It must be matched with a corresponding call to
gtk_buildable_parse_context_pop() in the matching end_element handler
(except in the case that the parser aborts due to an error).
@@ -25242,15 +25327,15 @@ has the same kind of API.
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkBuildableParseContext
+<parameter_description> a `GtkBuildableParseContext`
</parameter_description>
</parameter>
<parameter name="parser">
-<parameter_description> a #GtkBuildableParser
+<parameter_description> a `GtkBuildableParser`
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> user data to pass to #GtkBuildableParser functions
+<parameter_description> user data to pass to `GtkBuildableParser` functions
</parameter_description>
</parameter>
</parameters>
@@ -25290,7 +25375,7 @@ thing to do when an error is detected is to call `g_error()`.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> return location for an error
</parameter_description>
</parameter>
</parameters>
@@ -25328,7 +25413,7 @@ to call g_error().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> return location for an erro
</parameter_description>
</parameter>
</parameters>
@@ -25370,7 +25455,7 @@ to call g_error().
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> return location for an error
</parameter_description>
</parameter>
</parameters>
@@ -25408,7 +25493,7 @@ its child (for instance a `GtkTreeView` that depends on its
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> return location for an error
</parameter_description>
</parameter>
</parameters>
@@ -25446,7 +25531,7 @@ its child (for instance a `GtkTreeView` that depends on its
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> return location for an error
</parameter_description>
</parameter>
</parameters>
@@ -25487,7 +25572,7 @@ its child (for instance a `GtkTreeView` that depends on its
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> return location for an error
</parameter_description>
</parameter>
</parameters>
@@ -25525,7 +25610,7 @@ will be set.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> return location for an error
</parameter_description>
</parameter>
</parameters>
@@ -25609,7 +25694,7 @@ gtk_builder_cscope_add_callback_symbol().
</parameter>
</parameters>
<return> The callback symbol
-in @builder for @callback_name, or %NULL
+in @builder for @callback_name
</return>
</function>
@@ -25684,7 +25769,7 @@ templates, applications have no need to call this function.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> return location for an error
</parameter_description>
</parameter>
</parameters>
@@ -25728,7 +25813,6 @@ of the returned object.
</parameter>
</parameters>
<return> the object named @name
-or %NULL if it could not be found in the object tree.
</return>
</function>
@@ -25783,8 +25867,6 @@ Gets the translation domain of @builder.
</parameter>
</parameters>
<return> the translation domain
-or %NULL. This string is owned by the builder object and
-must not be modified or freed.
</return>
</function>
@@ -25842,8 +25924,7 @@ If the data references a resource, gets the path of that resource.
</parameter_description>
</parameter>
</parameters>
-<return> The path to the resource or %NULL
-if none
+<return> The path to the resource
</return>
</function>
@@ -26007,8 +26088,7 @@ object to the widget the template is inited for. For functions like
</parameter_description>
</parameter>
<parameter name="current_object">
-<parameter_description> the new current object or
-%NULL for none
+<parameter_description> the new current object
</parameter_description>
</parameter>
</parameters>
@@ -26019,7 +26099,7 @@ object to the widget the template is inited for. For functions like
<description>
Sets the scope the builder should operate in.
-If @scope is %NULL a new [class@Gtk.BuilderCScope] will be created.
+If @scope is %NULL, a new [class@Gtk.BuilderCScope] will be created.
</description>
<parameters>
@@ -26028,8 +26108,7 @@ If @scope is %NULL a new [class@Gtk.BuilderCScope] will be created.
</parameter_description>
</parameter>
<parameter name="scope">
-<parameter_description> the scope to use or
-%NULL for the default
+<parameter_description> the scope to use
</parameter_description>
</parameter>
</parameters>
@@ -26047,7 +26126,7 @@ Sets the translation domain of @builder.
</parameter_description>
</parameter>
<parameter name="domain">
-<parameter_description> the translation domain or %NULL
+<parameter_description> the translation domain
</parameter_description>
</parameter>
</parameters>
@@ -26088,7 +26167,7 @@ assigned a `GError` from the %GTK_BUILDER_ERROR domain.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> return location for an error
</parameter_description>
</parameter>
</parameters>
@@ -26125,11 +26204,11 @@ assigned a `GError` from the %GTK_BUILDER_ERROR domain.
</parameter_description>
</parameter>
<parameter name="value">
-<parameter_description> the #GValue to store the result in
+<parameter_description> the `GValue` to store the result in
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> return location for an error
</parameter_description>
</parameter>
</parameters>
@@ -26255,7 +26334,7 @@ will be updated appropriately.
</description>
<parameters>
<parameter name="icon_name">
-<parameter_description> an icon name or %NULL
+<parameter_description> an icon name
</parameter_description>
</parameter>
</parameters>
@@ -26417,7 +26496,7 @@ Remove all visual markers.
<function name="gtk_calendar_get_date">
<description>
-Returns a #GDateTime representing the shown
+Returns a `GDateTime` representing the shown
year, month and the selected day.
The returned date is in the local time zone.
@@ -26430,8 +26509,7 @@ The returned date is in the local time zone.
</parameter_description>
</parameter>
</parameters>
-<return> the `GDate` representing
-the shown date.
+<return> the `GDate` representing the shown date
</return>
</function>
@@ -26555,7 +26633,7 @@ Switches to @date's year and month and select its day.
</parameter_description>
</parameter>
<parameter name="date">
-<parameter_description> a #GDateTime representing the day to select
+<parameter_description> a `GDateTime` representing the day to select
</parameter_description>
</parameter>
</parameters>
@@ -26665,8 +26743,10 @@ callback action is finalized
<function name="gtk_cclosure_expression_new">
<description>
+Creates a `GtkExpression` that calls `callback_func` when it is evaluated.
+
This function is a variant of [ctor Gtk ClosureExpression new] that
-creates a `GClosure` by calling `g_cclosure_new()` with the given
+creates a `GClosure` by calling g_cclosure_new() with the given
`callback_func`, `user_data` and `user_destroy`.
@@ -26715,15 +26795,15 @@ can also activate a widget if it currently has the focus.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="context">
-<parameter_description> the #GtkCellAreaContext in context with the current row data
+<parameter_description> the `GtkCellArea`Context in context with the current row data
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the #GtkWidget that @area is rendering on
+<parameter_description> the `GtkWidget` that @area is rendering on
</parameter_description>
</parameter>
<parameter name="cell_area">
@@ -26731,7 +26811,7 @@ can also activate a widget if it currently has the focus.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> the #GtkCellRendererState flags for @area for this row of data.
+<parameter_description> the `GtkCellRenderer`State flags for @area for this row of data.
</parameter_description>
</parameter>
<parameter name="edit_only">
@@ -26746,8 +26826,8 @@ will be activated.
<function name="gtk_cell_area_activate_cell">
<description>
-This is used by #GtkCellArea subclasses when handling events
-to activate cells, the base #GtkCellArea class activates cells
+This is used by `GtkCellArea` subclasses when handling events
+to activate cells, the base `GtkCellArea` class activates cells
for keyboard events for free in its own GtkCellArea->activate()
implementation.
@@ -26755,28 +26835,28 @@ implementation.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the #GtkWidget that @area is rendering onto
+<parameter_description> the `GtkWidget` that @area is rendering onto
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> the #GtkCellRenderer in @area to activate
+<parameter_description> the `GtkCellRenderer` in @area to activate
</parameter_description>
</parameter>
<parameter name="event">
-<parameter_description> the #GdkEvent for which cell activation should occur
+<parameter_description> the `GdkEvent` for which cell activation should occur
</parameter_description>
</parameter>
<parameter name="cell_area">
-<parameter_description> the #GdkRectangle in @widget relative coordinates
+<parameter_description> the `GdkRectangle` in @widget relative coordinates
of @renderer for the current row.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> the #GtkCellRendererState for @renderer
+<parameter_description> the `GtkCellRenderer`State for @renderer
</parameter_description>
</parameter>
</parameters>
@@ -26791,11 +26871,11 @@ Adds @renderer to @area with the default child cell properties.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> the #GtkCellRenderer to add to @area
+<parameter_description> the `GtkCellRenderer` to add to @area
</parameter_description>
</parameter>
</parameters>
@@ -26814,15 +26894,15 @@ focusable @renderer.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> the #GtkCellRenderer expected to have focus
+<parameter_description> the `GtkCellRenderer` expected to have focus
</parameter_description>
</parameter>
<parameter name="sibling">
-<parameter_description> the #GtkCellRenderer to add to @renderer’s focus area
+<parameter_description> the `GtkCellRenderer` to add to @renderer’s focus area
</parameter_description>
</parameter>
</parameters>
@@ -26837,11 +26917,11 @@ See gtk_cell_area_add() and gtk_cell_area_cell_set() for more details.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> a #GtkCellRenderer to be placed inside @area
+<parameter_description> a `GtkCellRenderer` to be placed inside @area
</parameter_description>
</parameter>
<parameter name="first_prop_name">
@@ -26865,15 +26945,15 @@ Applies any connected attributes to the renderers in
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="tree_model">
-<parameter_description> the #GtkTreeModel to pull values from
+<parameter_description> the `GtkTreeModel` to pull values from
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter in @tree_model to apply values for
+<parameter_description> the `GtkTreeIter` in @tree_model to apply values for
</parameter_description>
</parameter>
<parameter name="is_expander">
@@ -26892,16 +26972,16 @@ children are visible
<function name="gtk_cell_area_attribute_connect">
<description>
Connects an @attribute to apply values from @column for the
-#GtkTreeModel in use.
+`GtkTreeModel` in use.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> the #GtkCellRenderer to connect an attribute for
+<parameter_description> the `GtkCellRenderer` to connect an attribute for
</parameter_description>
</parameter>
<parameter name="attribute">
@@ -26909,7 +26989,7 @@ Connects an @attribute to apply values from @column for the
</parameter_description>
</parameter>
<parameter name="column">
-<parameter_description> the #GtkTreeModel column to fetch attribute values from
+<parameter_description> the `GtkTreeModel` column to fetch attribute values from
</parameter_description>
</parameter>
</parameters>
@@ -26925,11 +27005,11 @@ model.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> the #GtkCellRenderer to disconnect an attribute for
+<parameter_description> the `GtkCellRenderer` to disconnect an attribute for
</parameter_description>
</parameter>
<parameter name="attribute">
@@ -26949,11 +27029,11 @@ or -1 if the attribute is not mapped.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> a #GtkCellRenderer
+<parameter_description> a `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="attribute">
@@ -26973,7 +27053,7 @@ Gets the spacing added between cell renderers.
</description>
<parameters>
<parameter name="box">
-<parameter_description> a #GtkCellAreaBox
+<parameter_description> a `GtkCellAreaBox`
</parameter_description>
</parameter>
</parameters>
@@ -26983,13 +27063,13 @@ Gets the spacing added between cell renderers.
<function name="gtk_cell_area_box_new">
<description>
-Creates a new #GtkCellAreaBox.
+Creates a new `GtkCellAreaBox`.
</description>
<parameters>
</parameters>
-<return> a newly created #GtkCellAreaBox
+<return> a newly created `GtkCellAreaBox`
</return>
</function>
@@ -26998,16 +27078,16 @@ Creates a new #GtkCellAreaBox.
Adds @renderer to @box, packed with reference to the end of @box.
The @renderer is packed after (away from end of) any other
-#GtkCellRenderer packed with reference to the end of @box.
+`GtkCellRenderer` packed with reference to the end of @box.
</description>
<parameters>
<parameter name="box">
-<parameter_description> a #GtkCellAreaBox
+<parameter_description> a `GtkCellAreaBox`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> the #GtkCellRenderer to add
+<parameter_description> the `GtkCellRenderer` to add
</parameter_description>
</parameter>
<parameter name="expand">
@@ -27031,17 +27111,17 @@ more than its natural size
<description>
Adds @renderer to @box, packed with reference to the start of @box.
-The @renderer is packed after any other #GtkCellRenderer packed
+The @renderer is packed after any other `GtkCellRenderer` packed
with reference to the start of @box.
</description>
<parameters>
<parameter name="box">
-<parameter_description> a #GtkCellAreaBox
+<parameter_description> a `GtkCellAreaBox`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> the #GtkCellRenderer to add
+<parameter_description> the `GtkCellRenderer` to add
</parameter_description>
</parameter>
<parameter name="expand">
@@ -27068,11 +27148,11 @@ Sets the spacing to add between cell renderers in @box.
</description>
<parameters>
<parameter name="box">
-<parameter_description> a #GtkCellAreaBox
+<parameter_description> a `GtkCellAreaBox`
</parameter_description>
</parameter>
<parameter name="spacing">
-<parameter_description> the space to add between #GtkCellRenderers
+<parameter_description> the space to add between `GtkCellRenderer`s
</parameter_description>
</parameter>
</parameters>
@@ -27086,11 +27166,11 @@ Gets the values of one or more cell properties for @renderer in @area.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> a #GtkCellRenderer which is inside @area
+<parameter_description> a `GtkCellRenderer` which is inside @area
</parameter_description>
</parameter>
<parameter name="first_prop_name">
@@ -27113,11 +27193,11 @@ Gets the value of a cell property for @renderer in @area.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> a #GtkCellRenderer inside @area
+<parameter_description> a `GtkCellRenderer` inside @area
</parameter_description>
</parameter>
<parameter name="property_name">
@@ -27139,11 +27219,11 @@ Gets the values of one or more cell properties for @renderer in @area.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> a #GtkCellRenderer inside @area
+<parameter_description> a `GtkCellRenderer` inside @area
</parameter_description>
</parameter>
<parameter name="first_property_name">
@@ -27166,11 +27246,11 @@ Sets one or more cell properties for @cell in @area.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> a #GtkCellRenderer which is a cell inside @area
+<parameter_description> a `GtkCellRenderer` which is a cell inside @area
</parameter_description>
</parameter>
<parameter name="first_prop_name">
@@ -27193,11 +27273,11 @@ Sets a cell property for @renderer in @area.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> a #GtkCellRenderer inside @area
+<parameter_description> a `GtkCellRenderer` inside @area
</parameter_description>
</parameter>
<parameter name="property_name">
@@ -27219,11 +27299,11 @@ Sets one or more cell properties for @renderer in @area.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> a #GtkCellRenderer which inside @area
+<parameter_description> a `GtkCellRenderer` which inside @area
</parameter_description>
</parameter>
<parameter name="first_property_name">
@@ -27247,7 +27327,7 @@ Finds a cell property of a cell area class by name.
</description>
<parameters>
<parameter name="aclass">
-<parameter_description> a #GtkCellAreaClass
+<parameter_description> a `GtkCellAreaClass`
</parameter_description>
</parameter>
<parameter name="property_name">
@@ -27255,8 +27335,7 @@ Finds a cell property of a cell area class by name.
</parameter_description>
</parameter>
</parameters>
-<return> the #GParamSpec of the child property
-or %NULL if @aclass has no child property with that name.
+<return> the `GParamSpec` of the child property
</return>
</function>
@@ -27267,7 +27346,7 @@ Installs a cell property on a cell area class.
</description>
<parameters>
<parameter name="aclass">
-<parameter_description> a #GtkCellAreaClass
+<parameter_description> a `GtkCellAreaClass`
</parameter_description>
</parameter>
<parameter name="property_id">
@@ -27275,7 +27354,7 @@ Installs a cell property on a cell area class.
</parameter_description>
</parameter>
<parameter name="pspec">
-<parameter_description> the #GParamSpec for the property
+<parameter_description> the `GParamSpec` for the property
</parameter_description>
</parameter>
</parameters>
@@ -27290,7 +27369,7 @@ Returns all cell properties of a cell area class.
</description>
<parameters>
<parameter name="aclass">
-<parameter_description> a #GtkCellAreaClass
+<parameter_description> a `GtkCellAreaClass`
</parameter_description>
</parameter>
<parameter name="n_properties">
@@ -27299,7 +27378,7 @@ Returns all cell properties of a cell area class.
</parameter>
</parameters>
<return> a newly
-allocated %NULL-terminated array of #GParamSpec*. The array
+allocated %NULL-terminated array of `GParamSpec`*. The array
must be freed with g_free().
</return>
</function>
@@ -27314,23 +27393,23 @@ vertically since a group of rows are usually rendered side by
side vertically or horizontally and share either the same width
or the same height. Sometimes they are allocated in both horizontal
and vertical orientations producing a homogeneous effect of the
-rows. This is generally the case for #GtkTreeView when
-#GtkTreeView:fixed-height-mode is enabled.
+rows. This is generally the case for `GtkTreeView` when
+`GtkTreeView:fixed-height-mode` is enabled.
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkCellAreaContext
+<parameter_description> a `GtkCellAreaContext`
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> the allocated width for all #GtkTreeModel rows rendered
-with @context, or -1.
+<parameter_description> the allocated width for all `GtkTreeModel` rows rendered
+with @context, or -1
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> the allocated height for all #GtkTreeModel rows rendered
-with @context, or -1.
+<parameter_description> the allocated height for all `GtkTreeModel` rows rendered
+with @context, or -1
</parameter_description>
</parameter>
</parameters>
@@ -27348,15 +27427,15 @@ the returned value will be -1.
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkCellAreaContext
+<parameter_description> a `GtkCellAreaContext`
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> location to store the allocated width, or %NULL
+<parameter_description> location to store the allocated width
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> location to store the allocated height, or %NULL
+<parameter_description> location to store the allocated height
</parameter_description>
</parameter>
</parameters>
@@ -27365,26 +27444,26 @@ the returned value will be -1.
<function name="gtk_cell_area_context_get_area">
<description>
-Fetches the #GtkCellArea this @context was created by.
+Fetches the `GtkCellArea` this @context was created by.
This is generally unneeded by layouting widgets; however,
it is important for the context implementation itself to
fetch information about the area it is being used for.
-For instance at #GtkCellAreaContextClass.allocate() time
+For instance at `GtkCellAreaContextClass.allocate()` time
it’s important to know details about any cell spacing
-that the #GtkCellArea is configured with in order to
+that the `GtkCellArea` is configured with in order to
compute a proper allocation.
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkCellAreaContext
+<parameter_description> a `GtkCellAreaContext`
</parameter_description>
</parameter>
</parameters>
-<return> the #GtkCellArea this context was created by.
+<return> the `GtkCellArea` this context was created by.
</return>
</function>
@@ -27394,22 +27473,20 @@ Gets the accumulative preferred height for all rows which have been
requested with this context.
After gtk_cell_area_context_reset() is called and/or before ever
-requesting the size of a #GtkCellArea, the returned values are 0.
+requesting the size of a `GtkCellArea`, the returned values are 0.
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkCellAreaContext
+<parameter_description> a `GtkCellAreaContext`
</parameter_description>
</parameter>
<parameter name="minimum_height">
-<parameter_description> location to store the minimum height,
-or %NULL
+<parameter_description> location to store the minimum height
</parameter_description>
</parameter>
<parameter name="natural_height">
-<parameter_description> location to store the natural height,
-or %NULL
+<parameter_description> location to store the natural height
</parameter_description>
</parameter>
</parameters>
@@ -27422,12 +27499,12 @@ Gets the accumulative preferred height for @width for all rows
which have been requested for the same said @width with this context.
After gtk_cell_area_context_reset() is called and/or before ever
-requesting the size of a #GtkCellArea, the returned values are -1.
+requesting the size of a `GtkCellArea`, the returned values are -1.
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkCellAreaContext
+<parameter_description> a `GtkCellAreaContext`
</parameter_description>
</parameter>
<parameter name="width">
@@ -27435,13 +27512,11 @@ requesting the size of a #GtkCellArea, the returned values are -1.
</parameter_description>
</parameter>
<parameter name="minimum_height">
-<parameter_description> location to store the minimum height,
-or %NULL
+<parameter_description> location to store the minimum height
</parameter_description>
</parameter>
<parameter name="natural_height">
-<parameter_description> location to store the natural height,
-or %NULL
+<parameter_description> location to store the natural height
</parameter_description>
</parameter>
</parameters>
@@ -27454,22 +27529,20 @@ Gets the accumulative preferred width for all rows which have been
requested with this context.
After gtk_cell_area_context_reset() is called and/or before ever
-requesting the size of a #GtkCellArea, the returned values are 0.
+requesting the size of a `GtkCellArea`, the returned values are 0.
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkCellAreaContext
+<parameter_description> a `GtkCellAreaContext`
</parameter_description>
</parameter>
<parameter name="minimum_width">
-<parameter_description> location to store the minimum width,
-or %NULL
+<parameter_description> location to store the minimum width
</parameter_description>
</parameter>
<parameter name="natural_width">
-<parameter_description> location to store the natural width,
-or %NULL
+<parameter_description> location to store the natural width
</parameter_description>
</parameter>
</parameters>
@@ -27482,12 +27555,12 @@ Gets the accumulative preferred width for @height for all rows which
have been requested for the same said @height with this context.
After gtk_cell_area_context_reset() is called and/or before ever
-requesting the size of a #GtkCellArea, the returned values are -1.
+requesting the size of a `GtkCellArea`, the returned values are -1.
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkCellAreaContext
+<parameter_description> a `GtkCellAreaContext`
</parameter_description>
</parameter>
<parameter name="height">
@@ -27495,13 +27568,11 @@ requesting the size of a #GtkCellArea, the returned values are -1.
</parameter_description>
</parameter>
<parameter name="minimum_width">
-<parameter_description> location to store the minimum width,
-or %NULL
+<parameter_description> location to store the minimum width
</parameter_description>
</parameter>
<parameter name="natural_width">
-<parameter_description> location to store the natural width,
-or %NULL
+<parameter_description> location to store the natural width
</parameter_description>
</parameter>
</parameters>
@@ -27513,15 +27584,15 @@ or %NULL
Causes the minimum and/or natural height to grow if the new
proposed sizes exceed the current minimum and natural height.
-This is used by #GtkCellAreaContext implementations during
-the request process over a series of #GtkTreeModel rows to
+This is used by `GtkCellAreaContext` implementations during
+the request process over a series of `GtkTreeModel` rows to
progressively push the requested height over a series of
gtk_cell_area_get_preferred_height() requests.
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkCellAreaContext
+<parameter_description> a `GtkCellAreaContext`
</parameter_description>
</parameter>
<parameter name="minimum_height">
@@ -27541,15 +27612,15 @@ gtk_cell_area_get_preferred_height() requests.
Causes the minimum and/or natural width to grow if the new
proposed sizes exceed the current minimum and natural width.
-This is used by #GtkCellAreaContext implementations during
-the request process over a series of #GtkTreeModel rows to
+This is used by `GtkCellAreaContext` implementations during
+the request process over a series of `GtkTreeModel` rows to
progressively push the requested width over a series of
gtk_cell_area_get_preferred_width() requests.
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkCellAreaContext
+<parameter_description> a `GtkCellAreaContext`
</parameter_description>
</parameter>
<parameter name="minimum_width">
@@ -27569,7 +27640,7 @@ gtk_cell_area_get_preferred_width() requests.
Resets any previously cached request and allocation
data.
-When underlying #GtkTreeModel data changes its
+When underlying `GtkTreeModel` data changes its
important to reset the context if the content
size is allowed to shrink. If the content size
is only allowed to grow (this is usually an option
@@ -27592,7 +27663,7 @@ gtk_cell_area_get_preferred_height_for_width().
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkCellAreaContext
+<parameter_description> a `GtkCellAreaContext`
</parameter_description>
</parameter>
</parameters>
@@ -27605,10 +27676,10 @@ This is sometimes needed for cases where rows need to share
alignments in one orientation but may be separately grouped
in the opposing orientation.
-For instance, #GtkIconView creates all icons (rows) to have
+For instance, `GtkIconView` creates all icons (rows) to have
the same width and the cells theirin to have the same
horizontal alignments. However each row of icons may have
-a separate collective height. #GtkIconView uses this to
+a separate collective height. `GtkIconView` uses this to
request the heights of each row based on a context which
was already used to request all the row widths that are
to be displayed.
@@ -27617,60 +27688,60 @@ to be displayed.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="context">
-<parameter_description> the #GtkCellAreaContext to copy
+<parameter_description> the `GtkCellArea`Context to copy
</parameter_description>
</parameter>
</parameters>
-<return> a newly created #GtkCellAreaContext copy of @context.
+<return> a newly created `GtkCellArea`Context copy of @context.
</return>
</function>
<function name="gtk_cell_area_create_context">
<description>
-Creates a #GtkCellAreaContext to be used with @area for
-all purposes. #GtkCellAreaContext stores geometry information
+Creates a `GtkCellArea`Context to be used with @area for
+all purposes. `GtkCellArea`Context stores geometry information
for rows for which it was operated on, it is important to use
the same context for the same row of data at all times (i.e.
-one should render and handle events with the same #GtkCellAreaContext
+one should render and handle events with the same `GtkCellArea`Context
which was used to request the size of those rows of data).
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
</parameters>
-<return> a newly created #GtkCellAreaContext which can be used with @area.
+<return> a newly created `GtkCellArea`Context which can be used with @area.
</return>
</function>
<function name="gtk_cell_area_event">
<description>
-Delegates event handling to a #GtkCellArea.
+Delegates event handling to a `GtkCellArea`.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="context">
-<parameter_description> the #GtkCellAreaContext for this row of data.
+<parameter_description> the `GtkCellArea`Context for this row of data.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the #GtkWidget that @area is rendering to
+<parameter_description> the `GtkWidget` that @area is rendering to
</parameter_description>
</parameter>
<parameter name="event">
-<parameter_description> the #GdkEvent to handle
+<parameter_description> the `GdkEvent` to handle
</parameter_description>
</parameter>
<parameter name="cell_area">
@@ -27678,7 +27749,7 @@ Delegates event handling to a #GtkCellArea.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> the #GtkCellRendererState for @area in this row.
+<parameter_description> the `GtkCellRenderer`State for @area in this row.
</parameter_description>
</parameter>
</parameters>
@@ -27692,7 +27763,7 @@ This should be called by the @area’s owning layout widget
when focus is to be passed to @area, or moved within @area
for a given @direction and row data.
-Implementing #GtkCellArea classes should implement this
+Implementing `GtkCellArea` classes should implement this
method to receive and navigate focus in its own way particular
to how it lays out cells.
@@ -27700,11 +27771,11 @@ to how it lays out cells.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="direction">
-<parameter_description> the #GtkDirectionType
+<parameter_description> the `GtkDirectionType`
</parameter_description>
</parameter>
</parameters>
@@ -27714,16 +27785,16 @@ to how it lays out cells.
<function name="gtk_cell_area_foreach">
<description>
-Calls @callback for every #GtkCellRenderer in @area.
+Calls @callback for every `GtkCellRenderer` in @area.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> the #GtkCellCallback to call
+<parameter_description> the `GtkCellCallback` to call
</parameter_description>
</parameter>
<parameter name="callback_data">
@@ -27736,21 +27807,21 @@ Calls @callback for every #GtkCellRenderer in @area.
<function name="gtk_cell_area_foreach_alloc">
<description>
-Calls @callback for every #GtkCellRenderer in @area with the
+Calls @callback for every `GtkCellRenderer` in @area with the
allocated rectangle inside @cell_area.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="context">
-<parameter_description> the #GtkCellAreaContext for this row of data.
+<parameter_description> the `GtkCellArea`Context for this row of data.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the #GtkWidget that @area is rendering to
+<parameter_description> the `GtkWidget` that @area is rendering to
</parameter_description>
</parameter>
<parameter name="cell_area">
@@ -27762,7 +27833,7 @@ allocated rectangle inside @cell_area.
</parameter_description>
</parameter>
<parameter name="callback">
-<parameter_description> the #GtkCellAllocCallback to call
+<parameter_description> the `GtkCellAllocCallback` to call
</parameter_description>
</parameter>
<parameter name="callback_data">
@@ -27781,19 +27852,19 @@ were to be renderered in @cell_area.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="context">
-<parameter_description> the #GtkCellAreaContext used to hold sizes for @area.
+<parameter_description> the `GtkCellArea`Context used to hold sizes for @area.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the #GtkWidget that @area is rendering on
+<parameter_description> the `GtkWidget` that @area is rendering on
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> the #GtkCellRenderer to get the allocation for
+<parameter_description> the `GtkCellRenderer` to get the allocation for
</parameter_description>
</parameter>
<parameter name="cell_area">
@@ -27811,22 +27882,22 @@ for this row
<function name="gtk_cell_area_get_cell_at_position">
<description>
-Gets the #GtkCellRenderer at @x and @y coordinates inside @area and optionally
+Gets the `GtkCellRenderer` at @x and @y coordinates inside @area and optionally
returns the full cell allocation for it inside @cell_area.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="context">
-<parameter_description> the #GtkCellAreaContext used to hold sizes for @area.
+<parameter_description> the `GtkCellArea`Context used to hold sizes for @area.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the #GtkWidget that @area is rendering on
+<parameter_description> the `GtkWidget` that @area is rendering on
</parameter_description>
</parameter>
<parameter name="cell_area">
@@ -27844,31 +27915,31 @@ for this row
</parameter>
<parameter name="alloc_area">
<parameter_description> where to store the inner allocated area of the
-returned cell renderer, or %NULL.
+returned cell renderer
</parameter_description>
</parameter>
</parameters>
-<return> the #GtkCellRenderer at @x and @y.
+<return> the `GtkCellRenderer` at @x and @y.
</return>
</function>
<function name="gtk_cell_area_get_current_path_string">
<description>
-Gets the current #GtkTreePath string for the currently
-applied #GtkTreeIter, this is implicitly updated when
+Gets the current `GtkTreePath` string for the currently
+applied `GtkTreeIter`, this is implicitly updated when
gtk_cell_area_apply_attributes() is called and can be
-used to interact with renderers from #GtkCellArea
+used to interact with renderers from `GtkCellArea`
subclasses.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
</parameters>
-<return> The current #GtkTreePath string for the current
+<return> The current `GtkTreePath` string for the current
attributes applied to @area. This string belongs to the area and
should not be freed.
</return>
@@ -27876,35 +27947,35 @@ should not be freed.
<function name="gtk_cell_area_get_edit_widget">
<description>
-Gets the #GtkCellEditable widget currently used
+Gets the `GtkCellEditable` widget currently used
to edit the currently edited cell.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
</parameters>
-<return> The currently active #GtkCellEditable widget
+<return> The currently active `GtkCellEditable` widget
</return>
</function>
<function name="gtk_cell_area_get_edited_cell">
<description>
-Gets the #GtkCellRenderer in @area that is currently
+Gets the `GtkCellRenderer` in @area that is currently
being edited.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
</parameters>
-<return> The currently edited #GtkCellRenderer
+<return> The currently edited `GtkCellRenderer`
</return>
</function>
@@ -27916,7 +27987,7 @@ Retrieves the currently focused cell for @area
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
</parameters>
@@ -27926,10 +27997,10 @@ Retrieves the currently focused cell for @area
<function name="gtk_cell_area_get_focus_from_sibling">
<description>
-Gets the #GtkCellRenderer which is expected to be focusable
+Gets the `GtkCellRenderer` which is expected to be focusable
for which @renderer is, or may be a sibling.
-This is handy for #GtkCellArea subclasses when handling events,
+This is handy for `GtkCellArea` subclasses when handling events,
after determining the renderer at the event location it can
then chose to activate the focus cell for which the event
cell may have been a sibling.
@@ -27938,16 +28009,16 @@ cell may have been a sibling.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> the #GtkCellRenderer
+<parameter_description> the `GtkCellRenderer`
</parameter_description>
</parameter>
</parameters>
-<return> the #GtkCellRenderer for which @renderer
-is a sibling, or %NULL.
+<return> the `GtkCellRenderer`
+for which @renderer is a sibling
</return>
</function>
@@ -27959,15 +28030,15 @@ Gets the focus sibling cell renderers for @renderer.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> the #GtkCellRenderer expected to have focus
+<parameter_description> the `GtkCellRenderer` expected to have focus
</parameter_description>
</parameter>
</parameters>
-<return> A #GList of #GtkCellRenderers.
+<return> A `GList` of `GtkCellRenderer`s.
The returned list is internal and should not be freed.
</return>
</function>
@@ -27985,23 +28056,23 @@ requests.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="context">
-<parameter_description> the #GtkCellAreaContext to perform this request with
+<parameter_description> the `GtkCellArea`Context to perform this request with
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the #GtkWidget where @area will be rendering
+<parameter_description> the `GtkWidget` where @area will be rendering
</parameter_description>
</parameter>
<parameter name="minimum_height">
-<parameter_description> location to store the minimum height, or %NULL
+<parameter_description> location to store the minimum height
</parameter_description>
</parameter>
<parameter name="natural_height">
-<parameter_description> location to store the natural height, or %NULL
+<parameter_description> location to store the natural height
</parameter_description>
</parameter>
</parameters>
@@ -28028,15 +28099,15 @@ gtk_cell_area_context_get_preferred_width().
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="context">
-<parameter_description> the #GtkCellAreaContext which has already been requested for widths.
+<parameter_description> the `GtkCellArea`Context which has already been requested for widths.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the #GtkWidget where @area will be rendering
+<parameter_description> the `GtkWidget` where @area will be rendering
</parameter_description>
</parameter>
<parameter name="width">
@@ -28044,11 +28115,11 @@ gtk_cell_area_context_get_preferred_width().
</parameter_description>
</parameter>
<parameter name="minimum_height">
-<parameter_description> location to store the minimum height, or %NULL
+<parameter_description> location to store the minimum height
</parameter_description>
</parameter>
<parameter name="natural_height">
-<parameter_description> location to store the natural height, or %NULL
+<parameter_description> location to store the natural height
</parameter_description>
</parameter>
</parameters>
@@ -28068,23 +28139,23 @@ requests.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="context">
-<parameter_description> the #GtkCellAreaContext to perform this request with
+<parameter_description> the `GtkCellArea`Context to perform this request with
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the #GtkWidget where @area will be rendering
+<parameter_description> the `GtkWidget` where @area will be rendering
</parameter_description>
</parameter>
<parameter name="minimum_width">
-<parameter_description> location to store the minimum width, or %NULL
+<parameter_description> location to store the minimum width
</parameter_description>
</parameter>
<parameter name="natural_width">
-<parameter_description> location to store the natural width, or %NULL
+<parameter_description> location to store the natural width
</parameter_description>
</parameter>
</parameters>
@@ -28111,15 +28182,15 @@ gtk_cell_area_context_get_preferred_height().
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="context">
-<parameter_description> the #GtkCellAreaContext which has already been requested for widths.
+<parameter_description> the `GtkCellArea`Context which has already been requested for widths.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the #GtkWidget where @area will be rendering
+<parameter_description> the `GtkWidget` where @area will be rendering
</parameter_description>
</parameter>
<parameter name="height">
@@ -28127,11 +28198,11 @@ gtk_cell_area_context_get_preferred_height().
</parameter_description>
</parameter>
<parameter name="minimum_width">
-<parameter_description> location to store the minimum width, or %NULL
+<parameter_description> location to store the minimum width
</parameter_description>
</parameter>
<parameter name="natural_width">
-<parameter_description> location to store the natural width, or %NULL
+<parameter_description> location to store the natural width
</parameter_description>
</parameter>
</parameters>
@@ -28147,11 +28218,11 @@ or a width-for-height layout.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
</parameters>
-<return> The #GtkSizeRequestMode preferred by @area.
+<return> The `GtkSizeRequestMode` preferred by @area.
</return>
</function>
@@ -28163,11 +28234,11 @@ Checks if @area contains @renderer.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> the #GtkCellRenderer to check
+<parameter_description> the `GtkCellRenderer` to check
</parameter_description>
</parameter>
</parameters>
@@ -28177,18 +28248,18 @@ Checks if @area contains @renderer.
<function name="gtk_cell_area_inner_cell_area">
<description>
-This is a convenience function for #GtkCellArea implementations
-to get the inner area where a given #GtkCellRenderer will be
+This is a convenience function for `GtkCellArea` implementations
+to get the inner area where a given `GtkCellRenderer` will be
rendered. It removes any padding previously added by gtk_cell_area_request_renderer().
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the #GtkWidget that @area is rendering onto
+<parameter_description> the `GtkWidget` that @area is rendering onto
</parameter_description>
</parameter>
<parameter name="cell_area">
@@ -28213,7 +28284,7 @@ after applying new attributes to @area.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
</parameters>
@@ -28230,15 +28301,15 @@ Returns whether @sibling is one of @renderer’s focus siblings
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> the #GtkCellRenderer expected to have focus
+<parameter_description> the `GtkCellRenderer` expected to have focus
</parameter_description>
</parameter>
<parameter name="sibling">
-<parameter_description> the #GtkCellRenderer to check against @renderer’s sibling list
+<parameter_description> the `GtkCellRenderer` to check against @renderer’s sibling list
</parameter_description>
</parameter>
</parameters>
@@ -28253,11 +28324,11 @@ Removes @renderer from @area.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> the #GtkCellRenderer to remove from @area
+<parameter_description> the `GtkCellRenderer` to remove from @area
</parameter_description>
</parameter>
</parameters>
@@ -28272,15 +28343,15 @@ Removes @sibling from @renderer’s focus sibling list
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> the #GtkCellRenderer expected to have focus
+<parameter_description> the `GtkCellRenderer` expected to have focus
</parameter_description>
</parameter>
<parameter name="sibling">
-<parameter_description> the #GtkCellRenderer to remove from @renderer’s focus area
+<parameter_description> the `GtkCellRenderer` to remove from @renderer’s focus area
</parameter_description>
</parameter>
</parameters>
@@ -28289,7 +28360,7 @@ Removes @sibling from @renderer’s focus sibling list
<function name="gtk_cell_area_request_renderer">
<description>
-This is a convenience function for #GtkCellArea implementations
+This is a convenience function for `GtkCellArea` implementations
to request size for cell renderers. It’s important to use this
function to request size and then use gtk_cell_area_inner_cell_area()
at render and event time since this function will add padding
@@ -28298,19 +28369,19 @@ around the cell for focus painting.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> the #GtkCellRenderer to request size for
+<parameter_description> the `GtkCellRenderer` to request size for
</parameter_description>
</parameter>
<parameter name="orientation">
-<parameter_description> the #GtkOrientation in which to request size
+<parameter_description> the `GtkOrientation` in which to request size
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the #GtkWidget that @area is rendering onto
+<parameter_description> the `GtkWidget` that @area is rendering onto
</parameter_description>
</parameter>
<parameter name="for_size">
@@ -28319,11 +28390,11 @@ the base request for the orientation is to be returned.
</parameter_description>
</parameter>
<parameter name="minimum_size">
-<parameter_description> location to store the minimum size, or %NULL
+<parameter_description> location to store the minimum size
</parameter_description>
</parameter>
<parameter name="natural_size">
-<parameter_description> location to store the natural size, or %NULL
+<parameter_description> location to store the natural size
</parameter_description>
</parameter>
</parameters>
@@ -28335,18 +28406,18 @@ the base request for the orientation is to be returned.
Explicitly sets the currently focused cell to @renderer.
This is generally called by implementations of
-#GtkCellAreaClass.focus() or #GtkCellAreaClass.event(),
+`GtkCellAreaClass.focus()` or `GtkCellAreaClass.event()`,
however it can also be used to implement functions such
as gtk_tree_view_set_cursor_on_cell().
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="renderer">
-<parameter_description> the #GtkCellRenderer to give focus to
+<parameter_description> the `GtkCellRenderer` to give focus to
</parameter_description>
</parameter>
</parameters>
@@ -28361,19 +28432,19 @@ the given coordinates.
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="context">
-<parameter_description> the #GtkCellAreaContext for this row of data.
+<parameter_description> the `GtkCellArea`Context for this row of data.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the #GtkWidget that @area is rendering to
+<parameter_description> the `GtkWidget` that @area is rendering to
</parameter_description>
</parameter>
<parameter name="snapshot">
-<parameter_description> the #GtkSnapshot to draw to
+<parameter_description> the `GtkSnapshot` to draw to
</parameter_description>
</parameter>
<parameter name="background_area">
@@ -28385,7 +28456,7 @@ the given coordinates.
</parameter_description>
</parameter>
<parameter name="flags">
-<parameter_description> the #GtkCellRendererState for @area in this row.
+<parameter_description> the `GtkCellRenderer`State for @area in this row.
</parameter_description>
</parameter>
<parameter name="paint_focus">
@@ -28410,7 +28481,7 @@ See gtk_cell_area_get_edited_cell() and gtk_cell_area_get_edit_widget().
</description>
<parameters>
<parameter name="area">
-<parameter_description> a #GtkCellArea
+<parameter_description> a `GtkCellArea`
</parameter_description>
</parameter>
<parameter name="canceled">
@@ -28423,12 +28494,12 @@ See gtk_cell_area_get_edited_cell() and gtk_cell_area_get_edit_widget().
<function name="gtk_cell_editable_editing_done">
<description>
-Emits the #GtkCellEditable::editing-done signal.
+Emits the `GtkCellEditable::editing-done` signal.
</description>
<parameters>
<parameter name="cell_editable">
-<parameter_description> A #GtkCellEditable
+<parameter_description> A `GtkCellEditable`
</parameter_description>
</parameter>
</parameters>
@@ -28437,12 +28508,12 @@ Emits the #GtkCellEditable::editing-done signal.
<function name="gtk_cell_editable_remove_widget">
<description>
-Emits the #GtkCellEditable::remove-widget signal.
+Emits the `GtkCellEditable::remove-widget` signal.
</description>
<parameters>
<parameter name="cell_editable">
-<parameter_description> A #GtkCellEditable
+<parameter_description> A `GtkCellEditable`
</parameter_description>
</parameter>
</parameters>
@@ -28453,11 +28524,11 @@ Emits the #GtkCellEditable::remove-widget signal.
<description>
Begins editing on a @cell_editable.
-The #GtkCellRenderer for the cell creates and returns a #GtkCellEditable from
-gtk_cell_renderer_start_editing(), configured for the #GtkCellRenderer type.
+The `GtkCellRenderer` for the cell creates and returns a `GtkCellEditable` from
+gtk_cell_renderer_start_editing(), configured for the `GtkCellRenderer` type.
gtk_cell_editable_start_editing() can then set up @cell_editable suitably for
-editing a cell, e.g. making the Esc key emit #GtkCellEditable::editing-done.
+editing a cell, e.g. making the Esc key emit `GtkCellEditable::editing-done`.
Note that the @cell_editable is created on-demand for the current edit; its
lifetime is temporary and does not persist across other edits and/or cells.
@@ -28465,11 +28536,11 @@ lifetime is temporary and does not persist across other edits and/or cells.
</description>
<parameters>
<parameter name="cell_editable">
-<parameter_description> A #GtkCellEditable
+<parameter_description> A `GtkCellEditable`
</parameter_description>
</parameter>
<parameter name="event">
-<parameter_description> The #GdkEvent that began the editing process, or
+<parameter_description> The `GdkEvent` that began the editing process, or
%NULL if editing was initiated programmatically
</parameter_description>
</parameter>
@@ -28482,22 +28553,23 @@ lifetime is temporary and does not persist across other edits and/or cells.
Adds an attribute mapping to the list in @cell_layout.
The @column is the column of the model to get a value from, and the
-@attribute is the parameter on @cell to be set from the value. So for
+@attribute is the property on @cell to be set from that value. So for
example if column 2 of the model contains strings, you could have the
-“text” attribute of a #GtkCellRendererText get its values from column 2.
+“text” attribute of a `GtkCellRendererText` get its values from column 2.
+In this context "attribute" and "property" are used interchangeably.
</description>
<parameters>
<parameter name="cell_layout">
-<parameter_description> a #GtkCellLayout
+<parameter_description> a `GtkCellLayout`
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer
+<parameter_description> a `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="attribute">
-<parameter_description> an attribute on the renderer
+<parameter_description> a property on the renderer
</parameter_description>
</parameter>
<parameter name="column">
@@ -28516,7 +28588,7 @@ removes all renderers from @cell_layout.
</description>
<parameters>
<parameter name="cell_layout">
-<parameter_description> a #GtkCellLayout
+<parameter_description> a `GtkCellLayout`
</parameter_description>
</parameter>
</parameters>
@@ -28531,11 +28603,11 @@ gtk_cell_layout_set_attributes().
</description>
<parameters>
<parameter name="cell_layout">
-<parameter_description> a #GtkCellLayout
+<parameter_description> a `GtkCellLayout`
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer to clear the attribute mapping on
+<parameter_description> a `GtkCellRenderer` to clear the attribute mapping on
</parameter_description>
</parameter>
</parameters>
@@ -28544,20 +28616,19 @@ gtk_cell_layout_set_attributes().
<function name="gtk_cell_layout_get_area">
<description>
-Returns the underlying #GtkCellArea which might be @cell_layout
-if called on a #GtkCellArea or might be %NULL if no #GtkCellArea
+Returns the underlying `GtkCellArea` which might be @cell_layout
+if called on a `GtkCellArea` or might be %NULL if no `GtkCellArea`
is used by @cell_layout.
</description>
<parameters>
<parameter name="cell_layout">
-<parameter_description> a #GtkCellLayout
+<parameter_description> a `GtkCellLayout`
</parameter_description>
</parameter>
</parameters>
-<return> the cell area used by @cell_layout,
-or %NULL in case no cell area is used.
+<return> the cell area used by @cell_layout
</return>
</function>
@@ -28569,7 +28640,7 @@ Returns the cell renderers which have been added to @cell_layout.
</description>
<parameters>
<parameter name="cell_layout">
-<parameter_description> a #GtkCellLayout
+<parameter_description> a `GtkCellLayout`
</parameter_description>
</parameter>
</parameters>
@@ -28591,11 +28662,11 @@ Note that reusing the same cell renderer is not supported.
</description>
<parameters>
<parameter name="cell_layout">
-<parameter_description> a #GtkCellLayout
+<parameter_description> a `GtkCellLayout`
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer
+<parameter_description> a `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="expand">
@@ -28617,11 +28688,11 @@ Note that reusing the same cell renderer is not supported.
</description>
<parameters>
<parameter name="cell_layout">
-<parameter_description> a #GtkCellLayout
+<parameter_description> a `GtkCellLayout`
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer
+<parameter_description> a `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="expand">
@@ -28642,11 +28713,11 @@ for this to function properly.
</description>
<parameters>
<parameter name="cell_layout">
-<parameter_description> a #GtkCellLayout
+<parameter_description> a `GtkCellLayout`
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer to reorder
+<parameter_description> a `GtkCellRenderer` to reorder
</parameter_description>
</parameter>
<parameter name="position">
@@ -28659,7 +28730,10 @@ for this to function properly.
<function name="gtk_cell_layout_set_attributes">
<description>
-Sets the attributes in list as the attributes of @cell_layout.
+Sets the attributes in the parameter list as the attributes
+of @cell_layout.
+
+See [method@Gtk.CellLayout.add_attribute] for more details.
The attributes should be in attribute/column order, as in
gtk_cell_layout_add_attribute(). All existing attributes are
@@ -28668,11 +28742,11 @@ removed, and replaced with the new attributes.
</description>
<parameters>
<parameter name="cell_layout">
-<parameter_description> a #GtkCellLayout
+<parameter_description> a `GtkCellLayout`
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer
+<parameter_description> a `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -28685,7 +28759,7 @@ removed, and replaced with the new attributes.
<function name="gtk_cell_layout_set_cell_data_func">
<description>
-Sets the #GtkCellLayoutDataFunc to use for @cell_layout.
+Sets the `GtkCellLayout`DataFunc to use for @cell_layout.
This function is used instead of the standard attributes mapping
for setting the column value, and should set the value of @cell_layout’s
@@ -28696,15 +28770,15 @@ cell renderer(s) as appropriate.
</description>
<parameters>
<parameter name="cell_layout">
-<parameter_description> a #GtkCellLayout
+<parameter_description> a `GtkCellLayout`
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer
+<parameter_description> a `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> the #GtkCellLayoutDataFunc to use, or %NULL
+<parameter_description> the `GtkCellLayout`DataFunc to use
</parameter_description>
</parameter>
<parameter name="func_data">
@@ -28721,7 +28795,7 @@ cell renderer(s) as appropriate.
<function name="gtk_cell_renderer_accel_new">
<description>
-Creates a new #GtkCellRendererAccel.
+Creates a new `GtkCellRendererAccel`.
</description>
@@ -28733,19 +28807,19 @@ Creates a new #GtkCellRendererAccel.
<function name="gtk_cell_renderer_activate">
<description>
-Passes an activate event to the cell renderer for possible processing.
-Some cell renderers may use events; for example, #GtkCellRendererToggle
+Passes an activate event to the cell renderer for possible processing.
+Some cell renderers may use events; for example, `GtkCellRendererToggle`
toggles when it gets a mouse click.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer
+<parameter_description> a `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="event">
-<parameter_description> a #GdkEvent
+<parameter_description> a `GdkEvent`
</parameter_description>
</parameter>
<parameter name="widget">
@@ -28753,8 +28827,8 @@ toggles when it gets a mouse click.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> widget-dependent string representation of the event location;
-e.g. for #GtkTreeView, a string representation of #GtkTreePath
+<parameter_description> widget-dependent string representation of the event location;
+e.g. for `GtkTreeView`, a string representation of `GtkTreePath`
</parameter_description>
</parameter>
<parameter name="background_area">
@@ -28776,13 +28850,13 @@ e.g. for #GtkTreeView, a string representation of #GtkTreePath
<function name="gtk_cell_renderer_combo_new">
<description>
-Creates a new #GtkCellRendererCombo.
-Adjust how text is drawn using object properties.
-Object properties can be set globally (with g_object_set()).
-Also, with #GtkTreeViewColumn, you can bind a property to a value
-in a #GtkTreeModel. For example, you can bind the “text” property
-on the cell renderer to a string value in the model, thus rendering
-a different string in each row of the #GtkTreeView.
+Creates a new `GtkCellRendererCombo`.
+Adjust how text is drawn using object properties.
+Object properties can be set globally (with g_object_set()).
+Also, with `GtkTreeViewColumn`, you can bind a property to a value
+in a `GtkTreeModel`. For example, you can bind the “text” property
+on the cell renderer to a string value in the model, thus rendering
+a different string in each row of the `GtkTreeView`.
</description>
@@ -28800,11 +28874,11 @@ the appropriate edit and focus rectangle.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer instance
+<parameter_description> a `GtkCellRenderer` instance
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the #GtkWidget this cell will be rendering to
+<parameter_description> the `GtkWidget` this cell will be rendering to
</parameter_description>
</parameter>
<parameter name="flags">
@@ -28831,15 +28905,15 @@ Fills in @xalign and @yalign with the appropriate values of @cell.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> A #GtkCellRenderer
+<parameter_description> A `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="xalign">
-<parameter_description> location to fill in with the x alignment of the cell, or %NULL
+<parameter_description> location to fill in with the x alignment of the cell
</parameter_description>
</parameter>
<parameter name="yalign">
-<parameter_description> location to fill in with the y alignment of the cell, or %NULL
+<parameter_description> location to fill in with the y alignment of the cell
</parameter_description>
</parameter>
</parameters>
@@ -28853,15 +28927,15 @@ Fills in @width and @height with the appropriate size of @cell.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> A #GtkCellRenderer
+<parameter_description> A `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> location to fill in with the fixed width of the cell, or %NULL
+<parameter_description> location to fill in with the fixed width of the cell
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> location to fill in with the fixed height of the cell, or %NULL
+<parameter_description> location to fill in with the fixed height of the cell
</parameter_description>
</parameter>
</parameters>
@@ -28870,13 +28944,13 @@ Fills in @width and @height with the appropriate size of @cell.
<function name="gtk_cell_renderer_get_is_expanded">
<description>
-Checks whether the given #GtkCellRenderer is expanded.
+Checks whether the given `GtkCellRenderer` is expanded.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer
+<parameter_description> a `GtkCellRenderer`
</parameter_description>
</parameter>
</parameters>
@@ -28886,13 +28960,13 @@ Checks whether the given #GtkCellRenderer is expanded.
<function name="gtk_cell_renderer_get_is_expander">
<description>
-Checks whether the given #GtkCellRenderer is an expander.
+Checks whether the given `GtkCellRenderer` is an expander.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer
+<parameter_description> a `GtkCellRenderer`
</parameter_description>
</parameter>
</parameters>
@@ -28907,15 +28981,15 @@ Fills in @xpad and @ypad with the appropriate values of @cell.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> A #GtkCellRenderer
+<parameter_description> A `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="xpad">
-<parameter_description> location to fill in with the x padding of the cell, or %NULL
+<parameter_description> location to fill in with the x padding of the cell
</parameter_description>
</parameter>
<parameter name="ypad">
-<parameter_description> location to fill in with the y padding of the cell, or %NULL
+<parameter_description> location to fill in with the y padding of the cell
</parameter_description>
</parameter>
</parameters>
@@ -28929,19 +29003,19 @@ Retrieves a renderer’s natural size when rendered to @widget.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer instance
+<parameter_description> a `GtkCellRenderer` instance
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the #GtkWidget this cell will be rendering to
+<parameter_description> the `GtkWidget` this cell will be rendering to
</parameter_description>
</parameter>
<parameter name="minimum_size">
-<parameter_description> location to store the minimum size, or %NULL
+<parameter_description> location to store the minimum size
</parameter_description>
</parameter>
<parameter name="natural_size">
-<parameter_description> location to store the natural size, or %NULL
+<parameter_description> location to store the natural size
</parameter_description>
</parameter>
</parameters>
@@ -28956,11 +29030,11 @@ Retrieves a cell renderers’s minimum and natural height if it were rendered to
</description>
<parameters>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer instance
+<parameter_description> a `GtkCellRenderer` instance
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the #GtkWidget this cell will be rendering to
+<parameter_description> the `GtkWidget` this cell will be rendering to
</parameter_description>
</parameter>
<parameter name="width">
@@ -28968,11 +29042,11 @@ Retrieves a cell renderers’s minimum and natural height if it were rendered to
</parameter_description>
</parameter>
<parameter name="minimum_height">
-<parameter_description> location for storing the minimum size, or %NULL
+<parameter_description> location for storing the minimum size
</parameter_description>
</parameter>
<parameter name="natural_height">
-<parameter_description> location for storing the preferred size, or %NULL
+<parameter_description> location for storing the preferred size
</parameter_description>
</parameter>
</parameters>
@@ -28987,19 +29061,19 @@ into account the widget’s preference for height-for-width management.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer instance
+<parameter_description> a `GtkCellRenderer` instance
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the #GtkWidget this cell will be rendering to
+<parameter_description> the `GtkWidget` this cell will be rendering to
</parameter_description>
</parameter>
<parameter name="minimum_size">
-<parameter_description> location for storing the minimum size, or %NULL
+<parameter_description> location for storing the minimum size
</parameter_description>
</parameter>
<parameter name="natural_size">
-<parameter_description> location for storing the natural size, or %NULL
+<parameter_description> location for storing the natural size
</parameter_description>
</parameter>
</parameters>
@@ -29013,19 +29087,19 @@ Retrieves a renderer’s natural size when rendered to @widget.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer instance
+<parameter_description> a `GtkCellRenderer` instance
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the #GtkWidget this cell will be rendering to
+<parameter_description> the `GtkWidget` this cell will be rendering to
</parameter_description>
</parameter>
<parameter name="minimum_size">
-<parameter_description> location to store the minimum size, or %NULL
+<parameter_description> location to store the minimum size
</parameter_description>
</parameter>
<parameter name="natural_size">
-<parameter_description> location to store the natural size, or %NULL
+<parameter_description> location to store the natural size
</parameter_description>
</parameter>
</parameters>
@@ -29040,11 +29114,11 @@ Retrieves a cell renderers’s minimum and natural width if it were rendered to
</description>
<parameters>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer instance
+<parameter_description> a `GtkCellRenderer` instance
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the #GtkWidget this cell will be rendering to
+<parameter_description> the `GtkWidget` this cell will be rendering to
</parameter_description>
</parameter>
<parameter name="height">
@@ -29052,11 +29126,11 @@ Retrieves a cell renderers’s minimum and natural width if it were rendered to
</parameter_description>
</parameter>
<parameter name="minimum_width">
-<parameter_description> location for storing the minimum size, or %NULL
+<parameter_description> location for storing the minimum size
</parameter_description>
</parameter>
<parameter name="natural_width">
-<parameter_description> location for storing the preferred size, or %NULL
+<parameter_description> location for storing the preferred size
</parameter_description>
</parameter>
</parameters>
@@ -29072,11 +29146,11 @@ or a width-for-height layout.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer instance
+<parameter_description> a `GtkCellRenderer` instance
</parameter_description>
</parameter>
</parameters>
-<return> The #GtkSizeRequestMode preferred by this renderer.
+<return> The `GtkSizeRequestMode` preferred by this renderer.
</return>
</function>
@@ -29088,7 +29162,7 @@ Returns the cell renderer’s sensitivity.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> A #GtkCellRenderer
+<parameter_description> A `GtkCellRenderer`
</parameter_description>
</parameter>
</parameters>
@@ -29098,19 +29172,19 @@ Returns the cell renderer’s sensitivity.
<function name="gtk_cell_renderer_get_state">
<description>
-Translates the cell renderer state to #GtkStateFlags,
+Translates the cell renderer state to `GtkStateFlags`,
based on the cell renderer and widget sensitivity, and
-the given #GtkCellRendererState.
+the given `GtkCellRenderer`State.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer, or %NULL
+<parameter_description> a `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> a #GtkWidget, or %NULL
+<parameter_description> a `GtkWidget`
</parameter_description>
</parameter>
<parameter name="cell_state">
@@ -29130,7 +29204,7 @@ Returns the cell renderer’s visibility.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> A #GtkCellRenderer
+<parameter_description> A `GtkCellRenderer`
</parameter_description>
</parameter>
</parameters>
@@ -29146,7 +29220,7 @@ Checks whether the cell renderer can do something when activated.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> A #GtkCellRenderer
+<parameter_description> A `GtkCellRenderer`
</parameter_description>
</parameter>
</parameters>
@@ -29156,13 +29230,13 @@ Checks whether the cell renderer can do something when activated.
<function name="gtk_cell_renderer_pixbuf_new">
<description>
-Creates a new #GtkCellRendererPixbuf. Adjust rendering
+Creates a new `GtkCellRendererPixbuf`. Adjust rendering
parameters using object properties. Object properties can be set
-globally (with g_object_set()). Also, with #GtkTreeViewColumn, you
-can bind a property to a value in a #GtkTreeModel. For example, you
+globally (with g_object_set()). Also, with `GtkTreeViewColumn`, you
+can bind a property to a value in a `GtkTreeModel`. For example, you
can bind the “pixbuf” property on the cell renderer to a pixbuf value
in the model, thus rendering a different image in each row of the
-#GtkTreeView.
+`GtkTreeView`.
</description>
@@ -29174,7 +29248,7 @@ in the model, thus rendering a different image in each row of the
<function name="gtk_cell_renderer_progress_new">
<description>
-Creates a new #GtkCellRendererProgress.
+Creates a new `GtkCellRendererProgress`.
</description>
@@ -29191,7 +29265,7 @@ Sets the renderer’s alignment within its available space.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> A #GtkCellRenderer
+<parameter_description> A `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="xalign">
@@ -29213,7 +29287,7 @@ Sets the renderer size to be explicit, independent of the properties set.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> A #GtkCellRenderer
+<parameter_description> A `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="width">
@@ -29230,12 +29304,12 @@ Sets the renderer size to be explicit, independent of the properties set.
<function name="gtk_cell_renderer_set_is_expanded">
<description>
-Sets whether the given #GtkCellRenderer is expanded.
+Sets whether the given `GtkCellRenderer` is expanded.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer
+<parameter_description> a `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="is_expanded">
@@ -29248,12 +29322,12 @@ Sets whether the given #GtkCellRenderer is expanded.
<function name="gtk_cell_renderer_set_is_expander">
<description>
-Sets whether the given #GtkCellRenderer is an expander.
+Sets whether the given `GtkCellRenderer` is an expander.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer
+<parameter_description> a `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="is_expander">
@@ -29271,7 +29345,7 @@ Sets the renderer’s padding.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> A #GtkCellRenderer
+<parameter_description> A `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="xpad">
@@ -29293,7 +29367,7 @@ Sets the cell renderer’s sensitivity.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> A #GtkCellRenderer
+<parameter_description> A `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="sensitive">
@@ -29311,7 +29385,7 @@ Sets the cell renderer’s visibility.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> A #GtkCellRenderer
+<parameter_description> A `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="visible">
@@ -29324,9 +29398,9 @@ Sets the cell renderer’s visibility.
<function name="gtk_cell_renderer_snapshot">
<description>
-Invokes the virtual render function of the #GtkCellRenderer. The three
+Invokes the virtual render function of the `GtkCellRenderer`. The three
passed-in rectangles are areas in @cr. Most renderers will draw within
-@cell_area; the xalign, yalign, xpad, and ypad fields of the #GtkCellRenderer
+@cell_area; the xalign, yalign, xpad, and ypad fields of the `GtkCellRenderer`
should be honored with respect to @cell_area. @background_area includes the
blank space around the cell, and also the area containing the tree expander;
so the @background_area rectangles for all cells tile to cover the entire
@@ -29335,11 +29409,11 @@ so the @background_area rectangles for all cells tile to cover the entire
</description>
<parameters>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer
+<parameter_description> a `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="snapshot">
-<parameter_description> a #GtkSnapshot to draw to
+<parameter_description> a `GtkSnapshot` to draw to
</parameter_description>
</parameter>
<parameter name="widget">
@@ -29365,13 +29439,13 @@ padding on the sides)
<function name="gtk_cell_renderer_spin_new">
<description>
-Creates a new #GtkCellRendererSpin.
+Creates a new `GtkCellRendererSpin`.
</description>
<parameters>
</parameters>
-<return> a new #GtkCellRendererSpin
+<return> a new `GtkCellRendererSpin`
</return>
</function>
@@ -29384,24 +29458,24 @@ activity.
</description>
<parameters>
</parameters>
-<return> a new #GtkCellRenderer
+<return> a new `GtkCellRenderer`
</return>
</function>
<function name="gtk_cell_renderer_start_editing">
<description>
-Starts editing the contents of this @cell, through a new #GtkCellEditable
-widget created by the #GtkCellRendererClass.start_editing virtual function.
+Starts editing the contents of this @cell, through a new `GtkCellEditable`
+widget created by the `GtkCellRenderer`Class.start_editing virtual function.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer
+<parameter_description> a `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="event">
-<parameter_description> a #GdkEvent
+<parameter_description> a `GdkEvent`
</parameter_description>
</parameter>
<parameter name="widget">
@@ -29410,7 +29484,7 @@ widget created by the #GtkCellRendererClass.start_editing virtual function.
</parameter>
<parameter name="path">
<parameter_description> widget-dependent string representation of the event location;
-e.g. for #GtkTreeView, a string representation of #GtkTreePath
+e.g. for `GtkTreeView`, a string representation of `GtkTreePath`
</parameter_description>
</parameter>
<parameter name="background_area">
@@ -29426,7 +29500,7 @@ e.g. for #GtkTreeView, a string representation of #GtkTreePath
</parameter_description>
</parameter>
</parameters>
-<return> A new #GtkCellEditable for editing this
+<return> A new `GtkCellEditable` for editing this
@cell, or %NULL if editing is not possible
</return>
</function>
@@ -29434,17 +29508,17 @@ e.g. for #GtkTreeView, a string representation of #GtkTreePath
<function name="gtk_cell_renderer_stop_editing">
<description>
Informs the cell renderer that the editing is stopped.
-If @canceled is %TRUE, the cell renderer will emit the
-#GtkCellRenderer::editing-canceled signal.
+If @canceled is %TRUE, the cell renderer will emit the
+`GtkCellRenderer`::editing-canceled signal.
-This function should be called by cell renderer implementations
-in response to the #GtkCellEditable::editing-done signal of
-#GtkCellEditable.
+This function should be called by cell renderer implementations
+in response to the `GtkCellEditable::editing-done` signal of
+`GtkCellEditable`.
</description>
<parameters>
<parameter name="cell">
-<parameter_description> A #GtkCellRenderer
+<parameter_description> A `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="canceled">
@@ -29457,13 +29531,13 @@ in response to the #GtkCellEditable::editing-done signal of
<function name="gtk_cell_renderer_text_new">
<description>
-Creates a new #GtkCellRendererText. Adjust how text is drawn using
+Creates a new `GtkCellRendererText`. Adjust how text is drawn using
object properties. Object properties can be
-set globally (with g_object_set()). Also, with #GtkTreeViewColumn,
-you can bind a property to a value in a #GtkTreeModel. For example,
+set globally (with g_object_set()). Also, with `GtkTreeViewColumn`,
+you can bind a property to a value in a `GtkTreeModel`. For example,
you can bind the “text” property on the cell renderer to a string
value in the model, thus rendering a different string in each row
-of the #GtkTreeView
+of the `GtkTreeView`.
</description>
@@ -29486,7 +29560,7 @@ the height is determined by the properties again.
</description>
<parameters>
<parameter name="renderer">
-<parameter_description> A #GtkCellRendererText
+<parameter_description> A `GtkCellRendererText`
</parameter_description>
</parameter>
<parameter name="number_of_rows">
@@ -29506,7 +29580,7 @@ gtk_cell_renderer_toggle_set_activatable().
</description>
<parameters>
<parameter name="toggle">
-<parameter_description> a #GtkCellRendererToggle
+<parameter_description> a `GtkCellRendererToggle`
</parameter_description>
</parameter>
</parameters>
@@ -29523,7 +29597,7 @@ gtk_cell_renderer_toggle_set_active().
</description>
<parameters>
<parameter name="toggle">
-<parameter_description> a #GtkCellRendererToggle
+<parameter_description> a `GtkCellRendererToggle`
</parameter_description>
</parameter>
</parameters>
@@ -29539,7 +29613,7 @@ Returns whether we’re rendering radio toggles rather than checkboxes.
</description>
<parameters>
<parameter name="toggle">
-<parameter_description> a #GtkCellRendererToggle
+<parameter_description> a `GtkCellRendererToggle`
</parameter_description>
</parameter>
</parameters>
@@ -29549,10 +29623,10 @@ Returns whether we’re rendering radio toggles rather than checkboxes.
<function name="gtk_cell_renderer_toggle_new">
<description>
-Creates a new #GtkCellRendererToggle. Adjust rendering
+Creates a new `GtkCellRendererToggle`. Adjust rendering
parameters using object properties. Object properties can be set
-globally (with g_object_set()). Also, with #GtkTreeViewColumn, you
-can bind a property to a value in a #GtkTreeModel. For example, you
+globally (with g_object_set()). Also, with `GtkTreeViewColumn`, you
+can bind a property to a value in a `GtkTreeModel`. For example, you
can bind the “active” property on the cell renderer to a boolean value
in the model, thus causing the check button to reflect the state of
the model.
@@ -29572,7 +29646,7 @@ Makes the cell renderer activatable.
</description>
<parameters>
<parameter name="toggle">
-<parameter_description> a #GtkCellRendererToggle.
+<parameter_description> a `GtkCellRendererToggle`.
</parameter_description>
</parameter>
<parameter name="setting">
@@ -29590,7 +29664,7 @@ Activates or deactivates a cell renderer.
</description>
<parameters>
<parameter name="toggle">
-<parameter_description> a #GtkCellRendererToggle.
+<parameter_description> a `GtkCellRendererToggle`.
</parameter_description>
</parameter>
<parameter name="setting">
@@ -29607,14 +29681,14 @@ If @radio is %TRUE, the cell renderer renders a radio toggle
(i.e. a toggle in a group of mutually-exclusive toggles).
If %FALSE, it renders a check toggle (a standalone boolean option).
This can be set globally for the cell renderer, or changed just
-before rendering each cell in the model (for #GtkTreeView, you set
-up a per-row setting using #GtkTreeViewColumn to associate model
+before rendering each cell in the model (for `GtkTreeView`, you set
+up a per-row setting using `GtkTreeViewColumn` to associate model
columns with cell renderer properties).
</description>
<parameters>
<parameter name="toggle">
-<parameter_description> a #GtkCellRendererToggle
+<parameter_description> a `GtkCellRendererToggle`
</parameter_description>
</parameter>
<parameter name="radio">
@@ -29627,7 +29701,7 @@ columns with cell renderer properties).
<function name="gtk_cell_view_get_displayed_row">
<description>
-Returns a #GtkTreePath referring to the currently
+Returns a `GtkTreePath` referring to the currently
displayed row. If no row is currently displayed,
%NULL is returned.
@@ -29635,11 +29709,11 @@ displayed row. If no row is currently displayed,
</description>
<parameters>
<parameter name="cell_view">
-<parameter_description> a #GtkCellView
+<parameter_description> a `GtkCellView`
</parameter_description>
</parameter>
</parameters>
-<return> the currently displayed row or %NULL
+<return> the currently displayed row
</return>
</function>
@@ -29652,7 +29726,7 @@ cells in a sensitive state.
</description>
<parameters>
<parameter name="cell_view">
-<parameter_description> a #GtkCellView
+<parameter_description> a `GtkCellView`
</parameter_description>
</parameter>
</parameters>
@@ -29664,18 +29738,18 @@ cells in a sensitive state
<function name="gtk_cell_view_get_fit_model">
<description>
Gets whether @cell_view is configured to request space
-to fit the entire #GtkTreeModel.
+to fit the entire `GtkTreeModel`.
</description>
<parameters>
<parameter name="cell_view">
-<parameter_description> a #GtkCellView
+<parameter_description> a `GtkCellView`
</parameter_description>
</parameter>
</parameters>
<return> whether @cell_view requests space to fit
-the entire #GtkTreeModel.
+the entire `GtkTreeModel`.
</return>
</function>
@@ -29688,30 +29762,30 @@ returned.
</description>
<parameters>
<parameter name="cell_view">
-<parameter_description> a #GtkCellView
+<parameter_description> a `GtkCellView`
</parameter_description>
</parameter>
</parameters>
-<return> a #GtkTreeModel used or %NULL
+<return> a `GtkTreeModel` used
</return>
</function>
<function name="gtk_cell_view_new">
<description>
-Creates a new #GtkCellView widget.
+Creates a new `GtkCellView` widget.
</description>
<parameters>
</parameters>
-<return> A newly created #GtkCellView widget.
+<return> A newly created `GtkCellView` widget.
</return>
</function>
<function name="gtk_cell_view_new_with_context">
<description>
-Creates a new #GtkCellView widget with a specific #GtkCellArea
-to layout cells and a specific #GtkCellAreaContext.
+Creates a new `GtkCellView` widget with a specific `GtkCellArea`
+to layout cells and a specific `GtkCellAreaContext`.
Specifying the same context for a handful of cells lets
the underlying area synchronize the geometry for those cells,
@@ -29722,21 +29796,21 @@ possible.
</description>
<parameters>
<parameter name="area">
-<parameter_description> the #GtkCellArea to layout cells
+<parameter_description> the `GtkCellArea` to layout cells
</parameter_description>
</parameter>
<parameter name="context">
-<parameter_description> the #GtkCellAreaContext in which to calculate cell geometry
+<parameter_description> the `GtkCellAreaContext` in which to calculate cell geometry
</parameter_description>
</parameter>
</parameters>
-<return> A newly created #GtkCellView widget.
+<return> A newly created `GtkCellView` widget.
</return>
</function>
<function name="gtk_cell_view_new_with_markup">
<description>
-Creates a new #GtkCellView widget, adds a #GtkCellRendererText
+Creates a new `GtkCellView` widget, adds a `GtkCellRendererText`
to it, and makes it show @markup. The text can be
marked up with the [Pango text markup language][PangoMarkupFormat].
@@ -29748,13 +29822,13 @@ marked up with the [Pango text markup language][PangoMarkupFormat].
</parameter_description>
</parameter>
</parameters>
-<return> A newly created #GtkCellView widget.
+<return> A newly created `GtkCellView` widget.
</return>
</function>
<function name="gtk_cell_view_new_with_text">
<description>
-Creates a new #GtkCellView widget, adds a #GtkCellRendererText
+Creates a new `GtkCellView` widget, adds a `GtkCellRendererText`
to it, and makes it show @text.
@@ -29765,13 +29839,13 @@ to it, and makes it show @text.
</parameter_description>
</parameter>
</parameters>
-<return> A newly created #GtkCellView widget.
+<return> A newly created `GtkCellView` widget.
</return>
</function>
<function name="gtk_cell_view_new_with_texture">
<description>
-Creates a new #GtkCellView widget, adds a #GtkCellRendererPixbuf
+Creates a new `GtkCellView` widget, adds a `GtkCellRendererPixbuf`
to it, and makes it show @texture.
@@ -29782,27 +29856,27 @@ to it, and makes it show @texture.
</parameter_description>
</parameter>
</parameters>
-<return> A newly created #GtkCellView widget.
+<return> A newly created `GtkCellView` widget.
</return>
</function>
<function name="gtk_cell_view_set_displayed_row">
<description>
Sets the row of the model that is currently displayed
-by the #GtkCellView. If the path is unset, then the
+by the `GtkCellView`. If the path is unset, then the
contents of the cellview “stick” at their last value;
this is not normally a desired result, but may be
a needed intermediate state if say, the model for
-the #GtkCellView becomes temporarily empty.
+the `GtkCellView` becomes temporarily empty.
</description>
<parameters>
<parameter name="cell_view">
-<parameter_description> a #GtkCellView
+<parameter_description> a `GtkCellView`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath or %NULL to unset.
+<parameter_description> a `GtkTreePath` or %NULL to unset.
</parameter_description>
</parameter>
</parameters>
@@ -29812,14 +29886,14 @@ the #GtkCellView becomes temporarily empty.
<function name="gtk_cell_view_set_draw_sensitive">
<description>
Sets whether @cell_view should draw all of its
-cells in a sensitive state, this is used by #GtkComboBox menus
+cells in a sensitive state, this is used by `GtkComboBox` menus
to ensure that rows with insensitive cells that contain
children appear sensitive in the parent menu item.
</description>
<parameters>
<parameter name="cell_view">
-<parameter_description> a #GtkCellView
+<parameter_description> a `GtkCellView`
</parameter_description>
</parameter>
<parameter name="draw_sensitive">
@@ -29832,16 +29906,16 @@ children appear sensitive in the parent menu item.
<function name="gtk_cell_view_set_fit_model">
<description>
-Sets whether @cell_view should request space to fit the entire #GtkTreeModel.
+Sets whether @cell_view should request space to fit the entire `GtkTreeModel`.
-This is used by #GtkComboBox to ensure that the cell view displayed on
+This is used by `GtkComboBox` to ensure that the cell view displayed on
the combo box’s button always gets enough space and does not resize
when selection changes.
</description>
<parameters>
<parameter name="cell_view">
-<parameter_description> a #GtkCellView
+<parameter_description> a `GtkCellView`
</parameter_description>
</parameter>
<parameter name="fit_model">
@@ -29861,11 +29935,11 @@ set, it will remove it before setting the new model. If @model is
</description>
<parameters>
<parameter name="cell_view">
-<parameter_description> a #GtkCellView
+<parameter_description> a `GtkCellView`
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
</parameters>
@@ -29880,7 +29954,7 @@ makes sure the display of @cell_view is updated.
</description>
<parameters>
<parameter name="cell_view">
-<parameter_description> a #GtkCellView widget
+<parameter_description> a `GtkCellView` widget
</parameter_description>
</parameter>
<parameter name="renderer">
@@ -30012,7 +30086,7 @@ To remove the existing center widget, pas %NULL.
</parameter_description>
</parameter>
<parameter name="child">
-<parameter_description> the new center widget, or %NULL
+<parameter_description> the new center widget
</parameter_description>
</parameter>
</parameters>
@@ -30032,7 +30106,7 @@ To remove the existing end widget, pass %NULL.
</parameter_description>
</parameter>
<parameter name="child">
-<parameter_description> the new end widget, or %NULL
+<parameter_description> the new end widget
</parameter_description>
</parameter>
</parameters>
@@ -30052,7 +30126,7 @@ To remove the existing start widget, pass %NULL.
</parameter_description>
</parameter>
<parameter name="child">
-<parameter_description> the new start widget, or %NULL
+<parameter_description> the new start widget
</parameter_description>
</parameter>
</parameters>
@@ -30390,7 +30464,7 @@ indicator widget's CSS node to 'radio'.
Setting up groups in a cycle leads to undefined behavior.
-Note that the same effect can be achieved via the [interface@Gtk.Actionable]
+Note that the same effect can be achieved via the [iface@Gtk.Actionable]
API, by using the same action with parameter type and state type 's'
for all buttons in the group, and giving each button its own target
value.
@@ -30528,6 +30602,7 @@ or freed.
<function name="gtk_closure_expression_new">
<description>
Creates a `GtkExpression` that calls `closure` when it is evaluated.
+
`closure` is called with the `this` object and the results of evaluating
the `params` expressions.
@@ -30697,7 +30772,7 @@ be displayed in rows, %GTK_ORIENTATION_VERTICAL for columns
</parameter_description>
</parameter>
<parameter name="colors">
-<parameter_description> the colors of the palette, or %NULL
+<parameter_description> the colors of the palette
</parameter_description>
</parameter>
</parameters>
@@ -30712,11 +30787,11 @@ Creates a new `GtkColorChooserDialog`.
</description>
<parameters>
<parameter name="title">
-<parameter_description> Title of the dialog, or %NULL
+<parameter_description> Title of the dialog
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> Transient parent of the dialog, or %NULL
+<parameter_description> Transient parent of the dialog
</parameter_description>
</parameter>
</parameters>
@@ -30906,7 +30981,7 @@ for the column header.
</parameter_description>
</parameter>
</parameters>
-<return> the #GMenuModel, or %NULL
+<return> the `GMenuModel`
</return>
</function>
@@ -31037,7 +31112,7 @@ column.
</parameter_description>
</parameter>
<parameter name="factory">
-<parameter_description> the factory to use or %NULL for none
+<parameter_description> the factory to use
</parameter_description>
</parameter>
</parameters>
@@ -31078,7 +31153,7 @@ for the column header.
</parameter_description>
</parameter>
<parameter name="menu">
-<parameter_description> a `GMenuModel`, or %NULL
+<parameter_description> a `GMenuModel`
</parameter_description>
</parameter>
</parameters>
@@ -31358,7 +31433,7 @@ to add columns next.
</description>
<parameters>
<parameter name="model">
-<parameter_description> the list model to use, or %NULL
+<parameter_description> the list model to use
</parameter_description>
</parameter>
</parameters>
@@ -31411,11 +31486,11 @@ This must be a [iface@Gtk.SelectionModel].
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkColumnView
+<parameter_description> a `GtkColumnView`
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> the model to use or %NULL for none
+<parameter_description> the model to use
</parameter_description>
</parameter>
</parameters>
@@ -31519,7 +31594,7 @@ If @column is %NULL, the view will be unsorted.
</parameter_description>
</parameter>
<parameter name="column">
-<parameter_description> the `GtkColumnViewColumn` to sort by, or %NULL
+<parameter_description> the `GtkColumnViewColumn` to sort by
</parameter_description>
</parameter>
<parameter name="direction">
@@ -31548,7 +31623,7 @@ an immediate child of the root of the tree, this function returns
</parameter>
</parameters>
<return> An integer which is the index of the currently active item,
-or -1 if there’s no active item.
+or -1 if there’s no active item
</return>
</function>
@@ -31576,7 +31651,7 @@ ID value, then %NULL is returned.
</parameter_description>
</parameter>
</parameters>
-<return> the ID of the active row, or %NULL
+<return> the ID of the active row
</return>
</function>
@@ -31754,6 +31829,10 @@ Creates a new empty `GtkComboBox`.
<description>
Creates a new empty `GtkComboBox` with an entry.
+In order to use a combo box with entry, you need to tell it
+which column of the model contains the text for the entry
+by calling [method@Gtk.ComboBox.set_entry_text_column].
+
</description>
<parameters>
@@ -31782,6 +31861,8 @@ Creates a new `GtkComboBox` with a model.
<description>
Creates a new empty `GtkComboBox` with an entry and a model.
+See also [ctor@Gtk.ComboBox.new_with_entry].
+
</description>
<parameters>
@@ -31892,7 +31973,7 @@ and returns %FALSE.
</parameter_description>
</parameter>
<parameter name="active_id">
-<parameter_description> the ID of the row to select, or %NULL
+<parameter_description> the ID of the row to select
</parameter_description>
</parameter>
</parameters>
@@ -31915,7 +31996,7 @@ If @iter is %NULL, the active item is unset.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> The `GtkTreeIter`, or %NULL
+<parameter_description> The `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -31962,7 +32043,10 @@ Sets the child widget of @combo_box.
<function name="gtk_combo_box_set_entry_text_column">
<description>
Sets the model column which @combo_box should use to get strings
-from to be @text_column.
+from to be @text_column.
+
+For this column no separate
+[class@Gtk.CellRenderer] is needed.
The column @text_column in the model of @combo_box must be of
type %G_TYPE_STRING.
@@ -32072,11 +32156,11 @@ This is the default value.
</parameter_description>
</parameter>
<parameter name="data">
-<parameter_description> user data to pass to @func, or %NULL
+<parameter_description> user data to pass to @func
</parameter_description>
</parameter>
<parameter name="destroy">
-<parameter_description> destroy notifier for @data, or %NULL
+<parameter_description> destroy notifier for @data
</parameter_description>
</parameter>
</parameters>
@@ -32099,7 +32183,7 @@ with a position of -1.
</parameter_description>
</parameter>
<parameter name="id">
-<parameter_description> a string ID for this value, or %NULL
+<parameter_description> a string ID for this value
</parameter_description>
</parameter>
<parameter name="text">
@@ -32174,7 +32258,7 @@ If @position is negative then @text is appended.
</parameter_description>
</parameter>
<parameter name="id">
-<parameter_description> a string ID for this value, or %NULL
+<parameter_description> a string ID for this value
</parameter_description>
</parameter>
<parameter name="text">
@@ -32252,7 +32336,7 @@ with a position of 0.
</parameter_description>
</parameter>
<parameter name="id">
-<parameter_description> a string ID for this value, or %NULL
+<parameter_description> a string ID for this value
</parameter_description>
</parameter>
<parameter name="text">
@@ -32430,7 +32514,7 @@ the widget using the [class@Gtk.ConstraintLayout] as the source.
</description>
<parameters>
<parameter name="constraint">
-<parameter_description> a #GtkConstraint
+<parameter_description> a `GtkConstraint`
</parameter_description>
</parameter>
</parameters>
@@ -32486,7 +32570,7 @@ the widget using the [class@Gtk.ConstraintLayout] as the target.
</parameter_description>
</parameter>
</parameters>
-<return> a #GtkConstraintTarget
+<return> a `GtkConstraintTarget`
</return>
</function>
@@ -32517,13 +32601,11 @@ Gets the maximum size of @guide.
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> return location for the maximum width,
-or %NULL
+<parameter_description> return location for the maximum width
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> return location for the maximum height,
-or %NULL
+<parameter_description> return location for the maximum height
</parameter_description>
</parameter>
</parameters>
@@ -32541,13 +32623,11 @@ Gets the minimum size of @guide.
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> return location for the minimum width,
-or %NULL
+<parameter_description> return location for the minimum width
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> return location for the minimum height,
-or %NULL
+<parameter_description> return location for the minimum height
</parameter_description>
</parameter>
</parameters>
@@ -32581,13 +32661,11 @@ Gets the natural size of @guide.
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> return location for the natural width,
-or %NULL
+<parameter_description> return location for the natural width
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> return location for the natural height,
-or %NULL
+<parameter_description> return location for the natural height
</parameter_description>
</parameter>
</parameters>
@@ -33220,7 +33298,8 @@ Creates a new CSS node.
<function name="gtk_css_parser_consume_ident">
<description>
If the current token is an identifier, consumes it and returns
-its name.
+its name.
+
If the current token is not an identifier, an error is emitted
and %NULL is returned.
@@ -33228,18 +33307,18 @@ and %NULL is returned.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkCssParser
+<parameter_description> a `GtkCssParser`
</parameter_description>
</parameter>
</parameters>
<return> the name of the consumed identifier
-or %NULL on error
</return>
</function>
<function name="gtk_css_parser_consume_string">
<description>
-If the current token is a string, consumes it and return the string.
+If the current token is a string, consumes it and return the string.
+
If the current token is not a string, an error is emitted
and %NULL is returned.
@@ -33247,12 +33326,11 @@ and %NULL is returned.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkCssParser
+<parameter_description> a `GtkCssParser`
</parameter_description>
</parameter>
</parameters>
-<return> the name of the consumed string
-or %NULL on error
+<return> the name of the consumed string
</return>
</function>
@@ -33260,18 +33338,18 @@ or %NULL on error
<description>
If the parser matches the <url> token from the [CSS
specification](https://drafts.csswg.org/css-values-4/#url-value),
-consumes it, resolves the URL and returns the resulting #GFile.
+consumes it, resolves the URL and returns the resulting `GFile`.
On failure, an error is emitted and %NULL is returned.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkCssParser
+<parameter_description> a `GtkCssParser`
</parameter_description>
</parameter>
</parameters>
-<return> the resulting URL or %NULL on error
+<return> the resulting URL
</return>
</function>
@@ -33287,7 +33365,7 @@ is returned.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkCssParser
+<parameter_description> a `GtkCssParser`
</parameter_description>
</parameter>
</parameters>
@@ -33313,7 +33391,7 @@ beginning and end of the document.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkCssParser
+<parameter_description> a `GtkCssParser`
</parameter_description>
</parameter>
<parameter name="out_location">
@@ -33334,12 +33412,11 @@ for example when raw data is parsed - %NULL is returned.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkCssParser
+<parameter_description> a `GtkCssParser`
</parameter_description>
</parameter>
</parameters>
<return> The file being parsed
-or %NULL.
</return>
</function>
@@ -33361,7 +33438,7 @@ beginning and end of the document.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkCssParser
+<parameter_description> a `GtkCssParser`
</parameter_description>
</parameter>
</parameters>
@@ -33377,7 +33454,7 @@ Checks if the next token is a function with the given @name.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkCssParser
+<parameter_description> a `GtkCssParser`
</parameter_description>
</parameter>
<parameter name="name">
@@ -33397,7 +33474,7 @@ Checks if the next token is an identifier with the given @name.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkCssParser
+<parameter_description> a `GtkCssParser`
</parameter_description>
</parameter>
<parameter name="ident">
@@ -33417,7 +33494,7 @@ Checks if the next token is of @token_type.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkCssParser
+<parameter_description> a `GtkCssParser`
</parameter_description>
</parameter>
<parameter name="token_type">
@@ -33437,7 +33514,7 @@ Resolves a given URL against the parser's location.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkCssParser
+<parameter_description> a `GtkCssParser`
</parameter_description>
</parameter>
<parameter name="url">
@@ -33445,8 +33522,8 @@ Resolves a given URL against the parser's location.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GFile for the
-resolved URL or %NULL if the URI cannot be resolved.
+<return> a new `GFile` for the
+resolved URL
</return>
</function>
@@ -33460,7 +33537,7 @@ and %TRUE is returned.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkCssParser
+<parameter_description> a `GtkCssParser`
</parameter_description>
</parameter>
<parameter name="keyword">
@@ -33485,7 +33562,7 @@ token.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkCssParser
+<parameter_description> a `GtkCssParser`
</parameter_description>
</parameter>
<parameter name="codepoint">
@@ -33507,7 +33584,7 @@ and %TRUE is returned.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkCssParser
+<parameter_description> a `GtkCssParser`
</parameter_description>
</parameter>
<parameter name="ident">
@@ -33532,7 +33609,7 @@ do {
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkCssParser
+<parameter_description> a `GtkCssParser`
</parameter_description>
</parameter>
<parameter name="token_type">
@@ -33809,7 +33886,7 @@ This is a form like `gtk.css:32:1-23` to denote line 32, characters
</parameter_description>
</parameter>
<parameter name="string">
-<parameter_description> a #GString to print to
+<parameter_description> a `GString` to print to
</parameter_description>
</parameter>
</parameters>
@@ -33841,7 +33918,7 @@ Prints the section into a human-readable text form using
</description>
<parameters>
<parameter name="section">
-<parameter_description> a #GtkCssSection
+<parameter_description> a `GtkCssSection`
</parameter_description>
</parameter>
</parameters>
@@ -33895,7 +33972,7 @@ See gtk_css_value_is_dynamic() for details about dynamic values.
</description>
<parameters>
<parameter name="value">
-<parameter_description> a #GtkCssValue
+<parameter_description> a `GtkCssValue`
</parameter_description>
</parameter>
<parameter name="monotonic_time">
@@ -33921,7 +33998,7 @@ Use gtk_css_value_get_dynamic_value() to get the value for a given timestamp.
</description>
<parameters>
<parameter name="value">
-<parameter_description> a #GtkCssValue
+<parameter_description> a `GtkCssValue`
</parameter_description>
</parameter>
</parameters>
@@ -34032,15 +34109,15 @@ Creates a new custom paper dialog.
</description>
<parameters>
<parameter name="title">
-<parameter_description> the title of the dialog, or %NULL
+<parameter_description> the title of the dialog
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> transient parent of the dialog, or %NULL
+<parameter_description> transient parent of the dialog
</parameter_description>
</parameter>
</parameters>
-<return> the new #GtkCustomPaperUnixDialog
+<return> the new `GtkCustomPaperUnixDialog`
</return>
</function>
@@ -34170,7 +34247,7 @@ Adds multiple buttons.
This is the same as calling [method@Gtk.Dialog.add_button]
repeatedly. The variable argument list should be %NULL-terminated
-as with [new@Gtk.Dialog.new_with_buttons]. Each button must have both
+as with [ctor@Gtk.Dialog.new_with_buttons]. Each button must have both
text and response ID.
</description>
@@ -34203,7 +34280,7 @@ Returns the content area of @dialog.
</parameter_description>
</parameter>
</parameters>
-<return> the content area #GtkBox.
+<return> the content area `GtkBox`.
</return>
</function>
@@ -34266,7 +34343,7 @@ of a dialog.
</parameter>
</parameters>
<return> the @widget button that uses the given
-@response_id, or %NULL.
+@response_id
</return>
</function>
@@ -34326,11 +34403,11 @@ NULL);
</description>
<parameters>
<parameter name="title">
-<parameter_description> Title of the dialog, or %NULL
+<parameter_description> Title of the dialog
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> Transient parent of the dialog, or %NULL
+<parameter_description> Transient parent of the dialog
</parameter_description>
</parameter>
<parameter name="flags">
@@ -34338,7 +34415,7 @@ NULL);
</parameter_description>
</parameter>
<parameter name="first_button_text">
-<parameter_description> text to go in first button, or %NULL
+<parameter_description> text to go in first button
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -34451,7 +34528,7 @@ successfully queried files will remain in the list.
</parameter>
</parameters>
<return> The loading error or %NULL if
-loading finished successfully.
+loading finished successfully
</return>
</function>
@@ -34582,7 +34659,7 @@ If @file is %NULL, the result will be an empty list.
</parameter_description>
</parameter>
<parameter name="file">
-<parameter_description> the #GFile to be enumerated
+<parameter_description> the `GFile` to be enumerated
</parameter_description>
</parameter>
</parameters>
@@ -34618,8 +34695,11 @@ may increase responsiveness.
<function name="gtk_directory_list_set_monitored">
<description>
Sets whether the directory list will monitor the directory
-for changes. If monitoring is enabled, the ::items-changed
-signal will be emitted when the directory contents change.
+for changes.
+
+If monitoring is enabled, the ::items-changed signal will
+be emitted when the directory contents change.
+
When monitoring is turned on after the initial creation
of the directory list, the directory is reloaded to avoid
@@ -34697,7 +34777,7 @@ Checks to see if a drag movement has passed the GTK drag threshold.
</description>
<parameters>
<parameter name="widget">
-<parameter_description> a #GtkWidget
+<parameter_description> a `GtkWidget`
</parameter_description>
</parameter>
<parameter name="start_x">
@@ -34759,7 +34839,7 @@ Gets the widget currently used as drag icon.
</parameter_description>
</parameter>
</parameters>
-<return> The drag icon or %NULL if none.
+<return> The drag icon
</return>
</function>
@@ -34793,7 +34873,7 @@ Sets the widget to display as the drag icon.
</parameter_description>
</parameter>
<parameter name="child">
-<parameter_description> a `GtkWidget` or %NULL
+<parameter_description> a `GtkWidget`
</parameter_description>
</parameter>
</parameters>
@@ -34889,7 +34969,7 @@ Returns the underlying `GdkDrag` object for an ongoing drag.
</parameter>
</parameters>
<return> the `GdkDrag` of the current
-drag operation, or %NULL
+drag operation
</return>
</function>
@@ -34951,7 +35031,7 @@ You may consider setting the content provider back to
</parameter_description>
</parameter>
<parameter name="content">
-<parameter_description> a `GdkContentProvider`, or %NULL
+<parameter_description> a `GdkContentProvider`
</parameter_description>
</parameter>
</parameters>
@@ -34978,7 +35058,7 @@ a [signal@Gtk.DragSource::prepare] or
</parameter_description>
</parameter>
<parameter name="paintable">
-<parameter_description> the #GdkPaintable to use as icon, or %NULL
+<parameter_description> the `GdkPaintable` to use as icon
</parameter_description>
</parameter>
<parameter name="hot_x">
@@ -35158,7 +35238,7 @@ over the widget of @self.
</parameter>
</parameters>
<return> The `GdkDrop` currently
-happening within @self or %NULL if none
+happening within @self
</return>
</function>
@@ -35223,7 +35303,7 @@ See [method@Gtk.DropDown.set_expression].
</parameter_description>
</parameter>
</parameters>
-<return> a `GtkExpression` or %NULL
+<return> a `GtkExpression`
</return>
</function>
@@ -35323,11 +35403,11 @@ to set up a way to map its items to widgets.
</description>
<parameters>
<parameter name="model">
-<parameter_description> the model to use or %NULL for none
+<parameter_description> the model to use
</parameter_description>
</parameter>
<parameter name="expression">
-<parameter_description> the expression to use or %NULL for none
+<parameter_description> the expression to use
</parameter_description>
</parameter>
</parameters>
@@ -35388,7 +35468,7 @@ a value type of %G_TYPE_STRING.
</parameter_description>
</parameter>
<parameter name="expression">
-<parameter_description> a `GtkExpression`, or %NULL
+<parameter_description> a `GtkExpression`
</parameter_description>
</parameter>
</parameters>
@@ -35406,7 +35486,7 @@ Sets the `GtkListItemFactory` to use for populating list items.
</parameter_description>
</parameter>
<parameter name="factory">
-<parameter_description> the factory to use or %NULL for none
+<parameter_description> the factory to use
</parameter_description>
</parameter>
</parameters>
@@ -35424,7 +35504,7 @@ Sets the `GtkListItemFactory` to use for populating list items in the popup.
</parameter_description>
</parameter>
<parameter name="factory">
-<parameter_description> the factory to use or %NULL for none
+<parameter_description> the factory to use
</parameter_description>
</parameter>
</parameters>
@@ -35442,7 +35522,7 @@ Sets the `GListModel` to use.
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> the model to use or %NULL for none
+<parameter_description> the model to use
</parameter_description>
</parameter>
</parameters>
@@ -35536,7 +35616,7 @@ the data.
</parameter_description>
</parameter>
<parameter name="drop">
-<parameter_description> the #GdkDrop of an ongoing drag operation
+<parameter_description> the `GdkDrop` of an ongoing drag operation
</parameter_description>
</parameter>
</parameters>
@@ -35572,8 +35652,7 @@ Sets the data formats that this drop target will accept.
</parameter_description>
</parameter>
<parameter name="formats">
-<parameter_description> the supported data formats or %NULL for
-any format.
+<parameter_description> the supported data formats or %NULL for any format
</parameter_description>
</parameter>
</parameters>
@@ -35634,9 +35713,9 @@ If the result is %NULL, all formats are expected to be supported.
<function name="gtk_drop_target_get_gtypes">
<description>
-Gets the list of supported `GTypes` for @self.
+Gets the list of supported `GType`s that can be dropped on the target.
-If no type have been set, %NULL will be returned.
+If no types have been set, `NULL` will be returned.
</description>
@@ -35646,14 +35725,14 @@ If no type have been set, %NULL will be returned.
</parameter_description>
</parameter>
<parameter name="n_types">
-<parameter_description> optional pointer to take the
-number of #GTypes contained in the return value
+<parameter_description> the number of `GType`s contained in the
+return value
</parameter_description>
</parameter>
</parameters>
<return>
-%G_TYPE_INVALID-terminated array of types included in
-@formats or %NULL if none.
+the `G_TYPE_INVALID`-terminated array of types included in
+formats
</return>
</function>
@@ -35763,8 +35842,8 @@ Sets the supported `GTypes` for this drop target.
</parameter_description>
</parameter>
<parameter name="types">
-<parameter_description>
-all supported #GTypes that can be dropped
+<parameter_description> all supported `GType`s
+that can be dropped on the target
</parameter_description>
</parameter>
<parameter name="n_types">
@@ -36072,11 +36151,11 @@ Note that positions are specified in characters, not bytes.
</parameter_description>
</parameter>
<parameter name="start_pos">
-<parameter_description> location to store the starting position, or %NULL
+<parameter_description> location to store the starting position
</parameter_description>
</parameter>
<parameter name="end_pos">
-<parameter_description> location to store the end position, or %NULL
+<parameter_description> location to store the end position
</parameter_description>
</parameter>
</parameters>
@@ -36551,7 +36630,7 @@ See [method@Gtk.EntryBuffer.get_length].
</description>
<parameters>
<parameter name="buffer">
-<parameter_description> a #GtkEntryBuffer
+<parameter_description> a `GtkEntryBuffer`
</parameter_description>
</parameter>
</parameters>
@@ -36588,7 +36667,7 @@ Retrieves the maximum allowed length of the text in @buffer.
</parameter>
</parameters>
<return> the maximum allowed number of characters
-in #GtkEntryBuffer, or 0 if there is no maximum.
+in `GtkEntryBuffer`, or 0 if there is no maximum.
</return>
</function>
@@ -36659,7 +36738,7 @@ Optionally, specify initial text to set in the buffer.
</description>
<parameters>
<parameter name="initial_chars">
-<parameter_description> initial buffer text, or %NULL
+<parameter_description> initial buffer text
</parameter_description>
</parameter>
<parameter name="n_initial_chars">
@@ -36761,7 +36840,7 @@ see [method@Gtk.EntryCompletion.set_text_column] for details.
</parameter>
</parameters>
<return> The common prefix all rows
-starting with @key or %NULL if no row matches @key.
+starting with @key
</return>
</function>
@@ -36859,8 +36938,7 @@ Returns the model the `GtkEntryCompletion` is using as data source.
</parameter_description>
</parameter>
</parameters>
-<return> A #GtkTreeModel, or %NULL if none
-is currently being used
+<return> A `GtkTreeModel`
</return>
</function>
@@ -36970,7 +37048,7 @@ The `GtkCellArea` is used to layout cells in the underlying
</description>
<parameters>
<parameter name="area">
-<parameter_description> the #GtkCellArea used to layout cells
+<parameter_description> the `GtkCellArea` used to layout cells
</parameter_description>
</parameter>
</parameters>
@@ -37142,8 +37220,7 @@ are using [property@Gtk.EntryCompletion:inline-completion].
</parameter_description>
</parameter>
<parameter name="popup_single_match">
-<parameter_description> %TRUE if the popup should appear even for a single
-match
+<parameter_description> %TRUE if the popup should appear even for a single match
</parameter_description>
</parameter>
</parameters>
@@ -37226,8 +37303,7 @@ See [method@Gtk.Entry.set_attributes].
</parameter_description>
</parameter>
</parameters>
-<return> the attribute list,
-or %NULL if none was set.
+<return> the attribute list
</return>
</function>
@@ -37414,8 +37490,7 @@ set by some other method (e.g., by `GdkPaintable` or icon name).
</parameter_description>
</parameter>
</parameters>
-<return> A `GIcon`, or %NULL if no
-icon is set or if the icon is not a `GIcon`
+<return> A `GIcon`
</return>
</function>
@@ -37438,8 +37513,7 @@ by some other method (e.g., by `GdkPaintable` or gicon).
</parameter_description>
</parameter>
</parameters>
-<return> An icon name, or %NULL if no icon is set
-or if the icon wasn’t set from an icon name
+<return> An icon name
</return>
</function>
@@ -37461,7 +37535,7 @@ If no `GdkPaintable` was used for the icon, %NULL is returned.
</parameter_description>
</parameter>
</parameters>
-<return> A `GdkPaintable`, or %NULL
+<return> A `GdkPaintable`
if no icon is set for this position or the icon set is not
a `GdkPaintable`.
</return>
@@ -37528,8 +37602,7 @@ position in @entry.
</parameter_description>
</parameter>
</parameters>
-<return> the tooltip text, or %NULL. Free the
-returned string with g_free() when done.
+<return> the tooltip text
</return>
</function>
@@ -37550,8 +37623,7 @@ position in @entry.
</parameter_description>
</parameter>
</parameters>
-<return> the tooltip text, or %NULL. Free the returned
-string with g_free() when done.
+<return> the tooltip text
</return>
</function>
@@ -37710,8 +37782,7 @@ See [method@Gtk.Entry.set_tabs].
</parameter_description>
</parameter>
</parameters>
-<return> the tabstops,
-or %NULL if none was set.
+<return> the tabstops
</return>
</function>
@@ -37945,7 +38016,7 @@ Completion is disabled if @completion is set to %NULL.
</parameter_description>
</parameter>
<parameter name="completion">
-<parameter_description> The `GtkEntryCompletion` or %NULL
+<parameter_description> The `GtkEntryCompletion`
</parameter_description>
</parameter>
</parameters>
@@ -38029,7 +38100,7 @@ operation when the user clicks and drags the icon.
</parameter_description>
</parameter>
<parameter name="provider">
-<parameter_description> a #GdkContentProvider
+<parameter_description> a `GdkContentProvider`
</parameter_description>
</parameter>
<parameter name="actions">
@@ -38062,7 +38133,7 @@ specified position.
</parameter_description>
</parameter>
<parameter name="icon">
-<parameter_description> The icon to set, or %NULL
+<parameter_description> The icon to set
</parameter_description>
</parameter>
</parameters>
@@ -38091,7 +38162,7 @@ specified position.
</parameter_description>
</parameter>
<parameter name="icon_name">
-<parameter_description> An icon name, or %NULL
+<parameter_description> An icon name
</parameter_description>
</parameter>
</parameters>
@@ -38115,7 +38186,7 @@ If @paintable is %NULL, no icon will be shown in the specified position.
</parameter_description>
</parameter>
<parameter name="paintable">
-<parameter_description> A `GdkPaintable`, or %NULL
+<parameter_description> A `GdkPaintable`
</parameter_description>
</parameter>
</parameters>
@@ -38168,8 +38239,7 @@ See also [method@Gtk.Widget.set_tooltip_markup] and
</parameter_description>
</parameter>
<parameter name="tooltip">
-<parameter_description> the contents of the tooltip for the
-icon, or %NULL
+<parameter_description> the contents of the tooltip for the icon
</parameter_description>
</parameter>
</parameters>
@@ -38207,8 +38277,7 @@ achieves the same result.
</parameter_description>
</parameter>
<parameter name="tooltip">
-<parameter_description> the contents of the tooltip for the
-icon, or %NULL
+<parameter_description> the contents of the tooltip for the icon
</parameter_description>
</parameter>
</parameters>
@@ -38338,8 +38407,7 @@ contents of the `GtkEntry`.
</parameter_description>
</parameter>
<parameter name="text">
-<parameter_description> a string to be displayed when @entry is
-empty and unfocused, or %NULL
+<parameter_description> a string to be displayed when @entry is empty and unfocused
</parameter_description>
</parameter>
</parameters>
@@ -38433,8 +38501,7 @@ in addition to setting visibility to %FALSE.
</parameter_description>
</parameter>
<parameter name="visible">
-<parameter_description> %TRUE if the contents of the entry are displayed
-as plaintext
+<parameter_description> %TRUE if the contents of the entry are displayed as plaintext
</parameter_description>
</parameter>
</parameters>
@@ -38531,8 +38598,9 @@ Creates a new event controller that will handle focus events.
<function name="gtk_event_controller_get_current_event">
<description>
-Returns the event that is currently being handled by the
-controller, and %NULL at other times.
+Returns the event that is currently being handled by the controller.
+
+At other times, %NULL is returned.
</description>
@@ -38550,7 +38618,9 @@ handled by @controller
<function name="gtk_event_controller_get_current_event_device">
<description>
Returns the device of the event that is currently being
-handled by the controller, and %NULL otherwise.
+handled by the controller.
+
+At other times, %NULL is returned.
</description>
@@ -38568,7 +38638,9 @@ currently handled by @controller
<function name="gtk_event_controller_get_current_event_state">
<description>
Returns the modifier state of the event that is currently being
-handled by the controller, and 0 otherwise.
+handled by the controller.
+
+At other times, 0 is returned.
</description>
@@ -38585,7 +38657,9 @@ handled by the controller, and 0 otherwise.
<function name="gtk_event_controller_get_current_event_time">
<description>
Returns the timestamp of the event that is currently being
-handled by the controller, and 0 otherwise.
+handled by the controller.
+
+At other times, 0 is returned.
</description>
@@ -38647,7 +38721,7 @@ Gets the propagation phase at which @controller handles events.
<function name="gtk_event_controller_get_widget">
<description>
-Returns the #GtkWidget this controller relates to.
+Returns the `GtkWidget` this controller relates to.
</description>
@@ -38967,7 +39041,7 @@ Gets the child widget of @expander.
<function name="gtk_expander_get_expanded">
<description>
-Queries a #GtkExpander and returns its current state.
+Queries a `GtkExpander` and returns its current state.
</description>
@@ -39016,8 +39090,7 @@ Retrieves the label widget for the frame.
</parameter_description>
</parameter>
</parameters>
-<return> the label widget,
-or %NULL if there is none
+<return> the label widget
</return>
</function>
@@ -39395,12 +39468,14 @@ freed.
<function name="gtk_expression_watch">
<description>
-Installs a watch for the given `expression` that calls the `notify` function
-whenever the evaluation of `self` may have changed.
+Watch the given `expression` for changes.
+
+The @notify function will be called whenever the evaluation of `self`
+may have changed.
GTK cannot guarantee that the evaluation did indeed change when the @notify
gets invoked, but it guarantees the opposite: When it did in fact change,
-the `notify` will be invoked.
+the @notify will be invoked.
</description>
@@ -39415,8 +39490,7 @@ watch
</parameter_description>
</parameter>
<parameter name="notify">
-<parameter_description> callback to invoke when the
-expression changes
+<parameter_description> callback to invoke when the expression changes
</parameter_description>
</parameter>
<parameter name="user_data">
@@ -39588,7 +39662,7 @@ in a file chooser.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store error, or %NULL
+<parameter_description> location to store error
</parameter_description>
</parameter>
</parameters>
@@ -39607,11 +39681,11 @@ This function is analogous to [ctor@Gtk.Dialog.new_with_buttons].
</description>
<parameters>
<parameter name="title">
-<parameter_description> Title of the dialog, or %NULL
+<parameter_description> Title of the dialog
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> Transient parent of the dialog, or %NULL
+<parameter_description> Transient parent of the dialog
</parameter_description>
</parameter>
<parameter name="action">
@@ -39619,7 +39693,7 @@ This function is analogous to [ctor@Gtk.Dialog.new_with_buttons].
</parameter_description>
</parameter>
<parameter name="first_button_text">
-<parameter_description> text to go in the first button, or %NULL
+<parameter_description> text to go in the first button
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -39697,7 +39771,7 @@ Gets whether file chooser will offer to create new folders.
<function name="gtk_file_chooser_get_current_folder">
<description>
-Gets the current folder of @chooser as #GFile.
+Gets the current folder of @chooser as `GFile`.
</description>
@@ -39761,7 +39835,7 @@ returned file; use g_object_unref() to release it.
<function name="gtk_file_chooser_get_files">
<description>
Lists all the selected files and subfolders in the current folder
-of @chooser as #GFile.
+of @chooser as `GFile`.
</description>
@@ -39789,7 +39863,7 @@ Gets the current filter.
</parameter_description>
</parameter>
</parameters>
-<return> the current filter, or %NULL
+<return> the current filter
</return>
</function>
@@ -39864,8 +39938,7 @@ Retrieves the custom label text for the accept button.
</parameter_description>
</parameter>
</parameters>
-<return> The custom label, or %NULL for the default.
-This string is owned by GTK and should not be modified or freed
+<return> The custom label
</return>
</function>
@@ -39881,8 +39954,7 @@ Retrieves the custom label text for the cancel button.
</parameter_description>
</parameter>
</parameters>
-<return> The custom label, or %NULL for the default.
-This string is owned by GTK and should not be modified or freed
+<return> The custom label
</return>
</function>
@@ -39894,11 +39966,11 @@ Creates a new `GtkFileChooserNative`.
</description>
<parameters>
<parameter name="title">
-<parameter_description> Title of the native, or %NULL
+<parameter_description> Title of the native
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> Transient parent of the native, or %NULL
+<parameter_description> Transient parent of the native
</parameter_description>
</parameter>
<parameter name="action">
@@ -39936,7 +40008,7 @@ Pressing Alt and that key should activate the button.
</parameter_description>
</parameter>
<parameter name="accept_label">
-<parameter_description> custom label or %NULL for the default
+<parameter_description> custom label
</parameter_description>
</parameter>
</parameters>
@@ -39961,7 +40033,7 @@ Pressing Alt and that key should activate the button.
</parameter_description>
</parameter>
<parameter name="cancel_label">
-<parameter_description> custom label or %NULL for the default
+<parameter_description> custom label
</parameter_description>
</parameter>
</parameters>
@@ -40020,7 +40092,7 @@ Removes a folder from the shortcut folders in a file chooser.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store error, or %NULL
+<parameter_description> location to store error
</parameter_description>
</parameter>
</parameters>
@@ -40101,7 +40173,7 @@ This is only relevant if the action is not set to be
<function name="gtk_file_chooser_set_current_folder">
<description>
-Sets the current folder for @chooser from a #GFile.
+Sets the current folder for @chooser from a `GFile`.
</description>
@@ -40115,7 +40187,7 @@ Sets the current folder for @chooser from a #GFile.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store error, or %NULL.
+<parameter_description> location to store error
</parameter_description>
</parameter>
</parameters>
@@ -40211,7 +40283,7 @@ gtk_file_chooser_set_file (chooser, existing_file, NULL);
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> location to store the error, or %NULL to ignore errors.
+<parameter_description> location to store the error
</parameter_description>
</parameter>
</parameters>
@@ -40376,9 +40448,7 @@ See [method@Gtk.FileFilter.set_name].
</parameter_description>
</parameter>
</parameters>
-<return> The human-readable name of the filter,
-or %NULL. This value is owned by GTK and must not
-be modified or freed.
+<return> The human-readable name of the filter
</return>
</function>
@@ -40465,20 +40535,23 @@ Serialize a file filter to an `a{sv}` variant.
<function name="gtk_filter_changed">
<description>
-Emits the #GtkFilter::changed signal to notify all users of the filter that
-the filter changed. Users of the filter should then check items again via
-gtk_filter_match().
+Notifies all users of the filter that it has changed.
-Depending on the @change parameter, not all items need to be changed, but
-only some. Refer to the #GtkFilterChange documentation for details.
+This emits the [signal@Gtk.Filter::changed] signal. Users
+of the filter should then check items again via
+[method@Gtk.Filter.match].
-This function is intended for implementors of #GtkFilter subclasses and
-should not be called from other functions.
+Depending on the @change parameter, not all items need to
+be changed, but only some. Refer to the [enum@Gtk.FilterChange]
+documentation for details.
+
+This function is intended for implementors of `GtkFilter`
+subclasses and should not be called from other functions.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkFilter
+<parameter_description> a `GtkFilter`
</parameter_description>
</parameter>
<parameter name="change">
@@ -40491,19 +40564,21 @@ should not be called from other functions.
<function name="gtk_filter_get_strictness">
<description>
-Gets the known strictness of @filters. If the strictness is not known,
-%GTK_FILTER_MATCH_SOME is returned.
+Gets the known strictness of @filters.
+
+If the strictness is not known, %GTK_FILTER_MATCH_SOME is returned.
-This value may change after emission of the #GtkFilter::changed signal.
+This value may change after emission of the [signal@Gtk.Filter::changed]
+signal.
This function is meant purely for optimization purposes, filters can
-choose to omit implementing it, but #GtkFilterListModel uses it.
+choose to omit implementing it, but `GtkFilterListModel` uses it.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkFilter
+<parameter_description> a `GtkFilter`
</parameter_description>
</parameter>
</parameters>
@@ -40524,7 +40599,6 @@ Gets the `GtkFilter` currently set on @self.
</parameter>
</parameters>
<return> The filter currently in use
-or %NULL if the list isn't filtered
</return>
</function>
@@ -40602,11 +40676,11 @@ Creates a new `GtkFilterListModel` that will filter @model using the given
</description>
<parameters>
<parameter name="model">
-<parameter_description> the model to sort, or %NULL
+<parameter_description> the model to sort
</parameter_description>
</parameter>
<parameter name="filter">
-<parameter_description> filter or %NULL to not filter items
+<parameter_description> filter
</parameter_description>
</parameter>
</parameters>
@@ -40625,7 +40699,7 @@ Sets the filter used to filter items.
</parameter_description>
</parameter>
<parameter name="filter">
-<parameter_description> filter to use or %NULL to not filter items
+<parameter_description> filter to use
</parameter_description>
</parameter>
</parameters>
@@ -40755,8 +40829,7 @@ gtk_fixed_set_child_transform().
</parameter_description>
</parameter>
</parameters>
-<return> a `GskTransform` or %NULL
-in case no transform has been set on @widget
+<return> a `GskTransform`
</return>
</function>
@@ -40908,7 +40981,7 @@ This is a convenience function that retrieves the
</parameter_description>
</parameter>
<parameter name="transform">
-<parameter_description> the transformation assigned to @widget or %NULL
+<parameter_description> the transformation assigned to @widget
to reset @widget's transform
</parameter_description>
</parameter>
@@ -40979,7 +41052,7 @@ Sets a new model to be flattened.
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> the new model or %NULL
+<parameter_description> the new model
</parameter_description>
</parameter>
</parameters>
@@ -41091,7 +41164,7 @@ Gets the current index of the @child in its `GtkFlowBox` container.
</parameter>
</parameters>
<return> the index of the @child, or -1 if the @child is not
-in a flow box.
+in a flow box
</return>
</function>
@@ -41957,11 +42030,11 @@ Creates a new `GtkFontChooserDialog`.
</description>
<parameters>
<parameter name="title">
-<parameter_description> Title of the dialog, or %NULL
+<parameter_description> Title of the dialog
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> Transient parent of the dialog, or %NULL
+<parameter_description> Transient parent of the dialog
</parameter_description>
</parameter>
</parameters>
@@ -41991,8 +42064,7 @@ font descriptions.
</parameter>
</parameters>
<return> A string with the name
-of the current font, or %NULL if no font is selected. You must
-free this string with g_free().
+of the current font
</return>
</function>
@@ -42018,7 +42090,7 @@ font descriptions.
</parameter>
</parameters>
<return> A `PangoFontDescription` for the
-current font, or %NULL if no font is selected.
+current font
</return>
</function>
@@ -42038,8 +42110,7 @@ If the selected font is not installed, returns %NULL.
</parameter>
</parameters>
<return> A `PangoFontFace` representing the
-selected font group details, or %NULL. The returned object is owned by
-@fontchooser and must not be modified or freed.
+selected font group details
</return>
</function>
@@ -42060,8 +42131,7 @@ If the selected font is not installed, returns %NULL.
</parameter>
</parameters>
<return> A `PangoFontFamily` representing the
-selected font family, or %NULL. The returned object is owned by @fontchooser
-and must not be modified or freed.
+selected font family
</return>
</function>
@@ -42094,7 +42164,7 @@ or %NULL if it does not have one.
</parameter_description>
</parameter>
</parameters>
-<return> a `PangoFontMap`, or %NULL
+<return> a `PangoFontMap`
</return>
</function>
@@ -42191,7 +42261,7 @@ in the font chooser.
</parameter_description>
</parameter>
<parameter name="filter">
-<parameter_description> a `GtkFontFilterFunc`, or %NULL
+<parameter_description> a `GtkFontFilterFunc`
</parameter_description>
</parameter>
<parameter name="user_data">
@@ -42435,8 +42505,7 @@ Retrieves the label widget for the frame.
</parameter_description>
</parameter>
</parameters>
-<return> the label widget, or %NULL if
-there is none.
+<return> the label widget
</return>
</function>
@@ -42563,7 +42632,7 @@ as an offset to the starting drag point.
</description>
<parameters>
<parameter name="gesture">
-<parameter_description> a #GtkGesture
+<parameter_description> a `GtkGesture`
</parameter_description>
</parameter>
<parameter name="x">
@@ -42692,7 +42761,7 @@ This returns %NULL if the gesture is not being interacted.
</parameter_description>
</parameter>
</parameters>
-<return> a `GdkDevice`, or %NULL
+<return> a `GdkDevice`
</return>
</function>
@@ -42797,7 +42866,7 @@ Returns the @sequence state, as seen by @gesture.
</parameter_description>
</parameter>
<parameter name="sequence">
-<parameter_description> a #GdkEventSequence
+<parameter_description> a `GdkEventSequence`
</parameter_description>
</parameter>
</parameters>
@@ -42872,7 +42941,7 @@ corresponding to @sequence.
</parameter_description>
</parameter>
<parameter name="sequence">
-<parameter_description> a `GdkEventSequence` or %NULL
+<parameter_description> a `GdkEventSequence`
</parameter_description>
</parameter>
</parameters>
@@ -43561,21 +43630,26 @@ to adjust their debug output based on GTK debug flags.
<function name="gtk_get_default_language">
<description>
-Returns the #PangoLanguage for the default language currently in
-effect. (Note that this can change over the life of an
-application.) The default language is derived from the current
-locale. It determines, for example, whether GTK uses the
-right-to-left or left-to-right text direction.
+Returns the `PangoLanguage` for the default language
+currently in effect.
+
+Note that this can change over the life of an
+application.
-This function is equivalent to pango_language_get_default().
+The default language is derived from the current
+locale. It determines, for example, whether GTK uses
+the right-to-left or left-to-right text direction.
+
+This function is equivalent to
+[func@Pango.Language.get_default].
See that function for details.
</description>
<parameters>
</parameters>
-<return> the default language as a #PangoLanguage,
-must not be freed
+<return> the default language as a
+`PangoLanguage`
</return>
</function>
@@ -43589,12 +43663,12 @@ originally.
</description>
<parameters>
<parameter name="event">
-<parameter_description> a #GdkEvent
+<parameter_description> a `GdkEvent`
</parameter_description>
</parameter>
</parameters>
<return> the widget that originally
-received @event, or %NULL
+received @event
</return>
</function>
@@ -43640,7 +43714,7 @@ gtk_widget_set_default_direction (direction);
</description>
<parameters>
</parameters>
-<return> the #GtkTextDirection of the current locale
+<return> the `GtkTextDirection` of the current locale
</return>
</function>
@@ -43767,7 +43841,7 @@ Gets the current error set on the @area.
</parameter_description>
</parameter>
</parameters>
-<return> the #GError or %NULL
+<return> the `GError`
</return>
</function>
@@ -44022,7 +44096,7 @@ This function must be called before the area has been realized.
<description>
Sets whether the @area should create an OpenGL or an OpenGL ES context.
-You should check the capabilities of the #GdkGLContext before drawing
+You should check the capabilities of the `GdkGLContext` before drawing
with either API.
</description>
@@ -44125,8 +44199,8 @@ The widget is placed next to @sibling, on the side determined by
left or right placement) or column 0 (for top or bottom placement),
at the end indicated by @side.
-Attaching widgets labeled [1], [2], [3] with @sibling == %NULL and
-@side == %GTK_POS_LEFT yields a layout of [3][2][1].
+Attaching widgets labeled `[1]`, `[2]`, `[3]` with `@sibling == %NULL` and
+`@side == %GTK_POS_LEFT` yields a layout of `[3][2][1]`.
</description>
<parameters>
@@ -44196,7 +44270,7 @@ cell at @column, @row.
</parameter_description>
</parameter>
</parameters>
-<return> the child at the given position, or %NULL
+<return> the child at the given position
</return>
</function>
@@ -45073,11 +45147,11 @@ gtk_builder_list_item_factory_new_from_resource ("/resource.ui"));
</description>
<parameters>
<parameter name="model">
-<parameter_description> the model to use, or %NULL
+<parameter_description> the model to use
</parameter_description>
</parameter>
<parameter name="factory">
-<parameter_description> The factory to populate items with, or %NULL
+<parameter_description> The factory to populate items with
</parameter_description>
</parameter>
</parameters>
@@ -45114,7 +45188,7 @@ Sets the `GtkListItemFactory` to use for populating list items.
</parameter_description>
</parameter>
<parameter name="factory">
-<parameter_description> the factory to use or %NULL for none
+<parameter_description> the factory to use
</parameter_description>
</parameter>
</parameters>
@@ -45180,7 +45254,7 @@ This must be a [iface@Gtk.SelectionModel].
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> the model to use or %NULL for none
+<parameter_description> the model to use
</parameter_description>
</parameter>
</parameters>
@@ -45253,8 +45327,7 @@ See [method@Gtk.HeaderBar.set_title_widget].
</parameter_description>
</parameter>
</parameters>
-<return> the title widget
-of the header, or %NULL if none has been set explicitly.
+<return> the title widget of the header
</return>
</function>
@@ -45282,7 +45355,7 @@ end of the @bar.
</parameter_description>
</parameter>
<parameter name="child">
-<parameter_description> the #GtkWidget to be added to @bar
+<parameter_description> the `GtkWidget` to be added to @bar
</parameter_description>
</parameter>
</parameters>
@@ -45301,7 +45374,7 @@ start of the @bar.
</parameter_description>
</parameter>
<parameter name="child">
-<parameter_description> the #GtkWidget to be added to @bar
+<parameter_description> the `GtkWidget` to be added to @bar
</parameter_description>
</parameter>
</parameters>
@@ -45358,8 +45431,7 @@ on the left, and minimize, maximize and close buttons on the right.
</parameter_description>
</parameter>
<parameter name="layout">
-<parameter_description> a decoration layout, or %NULL to
-unset the layout
+<parameter_description> a decoration layout, or %NULL to unset the layout
</parameter_description>
</parameter>
</parameters>
@@ -45484,8 +45556,7 @@ Gets the `GFile` that was used to load the icon.
</parameter_description>
</parameter>
</parameters>
-<return> the #GFile for the icon, or %NULL.
-Free with g_object_unref().
+<return> the `GFile` for the icon
</return>
</function>
@@ -45607,7 +45678,7 @@ of the icon or %NULL to use the default color
</parameter>
<parameter name="error_color">
<parameter_description> a `GdkRGBA` representing the error color
-of the icon or %NULL to use the default color (allow-none)
+of the icon or %NULL to use the default color
</parameter_description>
</parameter>
</parameters>
@@ -45760,8 +45831,7 @@ See [method@Gtk.IconTheme.set_resource_path].
</parameter>
</parameters>
<return>
-A list of resource paths or %NULL.
-The returned value should be freed with g_strfreev().
+A list of resource paths
</return>
</function>
@@ -45780,8 +45850,7 @@ See [method@Gtk.IconTheme.set_search_path].
</parameter>
</parameters>
<return>
-a list of icon theme path directories or %NULL.
-The returned value should be freed with g_strfreev().
+a list of icon theme path directories
</return>
</function>
@@ -46025,7 +46094,7 @@ Sets the name of the icon theme that the `GtkIconTheme` object uses
overriding system configuration.
This function cannot be called on the icon theme objects returned
-from [type_func@Gtk.IconTheme.get_for_display].
+from [func@Gtk.IconTheme.get_for_display].
</description>
<parameters>
@@ -46044,18 +46113,18 @@ configured theme, or %NULL to unset a previously set custom theme
<function name="gtk_icon_view_create_drag_icon">
<description>
-Creates a #cairo_surface_t representation of the item at @path.
+Creates a `cairo_surface_t` representation of the item at @path.
This image is used for a drag icon.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath in @icon_view
+<parameter_description> a `GtkTreePath` in @icon_view
</parameter_description>
</parameter>
</parameters>
@@ -46066,12 +46135,12 @@ This image is used for a drag icon.
<function name="gtk_icon_view_enable_model_drag_dest">
<description>
Turns @icon_view into a drop destination for automatic DND. Calling this
-method sets #GtkIconView:reorderable to %FALSE.
+method sets `GtkIconView`:reorderable to %FALSE.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="formats">
@@ -46090,12 +46159,12 @@ widget
<function name="gtk_icon_view_enable_model_drag_source">
<description>
Turns @icon_view into a drag source for automatic DND. Calling this
-method sets #GtkIconView:reorderable to %FALSE.
+method sets `GtkIconView`:reorderable to %FALSE.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="start_button_mask">
@@ -46123,7 +46192,7 @@ Gets the setting set by gtk_icon_view_set_activate_on_single_click().
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
</parameters>
@@ -46142,15 +46211,15 @@ This function is only valid if @icon_view is realized.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer or %NULL
+<parameter_description> a `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="rect">
@@ -46170,7 +46239,7 @@ Returns the value of the ::column-spacing property.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
</parameters>
@@ -46186,7 +46255,7 @@ Returns the value of the ::columns property.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
</parameters>
@@ -46200,23 +46269,23 @@ Fills in @path and @cell with the current cursor path and cell.
If the cursor isn’t currently set, then *@path will be %NULL.
If no cell currently has focus, then *@cell will be %NULL.
-The returned #GtkTreePath must be freed with gtk_tree_path_free().
+The returned `GtkTreePath` must be freed with gtk_tree_path_free().
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView
+<parameter_description> A `GtkIconView`
</parameter_description>
</parameter>
<parameter name="path">
<parameter_description> Return location for the current
-cursor path, or %NULL
+cursor path
</parameter_description>
</parameter>
<parameter name="cell">
<parameter_description> Return location the current
-focus cell, or %NULL
+focus cell
</parameter_description>
</parameter>
</parameters>
@@ -46232,7 +46301,7 @@ Determines the destination item for a given position.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="drag_x">
@@ -46244,12 +46313,11 @@ Determines the destination item for a given position.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> Return location for the path of the item,
-or %NULL.
+<parameter_description> Return location for the path of the item
</parameter_description>
</parameter>
<parameter name="pos">
-<parameter_description> Return location for the drop position, or %NULL
+<parameter_description> Return location for the drop position
</parameter_description>
</parameter>
</parameters>
@@ -46264,16 +46332,16 @@ Gets information about the item that is highlighted for feedback.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="path">
<parameter_description> Return location for the path of
-the highlighted item, or %NULL.
+the highlighted item
</parameter_description>
</parameter>
<parameter name="pos">
-<parameter_description> Return location for the drop position, or %NULL
+<parameter_description> Return location for the drop position
</parameter_description>
</parameter>
</parameters>
@@ -46288,7 +46356,7 @@ Gets the path and cell for the icon at the given position.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`.
</parameter_description>
</parameter>
<parameter name="x">
@@ -46300,12 +46368,12 @@ Gets the path and cell for the icon at the given position.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> Return location for the path, or %NULL
+<parameter_description> Return location for the path
</parameter_description>
</parameter>
<parameter name="cell">
<parameter_description> Return location for the renderer
-responsible for the cell at (@x, @y), or %NULL
+responsible for the cell at (@x, @y)
</parameter_description>
</parameter>
</parameters>
@@ -46322,11 +46390,11 @@ displayed. Column numbers start at 0.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> the #GtkTreePath of the item
+<parameter_description> the `GtkTreePath` of the item
</parameter_description>
</parameter>
</parameters>
@@ -46343,7 +46411,7 @@ whether the labels are drawn beside the icons instead of below.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
</parameters>
@@ -46359,7 +46427,7 @@ Returns the value of the ::item-padding property.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
</parameters>
@@ -46376,11 +46444,11 @@ displayed. Row numbers start at 0.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> the #GtkTreePath of the item
+<parameter_description> the `GtkTreePath` of the item
</parameter_description>
</parameter>
</parameters>
@@ -46396,7 +46464,7 @@ Returns the value of the ::item-width property.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
</parameters>
@@ -46412,7 +46480,7 @@ Returns the value of the ::margin property.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
</parameters>
@@ -46428,7 +46496,7 @@ Returns the column with markup text for @icon_view.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`.
</parameter_description>
</parameter>
</parameters>
@@ -46438,19 +46506,18 @@ Returns the column with markup text for @icon_view.
<function name="gtk_icon_view_get_model">
<description>
-Returns the model the #GtkIconView is based on. Returns %NULL if the
+Returns the model the `GtkIconView` is based on. Returns %NULL if the
model is unset.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
</parameters>
-<return> A #GtkTreeModel, or %NULL if none is
-currently being used.
+<return> The currently used `GtkTreeModel`
</return>
</function>
@@ -46462,7 +46529,7 @@ Gets the path for the icon at the given position.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`.
</parameter_description>
</parameter>
<parameter name="x">
@@ -46474,7 +46541,7 @@ Gets the path for the icon at the given position.
</parameter_description>
</parameter>
</parameters>
-<return> The #GtkTreePath corresponding
+<return> The `GtkTreePath` corresponding
to the icon or %NULL if no icon exists at that position.
</return>
</function>
@@ -46487,7 +46554,7 @@ Returns the column with pixbufs for @icon_view.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`.
</parameter_description>
</parameter>
</parameters>
@@ -46504,7 +46571,7 @@ See gtk_icon_view_set_reorderable().
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
</parameters>
@@ -46520,7 +46587,7 @@ Returns the value of the ::row-spacing property.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
</parameters>
@@ -46532,7 +46599,7 @@ Returns the value of the ::row-spacing property.
<description>
Creates a list of paths of all selected items. Additionally, if you are
planning on modifying the model after calling this function, you may
-want to convert the returned list into a list of #GtkTreeRowReferences.
+want to convert the returned list into a list of `GtkTreeRowReferences`.
To do this, you can use gtk_tree_row_reference_new().
To free the return value, use:
@@ -46544,11 +46611,11 @@ g_list_free_full (list, (GDestroyNotify) gtk_tree_path_free);
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`.
</parameter_description>
</parameter>
</parameters>
-<return> A #GList containing a #GtkTreePath for each selected row.
+<return> A `GList` containing a `GtkTreePath` for each selected row.
</return>
</function>
@@ -46560,7 +46627,7 @@ Gets the selection mode of the @icon_view.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`.
</parameter_description>
</parameter>
</parameters>
@@ -46576,7 +46643,7 @@ Returns the value of the ::spacing property.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
</parameters>
@@ -46592,7 +46659,7 @@ Returns the column with text for @icon_view.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`.
</parameter_description>
</parameter>
</parameters>
@@ -46609,7 +46676,7 @@ displaying tooltips on @icon_view’s rows.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
</parameters>
@@ -46620,8 +46687,8 @@ used, or -1 if this is disabled.
<function name="gtk_icon_view_get_tooltip_context">
<description>
-This function is supposed to be used in a #GtkWidget::query-tooltip
-signal handler for #GtkIconView. The @x, @y and @keyboard_tip values
+This function is supposed to be used in a `GtkWidget::query-tooltip`
+signal handler for `GtkIconView`. The @x, @y and @keyboard_tip values
which are received in the signal handler, should be passed to this
function without modification.
@@ -46635,7 +46702,7 @@ that row and the corresponding model.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> an #GtkIconView
+<parameter_description> an `GtkIconView`
</parameter_description>
</parameter>
<parameter name="x">
@@ -46651,16 +46718,15 @@ that row and the corresponding model.
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> a pointer to receive a
-#GtkTreeModel or %NULL
+<parameter_description> a pointer to receive a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a pointer to receive a #GtkTreePath or %NULL
+<parameter_description> a pointer to receive a `GtkTreePath`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a pointer to receive a #GtkTreeIter or %NULL
+<parameter_description> a pointer to receive a `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -46670,7 +46736,7 @@ that row and the corresponding model.
<function name="gtk_icon_view_get_visible_range">
<description>
-Sets @start_path and @end_path to be the first and last visible path.
+Sets @start_path and @end_path to be the first and last visible path.
Note that there may be invisible paths in between.
Both paths should be freed with gtk_tree_path_free() after use.
@@ -46679,16 +46745,15 @@ Both paths should be freed with gtk_tree_path_free() after use.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView
+<parameter_description> A `GtkIconView`
</parameter_description>
</parameter>
<parameter name="start_path">
-<parameter_description> Return location for start of region,
-or %NULL
+<parameter_description> Return location for start of region
</parameter_description>
</parameter>
<parameter name="end_path">
-<parameter_description> Return location for end of region, or %NULL
+<parameter_description> Return location for end of region
</parameter_description>
</parameter>
</parameters>
@@ -46703,11 +46768,11 @@ Activates the item determined by @path.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView
+<parameter_description> A `GtkIconView`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> The #GtkTreePath to be activated
+<parameter_description> The `GtkTreePath` to be activated
</parameter_description>
</parameter>
</parameters>
@@ -46716,36 +46781,36 @@ Activates the item determined by @path.
<function name="gtk_icon_view_new">
<description>
-Creates a new #GtkIconView widget
+Creates a new `GtkIconView` widget
</description>
<parameters>
</parameters>
-<return> A newly created #GtkIconView widget
+<return> A newly created `GtkIconView` widget
</return>
</function>
<function name="gtk_icon_view_new_with_area">
<description>
-Creates a new #GtkIconView widget using the
+Creates a new `GtkIconView` widget using the
specified @area to layout cells inside the icons.
</description>
<parameters>
<parameter name="area">
-<parameter_description> the #GtkCellArea to use to layout cells
+<parameter_description> the `GtkCellArea` to use to layout cells
</parameter_description>
</parameter>
</parameters>
-<return> A newly created #GtkIconView widget
+<return> A newly created `GtkIconView` widget
</return>
</function>
<function name="gtk_icon_view_new_with_model">
<description>
-Creates a new #GtkIconView widget with the model @model.
+Creates a new `GtkIconView` widget with the model @model.
</description>
@@ -46755,7 +46820,7 @@ Creates a new #GtkIconView widget with the model @model.
</parameter_description>
</parameter>
</parameters>
-<return> A newly created #GtkIconView widget.
+<return> A newly created `GtkIconView` widget.
</return>
</function>
@@ -46768,11 +46833,11 @@ selected. If @path does not point to a valid location, %FALSE is returned.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> A #GtkTreePath to check selection on.
+<parameter_description> A `GtkTreePath` to check selection on.
</parameter_description>
</parameter>
</parameters>
@@ -46800,7 +46865,7 @@ centered path will be modified to reflect this change.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`
</parameter_description>
</parameter>
<parameter name="path">
@@ -46826,12 +46891,12 @@ centered path will be modified to reflect this change.
<function name="gtk_icon_view_select_all">
<description>
Selects all the icons. @icon_view must has its selection mode set
-to #GTK_SELECTION_MULTIPLE.
+to %GTK_SELECTION_MULTIPLE.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`.
</parameter_description>
</parameter>
</parameters>
@@ -46845,11 +46910,11 @@ Selects the row at @path.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> The #GtkTreePath to be selected.
+<parameter_description> The `GtkTreePath` to be selected.
</parameter_description>
</parameter>
</parameters>
@@ -46864,7 +46929,7 @@ selection cannot be modified from within this function.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`.
</parameter_description>
</parameter>
<parameter name="func">
@@ -46881,13 +46946,13 @@ selection cannot be modified from within this function.
<function name="gtk_icon_view_set_activate_on_single_click">
<description>
-Causes the #GtkIconView::item-activated signal to be emitted on
+Causes the `GtkIconView`::item-activated signal to be emitted on
a single click instead of a double click.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="single">
@@ -46906,7 +46971,7 @@ which is inserted between the columns of the icon view.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="column_spacing">
@@ -46927,7 +46992,7 @@ to fill the available area.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="columns">
@@ -46953,15 +47018,15 @@ Please note that editing can only happen when the widget is realized.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView
+<parameter_description> A `GtkIconView`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> A #GtkTreePath
+<parameter_description> A `GtkTreePath`
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> One of the cell renderers of @icon_view, or %NULL
+<parameter_description> One of the cell renderers of @icon_view
</parameter_description>
</parameter>
<parameter name="start_editing">
@@ -46979,11 +47044,11 @@ Sets the item that is highlighted for feedback.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> The path of the item to highlight, or %NULL.
+<parameter_description> The path of the item to highlight
</parameter_description>
</parameter>
<parameter name="pos">
@@ -47002,7 +47067,7 @@ are drawn beside the icons instead of below.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="orientation">
@@ -47015,13 +47080,13 @@ are drawn beside the icons instead of below.
<function name="gtk_icon_view_set_item_padding">
<description>
-Sets the #GtkIconView:item-padding property which specifies the padding
+Sets the `GtkIconView`:item-padding property which specifies the padding
around each of the icon view’s items.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="item_padding">
@@ -47041,7 +47106,7 @@ automatically determine a suitable item size.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="item_width">
@@ -47061,7 +47126,7 @@ of the icon view.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="margin">
@@ -47075,14 +47140,14 @@ of the icon view.
<function name="gtk_icon_view_set_markup_column">
<description>
Sets the column with markup information for @icon_view to be
-@column. The markup column must be of type #G_TYPE_STRING.
+@column. The markup column must be of type `G_TYPE_STRING`.
If the markup column is set to something, it overrides
the text column set by gtk_icon_view_set_text_column().
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`.
</parameter_description>
</parameter>
<parameter name="column">
@@ -47095,7 +47160,7 @@ the text column set by gtk_icon_view_set_text_column().
<function name="gtk_icon_view_set_model">
<description>
-Sets the model for a #GtkIconView.
+Sets the model for a `GtkIconView`.
If the @icon_view already has a model set, it will remove
it before setting the new model. If @model is %NULL, then
it will unset the old model.
@@ -47103,7 +47168,7 @@ it will unset the old model.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`.
</parameter_description>
</parameter>
<parameter name="model">
@@ -47117,12 +47182,12 @@ it will unset the old model.
<function name="gtk_icon_view_set_pixbuf_column">
<description>
Sets the column with pixbufs for @icon_view to be @column. The pixbuf
-column must be of type #GDK_TYPE_PIXBUF
+column must be of type `GDK_TYPE_PIXBUF`
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`.
</parameter_description>
</parameter>
<parameter name="column">
@@ -47136,8 +47201,8 @@ column must be of type #GDK_TYPE_PIXBUF
<function name="gtk_icon_view_set_reorderable">
<description>
This function is a convenience function to allow you to reorder models that
-support the #GtkTreeDragSourceIface and the #GtkTreeDragDestIface. Both
-#GtkTreeStore and #GtkListStore support these. If @reorderable is %TRUE, then
+support the `GtkTreeDragSourceIface` and the `GtkTreeDragDestIface`. Both
+`GtkTreeStore` and `GtkListStore` support these. If @reorderable is %TRUE, then
the user can reorder the model by dragging and dropping rows. The
developer can listen to these changes by connecting to the model's
row_inserted and row_deleted signals. The reordering is implemented by setting up
@@ -47151,7 +47216,7 @@ handle drag and drop manually.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`.
</parameter_description>
</parameter>
<parameter name="reorderable">
@@ -47170,7 +47235,7 @@ which is inserted between the rows of the icon view.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="row_spacing">
@@ -47188,7 +47253,7 @@ Sets the selection mode of the @icon_view.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`.
</parameter_description>
</parameter>
<parameter name="mode">
@@ -47208,7 +47273,7 @@ the text) of an item.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="spacing">
@@ -47222,12 +47287,12 @@ the text) of an item.
<function name="gtk_icon_view_set_text_column">
<description>
Sets the column with text for @icon_view to be @column. The text
-column must be of type #G_TYPE_STRING.
+column must be of type `G_TYPE_STRING`.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`.
</parameter_description>
</parameter>
<parameter name="column">
@@ -47248,19 +47313,19 @@ See also gtk_icon_view_set_tooltip_column() for a simpler alternative.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="tooltip">
-<parameter_description> a #GtkTooltip
+<parameter_description> a `GtkTooltip`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer or %NULL
+<parameter_description> a `GtkCellRenderer`
</parameter_description>
</parameter>
</parameters>
@@ -47270,12 +47335,12 @@ See also gtk_icon_view_set_tooltip_column() for a simpler alternative.
<function name="gtk_icon_view_set_tooltip_column">
<description>
If you only plan to have simple (text-only) tooltips on full items, you
-can use this function to have #GtkIconView handle these automatically
+can use this function to have `GtkIconView` handle these automatically
for you. @column should be set to the column in @icon_view’s model
containing the tooltip texts, or -1 to disable this feature.
-When enabled, #GtkWidget:has-tooltip will be set to %TRUE and
-@icon_view will connect a #GtkWidget::query-tooltip signal handler.
+When enabled, `GtkWidget:has-tooltip` will be set to %TRUE and
+@icon_view will connect a `GtkWidget::query-tooltip` signal handler.
Note that the signal handler sets the text with gtk_tooltip_set_markup(),
so &, <, etc have to be escaped in the text.
@@ -47283,7 +47348,7 @@ so &, <, etc have to be escaped in the text.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="column">
@@ -47303,15 +47368,15 @@ See also gtk_tooltip_set_tip_area().
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
<parameter name="tooltip">
-<parameter_description> a #GtkTooltip
+<parameter_description> a `GtkTooltip`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
</parameters>
@@ -47325,7 +47390,7 @@ Unselects all the icons.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`.
</parameter_description>
</parameter>
</parameters>
@@ -47339,11 +47404,11 @@ Unselects the row at @path.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> A #GtkIconView.
+<parameter_description> A `GtkIconView`.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> The #GtkTreePath to be unselected.
+<parameter_description> The `GtkTreePath` to be unselected.
</parameter_description>
</parameter>
</parameters>
@@ -47353,12 +47418,12 @@ Unselects the row at @path.
<function name="gtk_icon_view_unset_model_drag_dest">
<description>
Undoes the effect of gtk_icon_view_enable_model_drag_dest(). Calling this
-method sets #GtkIconView:reorderable to %FALSE.
+method sets `GtkIconView`:reorderable to %FALSE.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
</parameters>
@@ -47368,12 +47433,12 @@ method sets #GtkIconView:reorderable to %FALSE.
<function name="gtk_icon_view_unset_model_drag_source">
<description>
Undoes the effect of gtk_icon_view_enable_model_drag_source(). Calling this
-method sets #GtkIconView:reorderable to %FALSE.
+method sets `GtkIconView`:reorderable to %FALSE.
</description>
<parameters>
<parameter name="icon_view">
-<parameter_description> a #GtkIconView
+<parameter_description> a `GtkIconView`
</parameter_description>
</parameter>
</parameters>
@@ -47387,7 +47452,7 @@ characters around the cursor position by emitting the
GtkIMContext::delete_surrounding signal.
Note that @offset and @n_chars are in characters not in bytes
-which differs from the usage other places in #GtkIMContext.
+which differs from the usage other places in `GtkIMContext`.
In order to use this function, you should first call
gtk_im_context_get_surrounding() to get the current context, and
@@ -47537,7 +47602,7 @@ This string should be displayed inserted at the insertion point.
</description>
<parameters>
<parameter name="context">
-<parameter_description> a `GtkIMContext`
+<parameter_description> a `GtkIMContext`
</parameter_description>
</parameter>
<parameter name="str">
@@ -47547,7 +47612,7 @@ string. The string retrieved must be freed with g_free().
</parameter>
<parameter name="attrs">
<parameter_description> location to store the retrieved
-attribute list. When you are done with this list, you
+attribute list. When you are done with this list, you
must unreference it with pango_attr_list_unref().
</parameter_description>
</parameter>
@@ -47628,7 +47693,7 @@ Since: 4.2
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkIMContext
+<parameter_description> a `GtkIMContext`
</parameter_description>
</parameter>
<parameter name="text">
@@ -47687,7 +47752,7 @@ also be used for purposes internal to the input method.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the client widget. This may be %NULL to indicate
+<parameter_description> the client widget. This may be %NULL to indicate
that the previous client widget no longer exists.
</parameter_description>
</parameter>
@@ -47735,8 +47800,7 @@ Deprecated: 4.2: Use [method@Gtk.IMContext.set_surrounding_with_selection] inste
</parameter>
<parameter name="text">
<parameter_description> text surrounding the insertion point, as UTF-8.
-the preedit string should not be included within
-@text.
+the preedit string should not be included within @text
</parameter_description>
</parameter>
<parameter name="len">
@@ -47763,13 +47827,12 @@ Since: 4.2
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkIMContext
+<parameter_description> a `GtkIMContext`
</parameter_description>
</parameter>
<parameter name="text">
<parameter_description> text surrounding the insertion point, as UTF-8.
-the preedit string should not be included within
-@text.
+the preedit string should not be included within @text
</parameter_description>
</parameter>
<parameter name="len">
@@ -47818,7 +47881,7 @@ Adds an additional table from the X11 compose file.
</description>
<parameters>
<parameter name="context_simple">
-<parameter_description> A #GtkIMContextSimple
+<parameter_description> A `GtkIMContextSimple`
</parameter_description>
</parameter>
<parameter name="compose_file">
@@ -47844,7 +47907,7 @@ the length of the sequence should be zero.)
</description>
<parameters>
<parameter name="context_simple">
-<parameter_description> A #GtkIMContextSimple
+<parameter_description> A `GtkIMContextSimple`
</parameter_description>
</parameter>
<parameter name="data">
@@ -47865,13 +47928,13 @@ the length of the sequence should be zero.)
<function name="gtk_im_context_simple_new">
<description>
-Creates a new #GtkIMContextSimple.
+Creates a new `GtkIMContextSimple`.
</description>
<parameters>
</parameters>
-<return> a new #GtkIMContextSimple.
+<return> a new `GtkIMContextSimple`
</return>
</function>
@@ -47955,7 +48018,7 @@ returned `GIcon`.
</parameter_description>
</parameter>
</parameters>
-<return> a `GIcon`, or %NULL
+<return> a `GIcon`
</return>
</function>
@@ -47976,7 +48039,7 @@ be freed.
</parameter_description>
</parameter>
</parameters>
-<return> the icon name, or %NULL
+<return> the icon name
</return>
</function>
@@ -48013,8 +48076,7 @@ returned paintable.
</parameter_description>
</parameter>
</parameters>
-<return> the displayed paintable,
-or %NULL if the image is empty
+<return> the displayed paintable
</return>
</function>
@@ -48126,7 +48188,7 @@ will be updated appropriately.
</description>
<parameters>
<parameter name="icon_name">
-<parameter_description> an icon name or %NULL
+<parameter_description> an icon name
</parameter_description>
</parameter>
</parameters>
@@ -48149,7 +48211,7 @@ its size and contents in response to it.
</description>
<parameters>
<parameter name="paintable">
-<parameter_description> a `GdkPaintable`, or %NULL
+<parameter_description> a `GdkPaintable`
</parameter_description>
</parameter>
</parameters>
@@ -48176,7 +48238,7 @@ want that, you should use [ctor@Gtk.Image.new_from_icon_name].
</description>
<parameters>
<parameter name="pixbuf">
-<parameter_description> a `GdkPixbuf`, or %NULL
+<parameter_description> a `GdkPixbuf`
</parameter_description>
</parameter>
</parameters>
@@ -48225,7 +48287,7 @@ See [ctor@Gtk.Image.new_from_file] for details.
</parameter_description>
</parameter>
<parameter name="filename">
-<parameter_description> a filename or %NULL
+<parameter_description> a filename
</parameter_description>
</parameter>
</parameters>
@@ -48265,7 +48327,7 @@ See [ctor@Gtk.Image.new_from_icon_name] for details.
</parameter_description>
</parameter>
<parameter name="icon_name">
-<parameter_description> an icon name or %NULL
+<parameter_description> an icon name
</parameter_description>
</parameter>
</parameters>
@@ -48285,7 +48347,7 @@ See [ctor@Gtk.Image.new_from_paintable] for details.
</parameter_description>
</parameter>
<parameter name="paintable">
-<parameter_description> a `GdkPaintable` or %NULL
+<parameter_description> a `GdkPaintable`
</parameter_description>
</parameter>
</parameters>
@@ -48329,7 +48391,7 @@ See [ctor@Gtk.Image.new_from_resource] for details.
</parameter_description>
</parameter>
<parameter name="resource_path">
-<parameter_description> a resource path or %NULL
+<parameter_description> a resource path
</parameter_description>
</parameter>
</parameters>
@@ -48553,7 +48615,7 @@ response ID.
</description>
<parameters>
<parameter name="first_button_text">
-<parameter_description> ext to go in first button, or %NULL
+<parameter_description> ext to go in first button
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -48660,7 +48722,7 @@ GTK uses this type to determine how the message is displayed.
</parameter_description>
</parameter>
<parameter name="message_type">
-<parameter_description> a #GtkMessageType
+<parameter_description> a `GtkMessageType`
</parameter_description>
</parameter>
</parameters>
@@ -48744,8 +48806,8 @@ Call this function before using any other GTK functions in your GUI
applications. It will initialize everything needed to operate the
toolkit and parses some standard command line options.
-If you are using #GtkApplication, you don't have to call gtk_init()
-or gtk_init_check(); the #GApplication::startup handler
+If you are using `GtkApplication`, you don't have to call gtk_init()
+or gtk_init_check(); the `GApplication::startup` handler
does it for you.
This function will terminate your program if it was unable to
@@ -48872,8 +48934,7 @@ attributes for the label, use
</parameter_description>
</parameter>
</parameters>
-<return> the attribute list, or %NULL
-if none was set.
+<return> the attribute list
</return>
</function>
@@ -48896,8 +48957,7 @@ handler or for use in a [signal@Gtk.Widget::query-tooltip] handler.
</parameter_description>
</parameter>
</parameters>
-<return> the currently active URI or %NULL if there is none.
-The string is owned by GTK and must not be freed or modified.
+<return> the currently active URI
</return>
</function>
@@ -49005,7 +49065,7 @@ The coordinates are useful to convert mouse events into coordinates
inside the [class@Pango.Layout], e.g. to take some action if some part
of the label is clicked. Remember when using the [class@Pango.Layout]
functions you need to convert to and from pixels using PANGO_PIXELS()
-or [constant@Pango.SCALE].
+or [const@Pango.SCALE].
</description>
<parameters>
@@ -49014,11 +49074,11 @@ or [constant@Pango.SCALE].
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> location to store X offset of layout, or %NULL
+<parameter_description> location to store X offset of layout
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> location to store Y offset of layout, or %NULL
+<parameter_description> location to store Y offset of layout
</parameter_description>
</parameter>
</parameters>
@@ -49426,7 +49486,7 @@ be applied to the label after the markup string is parsed.
</parameter_description>
</parameter>
<parameter name="attrs">
-<parameter_description> a [struct@Pango.AttrList], or %NULL
+<parameter_description> a [struct@Pango.AttrList]
</parameter_description>
</parameter>
</parameters>
@@ -49596,7 +49656,7 @@ If characters in @str are preceded by an underscore, they are underlined
indicating that they represent a keyboard accelerator called a mnemonic.
The mnemonic key can be used to activate another widget, chosen
-automatically, or explicitly using method@Gtk.Label.set_mnemonic_widget].
+automatically, or explicitly using [method@Gtk.Label.set_mnemonic_widget].
</description>
<parameters>
@@ -49657,7 +49717,7 @@ and toggle focus between the colliding widgets otherwise.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the target #GtkWidget, or %NULL to unset
+<parameter_description> the target `GtkWidget`, or %NULL to unset
</parameter_description>
</parameter>
</parameters>
@@ -49913,7 +49973,7 @@ Retrieves the `GtkWidget` associated to the given @layout_child.
</parameter_description>
</parameter>
</parameters>
-<return> a #GtkWidget
+<return> a `GtkWidget`
</return>
</function>
@@ -50228,7 +50288,7 @@ Returns the `value` of the `GtkLevelBar`.
</parameter>
</parameters>
<return> a value in the interval between
-`GtkLevelBar`:min-value and `GtkLevelBar`:max-value
+[property@Gtk.LevelBar:min-value[ and [property@Gtk.LevelBar:max-value]
</return>
</function>
@@ -50517,7 +50577,7 @@ widgets kept alive is 2 * above_below + center + 1.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkListBase
+<parameter_description> a `GtkListBase`
</parameter_description>
</parameter>
<parameter name="center">
@@ -50727,7 +50787,7 @@ list, %NULL is returned.
</parameter_description>
</parameter>
</parameters>
-<return> the child `GtkWidget` or %NULL
+<return> the child `GtkWidget`
</return>
</function>
@@ -50747,8 +50807,7 @@ Gets the row at the @y position.
</parameter_description>
</parameter>
</parameters>
-<return> the row or %NULL
-in case no row exists for the given y coordinate.
+<return> the row
</return>
</function>
@@ -50768,7 +50827,7 @@ find all selected rows.
</parameter_description>
</parameter>
</parameters>
-<return> the selected row or %NULL
+<return> the selected row
</return>
</function>
@@ -51038,7 +51097,7 @@ the state of it.
</parameter_description>
</parameter>
</parameters>
-<return> the current header, or %NULL if none
+<return> the current header
</return>
</function>
@@ -51155,7 +51214,7 @@ and be shown in front of the row in the listbox.
</parameter_description>
</parameter>
<parameter name="header">
-<parameter_description> the header, or %NULL
+<parameter_description> the header
</parameter_description>
</parameter>
</parameters>
@@ -51205,7 +51264,7 @@ Make @row the currently selected row.
</parameter_description>
</parameter>
<parameter name="row">
-<parameter_description> The row to select or %NULL
+<parameter_description> The row to select
</parameter_description>
</parameter>
</parameters>
@@ -51275,7 +51334,7 @@ to manually do that.
</parameter_description>
</parameter>
<parameter name="adjustment">
-<parameter_description> the adjustment, or %NULL
+<parameter_description> the adjustment
</parameter_description>
</parameter>
</parameters>
@@ -51382,7 +51441,7 @@ it doesn't display any visible children.
</parameter_description>
</parameter>
<parameter name="placeholder">
-<parameter_description> a #GtkWidget or %NULL
+<parameter_description> a `GtkWidget`
</parameter_description>
</parameter>
</parameters>
@@ -51613,11 +51672,11 @@ This is most useful when scrolling.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkListItemManager
+<parameter_description> a `GtkListItemManager`
</parameter_description>
</parameter>
<parameter name="list_item">
-<parameter_description> an acquired #GtkListItem that should be moved to represent
+<parameter_description> an acquired `GtkListItem` that should be moved to represent
a different row
</parameter_description>
</parameter>
@@ -51644,7 +51703,7 @@ gtk_list_item_manager_acquire_list_item().
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkListItemManager
+<parameter_description> a `GtkListItemManager`
</parameter_description>
</parameter>
<parameter name="position">
@@ -51670,11 +51729,11 @@ the position of an item changes, like when new items are added before it.
</description>
<parameters>
<parameter name="self">
-<parameter_description> a #GtkListItemManager
+<parameter_description> a `GtkListItemManager`
</parameter_description>
</parameter>
<parameter name="item">
-<parameter_description> a #GtkListItem that has been acquired
+<parameter_description> a `GtkListItem` that has been acquired
</parameter_description>
</parameter>
<parameter name="position">
@@ -51772,11 +51831,11 @@ values, you need to call gtk_list_store_set() or gtk_list_store_set_value().
</description>
<parameters>
<parameter name="list_store">
-<parameter_description> A #GtkListStore
+<parameter_description> A `GtkListStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> An unset #GtkTreeIter to set to the appended row
+<parameter_description> An unset `GtkTreeIter` to set to the appended row
</parameter_description>
</parameter>
</parameters>
@@ -51791,7 +51850,7 @@ Removes all rows from the list store.
</description>
<parameters>
<parameter name="list_store">
-<parameter_description> a #GtkListStore.
+<parameter_description> a `GtkListStore`.
</parameter_description>
</parameter>
</parameters>
@@ -51810,11 +51869,11 @@ gtk_list_store_set() or gtk_list_store_set_value().
</description>
<parameters>
<parameter name="list_store">
-<parameter_description> A #GtkListStore
+<parameter_description> A `GtkListStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> An unset #GtkTreeIter to set to the new row
+<parameter_description> An unset `GtkTreeIter` to set to the new row
</parameter_description>
</parameter>
<parameter name="position">
@@ -51836,15 +51895,15 @@ in values, you need to call gtk_list_store_set() or gtk_list_store_set_value().
</description>
<parameters>
<parameter name="list_store">
-<parameter_description> A #GtkListStore
+<parameter_description> A `GtkListStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> An unset #GtkTreeIter to set to the new row
+<parameter_description> An unset `GtkTreeIter` to set to the new row
</parameter_description>
</parameter>
<parameter name="sibling">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> A valid `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -51862,15 +51921,15 @@ values, you need to call gtk_list_store_set() or gtk_list_store_set_value().
</description>
<parameters>
<parameter name="list_store">
-<parameter_description> A #GtkListStore
+<parameter_description> A `GtkListStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> An unset #GtkTreeIter to set to the new row
+<parameter_description> An unset `GtkTreeIter` to set to the new row
</parameter_description>
</parameter>
<parameter name="sibling">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> A valid `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -51902,23 +51961,23 @@ iter
}
]|
-with the difference that the former will only emit #GtkTreeModel::row-inserted
-once, while the latter will emit #GtkTreeModel::row-inserted,
-#GtkTreeModel::row-changed and, if the list store is sorted,
-#GtkTreeModel::rows-reordered for every inserted value.
+with the difference that the former will only emit `GtkTreeModel`::row-inserted
+once, while the latter will emit `GtkTreeModel`::row-inserted,
+`GtkTreeModel`::row-changed and, if the list store is sorted,
+`GtkTreeModel`::rows-reordered for every inserted value.
-Since emitting the #GtkTreeModel::rows-reordered signal repeatedly can
+Since emitting the `GtkTreeModel::rows-reordered` signal repeatedly can
affect the performance of the program, gtk_list_store_insert_with_values()
should generally be preferred when inserting rows in a sorted list store.
</description>
<parameters>
<parameter name="list_store">
-<parameter_description> A #GtkListStore
+<parameter_description> A `GtkListStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> An unset #GtkTreeIter to set to the new row
+<parameter_description> An unset `GtkTreeIter` to set to the new row
</parameter_description>
</parameter>
<parameter name="position">
@@ -51945,11 +52004,11 @@ This function is mainly intended for language-bindings.
</description>
<parameters>
<parameter name="list_store">
-<parameter_description> A #GtkListStore
+<parameter_description> A `GtkListStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> An unset #GtkTreeIter to set to the new row
+<parameter_description> An unset `GtkTreeIter` to set to the new row
</parameter_description>
</parameter>
<parameter name="position">
@@ -51977,17 +52036,17 @@ This function is mainly intended for language-bindings.
> This function is slow. Only use it for debugging and/or testing
> purposes.
-Checks if the given iter is a valid iter for this #GtkListStore.
+Checks if the given iter is a valid iter for this `GtkListStore`.
</description>
<parameters>
<parameter name="list_store">
-<parameter_description> A #GtkListStore.
+<parameter_description> A `GtkListStore`.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> A #GtkTreeIter.
+<parameter_description> A `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -52004,15 +52063,15 @@ will be moved to the start of the list.
</description>
<parameters>
<parameter name="store">
-<parameter_description> A #GtkListStore.
+<parameter_description> A `GtkListStore`.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> A #GtkTreeIter.
+<parameter_description> A `GtkTreeIter`
</parameter_description>
</parameter>
<parameter name="position">
-<parameter_description> A #GtkTreeIter or %NULL.
+<parameter_description> A `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -52028,15 +52087,15 @@ will be moved to the end of the list.
</description>
<parameters>
<parameter name="store">
-<parameter_description> A #GtkListStore.
+<parameter_description> A `GtkListStore`.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> A #GtkTreeIter.
+<parameter_description> A `GtkTreeIter`
</parameter_description>
</parameter>
<parameter name="position">
-<parameter_description> A #GtkTreeIter, or %NULL.
+<parameter_description> A `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -52050,8 +52109,8 @@ in. Note that only types derived from standard GObject fundamental types
are supported.
As an example, `gtk_list_store_new (3, G_TYPE_INT, G_TYPE_STRING,
-GDK_TYPE_TEXTURE);` will create a new #GtkListStore with three columns, of type
-int, string and #GdkTexture, respectively.
+GDK_TYPE_TEXTURE);` will create a new `GtkListStore` with three columns, of type
+int, string and `GdkTexture`, respectively.
</description>
@@ -52061,11 +52120,11 @@ int, string and #GdkTexture, respectively.
</parameter_description>
</parameter>
<parameter name="Varargs">
-<parameter_description> all #GType types for the columns, from first to last
+<parameter_description> all `GType` types for the columns, from first to last
</parameter_description>
</parameter>
</parameters>
-<return> a new #GtkListStore
+<return> a new `GtkListStore`
</return>
</function>
@@ -52081,11 +52140,11 @@ Non-vararg creation function. Used primarily by language bindings.
</parameter_description>
</parameter>
<parameter name="types">
-<parameter_description> an array of #GType types for the columns, from first to last
+<parameter_description> an array of `GType` types for the columns, from first to last
</parameter_description>
</parameter>
</parameters>
-<return> a new #GtkListStore
+<return> a new `GtkListStore`
</return>
</function>
@@ -52099,11 +52158,11 @@ values, you need to call gtk_list_store_set() or gtk_list_store_set_value().
</description>
<parameters>
<parameter name="list_store">
-<parameter_description> A #GtkListStore
+<parameter_description> A `GtkListStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> An unset #GtkTreeIter to set to the prepend row
+<parameter_description> An unset `GtkTreeIter` to set to the prepend row
</parameter_description>
</parameter>
</parameters>
@@ -52120,11 +52179,11 @@ to the last row in @list_store.
</description>
<parameters>
<parameter name="list_store">
-<parameter_description> A #GtkListStore
+<parameter_description> A `GtkListStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> A valid #GtkTreeIter
+<parameter_description> A valid `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -52140,7 +52199,7 @@ this function only works with unsorted stores.
</description>
<parameters>
<parameter name="store">
-<parameter_description> A #GtkListStore.
+<parameter_description> A `GtkListStore`.
</parameter_description>
</parameter>
<parameter name="new_order">
@@ -52169,7 +52228,7 @@ will be copied if it is a %G_TYPE_STRING or %G_TYPE_BOXED.
</description>
<parameters>
<parameter name="list_store">
-<parameter_description> a #GtkListStore
+<parameter_description> a `GtkListStore`
</parameter_description>
</parameter>
<parameter name="iter">
@@ -52186,15 +52245,15 @@ will be copied if it is a %G_TYPE_STRING or %G_TYPE_BOXED.
<function name="gtk_list_store_set_column_types">
<description>
-This function is meant primarily for #GObjects that inherit from #GtkListStore,
-and should only be used when constructing a new #GtkListStore. It will not
-function after a row has been added, or a method on the #GtkTreeModel
+This function is meant primarily for `GObject`s that inherit from `GtkListStore`,
+and should only be used when constructing a new `GtkListStore`. It will not
+function after a row has been added, or a method on the `GtkTreeModel`
interface is called.
</description>
<parameters>
<parameter name="list_store">
-<parameter_description> A #GtkListStore
+<parameter_description> A `GtkListStore`
</parameter_description>
</parameter>
<parameter name="n_columns">
@@ -52202,7 +52261,7 @@ interface is called.
</parameter_description>
</parameter>
<parameter name="types">
-<parameter_description> An array length n of #GTypes
+<parameter_description> An array length n of `GType`s
</parameter_description>
</parameter>
</parameters>
@@ -52218,11 +52277,11 @@ bindings.
</description>
<parameters>
<parameter name="list_store">
-<parameter_description> A #GtkListStore
+<parameter_description> A `GtkListStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> A valid #GtkTreeIter for the row being modified
+<parameter_description> A valid `GtkTreeIter` for the row being modified
</parameter_description>
</parameter>
<parameter name="var_args">
@@ -52243,11 +52302,11 @@ column.
</description>
<parameters>
<parameter name="list_store">
-<parameter_description> A #GtkListStore
+<parameter_description> A `GtkListStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> A valid #GtkTreeIter for the row being modified
+<parameter_description> A valid `GtkTreeIter` for the row being modified
</parameter_description>
</parameter>
<parameter name="column">
@@ -52273,11 +52332,11 @@ change is not known until run-time.
</description>
<parameters>
<parameter name="list_store">
-<parameter_description> A #GtkListStore
+<parameter_description> A `GtkListStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> A valid #GtkTreeIter for the row being modified
+<parameter_description> A valid `GtkTreeIter` for the row being modified
</parameter_description>
</parameter>
<parameter name="columns">
@@ -52304,15 +52363,15 @@ unsorted stores.
</description>
<parameters>
<parameter name="store">
-<parameter_description> A #GtkListStore.
+<parameter_description> A `GtkListStore`.
</parameter_description>
</parameter>
<parameter name="a">
-<parameter_description> A #GtkTreeIter.
+<parameter_description> A `GtkTreeIter`
</parameter_description>
</parameter>
<parameter name="b">
-<parameter_description> Another #GtkTreeIter.
+<parameter_description> Another `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -52417,11 +52476,11 @@ gtk_builder_list_item_factory_new_from_resource ("/resource.ui"));
</description>
<parameters>
<parameter name="model">
-<parameter_description> the model to use, or %NULL
+<parameter_description> the model to use
</parameter_description>
</parameter>
<parameter name="factory">
-<parameter_description> The factory to populate items with, or %NULL
+<parameter_description> The factory to populate items with
</parameter_description>
</parameter>
</parameters>
@@ -52458,7 +52517,7 @@ Sets the `GtkListItemFactory` to use for populating list items.
</parameter_description>
</parameter>
<parameter name="factory">
-<parameter_description> the factory to use or %NULL for none
+<parameter_description> the factory to use
</parameter_description>
</parameter>
</parameters>
@@ -52478,7 +52537,7 @@ This must be a [iface@Gtk.SelectionModel] to use.
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> the model to use or %NULL for none
+<parameter_description> the model to use
</parameter_description>
</parameter>
</parameters>
@@ -52566,7 +52625,7 @@ Sets the `GPermission` object that controls @button.
</parameter_description>
</parameter>
<parameter name="permission">
-<parameter_description> a `GPermission` object, or %NULL
+<parameter_description> a `GPermission` object
</parameter_description>
</parameter>
</parameters>
@@ -52613,11 +52672,11 @@ Creates a new `GtkMapListModel` for the given arguments.
</description>
<parameters>
<parameter name="model">
-<parameter_description> The model to map or %NULL for none
+<parameter_description> The model to map
</parameter_description>
</parameter>
<parameter name="map_func">
-<parameter_description> map function or %NULL to not map items
+<parameter_description> map function
</parameter_description>
</parameter>
<parameter name="user_data">
@@ -52654,7 +52713,7 @@ function returns items of the appropriate type.
</parameter_description>
</parameter>
<parameter name="map_func">
-<parameter_description> map function or %NULL to not map items
+<parameter_description> map function
</parameter_description>
</parameter>
<parameter name="user_data">
@@ -52715,8 +52774,7 @@ Creates a new `GtkMediaControls` managing the @stream passed to it.
</description>
<parameters>
<parameter name="stream">
-<parameter_description> a #GtkMediaStream to
-manage or %NULL for none.
+<parameter_description> a `GtkMediaStream` to manage
</parameter_description>
</parameter>
</parameters>
@@ -52735,7 +52793,7 @@ Sets the stream that is controlled by @controls.
</parameter_description>
</parameter>
<parameter name="stream">
-<parameter_description> a `GtkMediaStream`, or %NULL
+<parameter_description> a `GtkMediaStream`
</parameter_description>
</parameter>
</parameters>
@@ -52772,7 +52830,6 @@ When @self is not playing or not playing from a file,
</parameter>
</parameters>
<return> The currently playing file
-or %NULL if not playing from a file.
</return>
</function>
@@ -52791,8 +52848,7 @@ When @self is not playing or not playing from a stream,
</parameter_description>
</parameter>
</parameters>
-<return> The currently playing
-stream or %NULL if not playing from a stream.
+<return> The currently playing stream
</return>
</function>
@@ -53727,7 +53783,7 @@ Returns the `GMenuModel` used to generate the popup.
</parameter_description>
</parameter>
</parameters>
-<return> a `GMenuModel` or %NULL
+<return> a `GMenuModel`
</return>
</function>
@@ -53750,6 +53806,22 @@ returns %NULL.
</return>
</function>
+<function name="gtk_menu_button_get_primary">
+<description>
+Returns whether the menu button acts as a primary menu.
+
+
+</description>
+<parameters>
+<parameter name="menu_button">
+<parameter_description> a `GtkMenuButton`
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE if the button is a primary menu
+</return>
+</function>
+
<function name="gtk_menu_button_get_use_underline">
<description>
Returns whether an embedded underline in the text indicates a
@@ -53983,6 +54055,26 @@ from the @menu_button, and the property is set to %NULL.
<return></return>
</function>
+<function name="gtk_menu_button_set_primary">
+<description>
+Sets whether menu button acts as a primary menu.
+
+Primary menus can be opened with the <kbd>F10</kbd> key.
+
+</description>
+<parameters>
+<parameter name="menu_button">
+<parameter_description> a `GtkMenuButton`
+</parameter_description>
+</parameter>
+<parameter name="primary">
+<parameter_description> whether the menubutton should act as a primary menu
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
<function name="gtk_menu_button_set_use_underline">
<description>
If true, an underline in the text indicates a mnemonic.
@@ -54050,7 +54142,7 @@ Sets the secondary text of the message dialog.
</parameter_description>
</parameter>
<parameter name="message_format">
-<parameter_description> printf()-style format string, or %NULL
+<parameter_description> printf()-style format string
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -54079,7 +54171,7 @@ for the corresponding function in the parent [class@Gtk.Dialog].
</parameter>
</parameters>
<return> A `GtkBox` corresponding to the
-“message area” in the @message_dialog.
+“message area” in the @message_dialog
</return>
</function>
@@ -54096,7 +54188,7 @@ for more details.
</description>
<parameters>
<parameter name="parent">
-<parameter_description> transient parent, or %NULL for none
+<parameter_description> transient parent
</parameter_description>
</parameter>
<parameter name="flags">
@@ -54112,7 +54204,7 @@ for more details.
</parameter_description>
</parameter>
<parameter name="message_format">
-<parameter_description> printf()-style format string, or %NULL
+<parameter_description> printf()-style format string
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -54159,7 +54251,7 @@ markup);
</description>
<parameters>
<parameter name="parent">
-<parameter_description> transient parent, or %NULL for none
+<parameter_description> transient parent
</parameter_description>
</parameter>
<parameter name="flags">
@@ -54175,7 +54267,7 @@ markup);
</parameter_description>
</parameter>
<parameter name="message_format">
-<parameter_description> printf()-style format string, or %NULL
+<parameter_description> printf()-style format string
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -54264,7 +54356,7 @@ Creates a new GtkModelButton.
</description>
<parameters>
</parameters>
-<return> the newly created #GtkModelButton widget
+<return> the newly created GtkModelButton widget
</return>
</function>
@@ -54326,7 +54418,7 @@ Creates a new `GtkMountOperation`.
</description>
<parameters>
<parameter name="parent">
-<parameter_description> transient parent of the window, or %NULL
+<parameter_description> transient parent of the window
</parameter_description>
</parameter>
</parameters>
@@ -54364,7 +54456,7 @@ Sets the transient parent for windows shown by the
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> transient parent of the window, or %NULL
+<parameter_description> transient parent of the window
</parameter_description>
</parameter>
</parameters>
@@ -54435,7 +54527,7 @@ Creates a new selection to handle @model.
</description>
<parameters>
<parameter name="model">
-<parameter_description> the `GListModel` to manage, or %NULL
+<parameter_description> the `GListModel` to manage
</parameter_description>
</parameter>
</parameters>
@@ -54730,7 +54822,7 @@ Passing %NULL for @parent unsets the current transient window.
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> parent window, or %NULL
+<parameter_description> parent window
</parameter_description>
</parameter>
</parameters>
@@ -54902,7 +54994,7 @@ Creates a new selection to handle @model.
</description>
<parameters>
<parameter name="model">
-<parameter_description> the `GListModel` to manage, or %NULL
+<parameter_description> the `GListModel` to manage
</parameter_description>
</parameter>
</parameters>
@@ -54980,7 +55072,7 @@ for the page, or %NULL to use the default label, “page N”
<parameter name="menu_label">
<parameter_description> the widget to use as a label for the
page-switch menu, if that is enabled. If %NULL, and @tab_label
-is a #GtkLabel or %NULL, then the menu label will be a newly
+is a `GtkLabel` or %NULL, then the menu label will be a newly
created label with the same text as @tab_label; if @tab_label
is not a `GtkLabel`, @menu_label must be specified if the
page-switch menu is to be used.
@@ -55404,9 +55496,9 @@ for the page, or %NULL to use the default label, “page N”
<parameter name="menu_label">
<parameter_description> the widget to use as a label for the
page-switch menu, if that is enabled. If %NULL, and @tab_label
-is a #GtkLabel or %NULL, then the menu label will be a newly
+is a `GtkLabel` or %NULL, then the menu label will be a newly
created label with the same text as @tab_label; if @tab_label
-is not a #GtkLabel, @menu_label must be specified if the
+is not a `GtkLabel`, @menu_label must be specified if the
page-switch menu is to be used.
</parameter_description>
</parameter>
@@ -55534,7 +55626,7 @@ Prepends a page to @notebook.
</parameter_description>
</parameter>
<parameter name="tab_label">
-<parameter_description> the #GtkWidget to be used as the label
+<parameter_description> the `GtkWidget` to be used as the label
for the page, or %NULL to use the default label, “page N”
</parameter_description>
</parameter>
@@ -55568,9 +55660,9 @@ for the page, or %NULL to use the default label, “page N”
<parameter name="menu_label">
<parameter_description> the widget to use as a label for the
page-switch menu, if that is enabled. If %NULL, and @tab_label
-is a #GtkLabel or %NULL, then the menu label will be a newly
+is a `GtkLabel` or %NULL, then the menu label will be a newly
created label with the same text as @tab_label; if @tab_label
-is not a #GtkLabel, @menu_label must be specified if the
+is not a `GtkLabel`, @menu_label must be specified if the
page-switch menu is to be used.
</parameter_description>
</parameter>
@@ -55657,7 +55749,7 @@ more than one widget on the same side.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> a #GtkWidget
+<parameter_description> a `GtkWidget`
</parameter_description>
</parameter>
<parameter name="pack_type">
@@ -56000,7 +56092,7 @@ Gets the expression that is evaluated to obtain numbers from items.
</parameter_description>
</parameter>
</parameters>
-<return> a `GtkExpression`, or %NULL
+<return> a `GtkExpression`
</return>
</function>
@@ -56056,7 +56148,7 @@ numerically, such as %G_TYPE_INT or %G_TYPE_DOUBLE.
</parameter_description>
</parameter>
<parameter name="expression">
-<parameter_description> a `GtkExpression`, or %NULL
+<parameter_description> a `GtkExpression`
</parameter_description>
</parameter>
</parameters>
@@ -56148,7 +56240,7 @@ Retrieves the orientation of the @orientable.
</parameter_description>
</parameter>
</parameters>
-<return> the orientation of the @orientable.
+<return> the orientation of the @orientable
</return>
</function>
@@ -56163,7 +56255,7 @@ Sets the orientation of the @orientable.
</parameter_description>
</parameter>
<parameter name="orientation">
-<parameter_description> the orientable’s new orientation.
+<parameter_description> the orientable’s new orientation
</parameter_description>
</parameter>
</parameters>
@@ -56497,7 +56589,7 @@ be deemed user-visible.
</parameter_description>
</parameter>
<parameter name="action_name">
-<parameter_description> action name that will be activated in the #GActionGroup
+<parameter_description> action name that will be activated in the `GActionGroup`
</parameter_description>
</parameter>
</parameters>
@@ -56771,7 +56863,7 @@ See [method@Gtk.PageSetup.to_file].
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> return location for an error
</parameter_description>
</parameter>
</parameters>
@@ -56796,12 +56888,12 @@ Reads the page setup from the group @group_name in the key file
</parameter_description>
</parameter>
<parameter name="group_name">
-<parameter_description> the name of the group in the key_file to read, or %NULL
+<parameter_description> the name of the group in the key_file to read
to use the default name “Page Setup”
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> return location for an error
</parameter_description>
</parameter>
</parameters>
@@ -56833,7 +56925,7 @@ Reads the page setup from the file @file_name.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> return location for an error
</parameter_description>
</parameter>
</parameters>
@@ -56873,12 +56965,12 @@ Reads the page setup from the group @group_name in the key file
</parameter_description>
</parameter>
<parameter name="group_name">
-<parameter_description> the name of the group in the key_file to read, or %NULL
+<parameter_description> the name of the group in the key_file to read
to use the default name “Page Setup”
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> return location for an error
</parameter_description>
</parameter>
</parameters>
@@ -56941,7 +57033,7 @@ Sets the page orientation of the `GtkPageSetup`.
</parameter_description>
</parameter>
<parameter name="orientation">
-<parameter_description> a #GtkPageOrientation value
+<parameter_description> a `GtkPageOrientation` value
</parameter_description>
</parameter>
</parameters>
@@ -56962,7 +57054,7 @@ See [method@Gtk.PageSetup.set_paper_size_and_default_margins].
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a #GtkPaperSize
+<parameter_description> a `GtkPaperSize`
</parameter_description>
</parameter>
</parameters>
@@ -56981,7 +57073,7 @@ the margins according to the new paper size.
</parameter_description>
</parameter>
<parameter name="size">
-<parameter_description> a #GtkPaperSize
+<parameter_description> a `GtkPaperSize`
</parameter_description>
</parameter>
</parameters>
@@ -57048,7 +57140,7 @@ This function saves the information from @setup to @file_name.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for errors, or %NULL
+<parameter_description> return location for errors
</parameter_description>
</parameter>
</parameters>
@@ -57060,7 +57152,7 @@ This function saves the information from @setup to @file_name.
<description>
Serialize page setup to an a{sv} variant.
-Return: (transfer none): a new, floating, #GVariant
+Return: (transfer none): a new, floating, `GVariant`
</description>
<parameters>
@@ -57135,11 +57227,11 @@ Creates a new page setup dialog.
</description>
<parameters>
<parameter name="title">
-<parameter_description> the title of the dialog, or %NULL
+<parameter_description> the title of the dialog
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> transient parent of the dialog, or %NULL
+<parameter_description> transient parent of the dialog
</parameter_description>
</parameter>
</parameters>
@@ -57363,7 +57455,7 @@ Sets the position of the divider between the two panes.
</parameter>
<parameter name="position">
<parameter_description> pixel position of divider, a negative value means that the position
-is unset.
+is unset
</parameter_description>
</parameter>
</parameters>
@@ -57777,7 +57869,7 @@ see [func@Gtk.PaperSize.get_default].
</description>
<parameters>
<parameter name="name">
-<parameter_description> a paper size name, or %NULL
+<parameter_description> a paper size name
</parameter_description>
</parameter>
</parameters>
@@ -57887,12 +57979,11 @@ or %NULL to read the first group
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for an error, or %NULL
+<parameter_description> return location for an error
</parameter_description>
</parameter>
</parameters>
-<return> a new `GtkPaperSize` object with the restored
-paper size, or %NULL if an error occurred
+<return> a new `GtkPaperSize` object with the restored paper size
</return>
</function>
@@ -58190,8 +58281,7 @@ Gets the `GdkPaintable` being displayed by the `GtkPicture`.
</parameter_description>
</parameter>
</parameters>
-<return> the displayed paintable, or %NULL if
-the picture is empty
+<return> the displayed paintable
</return>
</function>
@@ -58260,7 +58350,7 @@ its size and contents in response to it.
</description>
<parameters>
<parameter name="paintable">
-<parameter_description> a `GdkPaintable`, or %NULL
+<parameter_description> a `GdkPaintable`
</parameter_description>
</parameter>
</parameters>
@@ -58281,7 +58371,7 @@ The pixbuf must not be modified after passing it to this function.
</description>
<parameters>
<parameter name="pixbuf">
-<parameter_description> a `GdkPixbuf`, or %NULL
+<parameter_description> a `GdkPixbuf`
</parameter_description>
</parameter>
</parameters>
@@ -58372,7 +58462,7 @@ See [ctor@Gtk.Picture.new_for_file] for details.
</parameter_description>
</parameter>
<parameter name="file">
-<parameter_description> a `GFile` or %NULL
+<parameter_description> a `GFile`
</parameter_description>
</parameter>
</parameters>
@@ -58439,7 +58529,7 @@ See [ctor@Gtk.Picture.new_for_paintable] for details.
</parameter_description>
</parameter>
<parameter name="paintable">
-<parameter_description> a `GdkPaintable` or %NULL
+<parameter_description> a `GdkPaintable`
</parameter_description>
</parameter>
</parameters>
@@ -58461,7 +58551,7 @@ This is a utility function that calls [method@Gtk.Picture.set_paintable].
</parameter_description>
</parameter>
<parameter name="pixbuf">
-<parameter_description> a `GdkPixbuf` or %NULL
+<parameter_description> a `GdkPixbuf`
</parameter_description>
</parameter>
</parameters>
@@ -58715,7 +58805,7 @@ Creates a `GtkPopoverMenuBar` from a `GMenuModel`.
</description>
<parameters>
<parameter name="model">
-<parameter_description> a `GMenuModel`, or %NULL
+<parameter_description> a `GMenuModel`
</parameter_description>
</parameter>
</parameters>
@@ -58736,7 +58826,7 @@ gtk_popover_menu_bar_add_child().
</parameter_description>
</parameter>
<parameter name="child">
-<parameter_description> the #GtkWidget to remove
+<parameter_description> the `GtkWidget` to remove
</parameter_description>
</parameter>
</parameters>
@@ -58756,7 +58846,7 @@ its contents.
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> a `GMenuModel`, or %NULL
+<parameter_description> a `GMenuModel`
</parameter_description>
</parameter>
</parameters>
@@ -58811,7 +58901,7 @@ to control this.
</description>
<parameters>
<parameter name="model">
-<parameter_description> a `GMenuModel`, or %NULL
+<parameter_description> a `GMenuModel`
</parameter_description>
</parameter>
</parameters>
@@ -58885,7 +58975,7 @@ to @model.
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> a `GMenuModel`, or %NULL
+<parameter_description> a `GMenuModel`
</parameter_description>
</parameter>
</parameters>
@@ -58908,10 +58998,8 @@ Creates a new `GtkPopover`.
<description>
Pops @popover down.
-This is different from a [method Gtk Widget hide] call
-in that it may show the popover with a transition. If
-you want to hide the popover without a transition, just
-use [method Gtk Widget hide].
+This may have the side-effect of closing a parent popover
+as well. See [property@Gtk.Popover:cascade-popdown].
</description>
<parameters>
@@ -58927,11 +59015,6 @@ use [method Gtk Widget hide].
<description>
Pops @popover up.
-This is different from a [method Gtk Widget show() call
-in that it may show the popover with a transition. If
-you want to show the popover without a transition, just
-use [method Gtk Widget show].
-
</description>
<parameters>
<parameter name="popover">
@@ -59161,8 +59244,7 @@ Returns the current list of printers.
<parameters>
</parameters>
<return>
-A list of #GtkPrinter objects. The list should be freed
-with g_list_free().
+A list of `GtkPrinter` objects
</return>
</function>
@@ -59659,7 +59741,7 @@ the print job should be rendered.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for errors, or %NULL
+<parameter_description> return location for errors
</parameter_description>
</parameter>
</parameters>
@@ -60419,7 +60501,7 @@ given `GtkPrintOperation`.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> Return location for errors, or %NULL
+<parameter_description> Return location for errors
</parameter_description>
</parameter>
</parameters>
@@ -60513,7 +60595,7 @@ to the [signal@Gtk.PrintOperation::request-page-setup] signal.
</parameter_description>
</parameter>
<parameter name="default_page_setup">
-<parameter_description> a `GtkPageSetup`, or %NULL
+<parameter_description> a `GtkPageSetup`
</parameter_description>
</parameter>
</parameters>
@@ -60791,12 +60873,12 @@ is at the top left corner of the imageable area (i.e. inside the margins).
<function name="gtk_print_run_page_setup_dialog">
<description>
Runs a page setup dialog, letting the user modify the values from
-@page_setup. If the user cancels the dialog, the returned #GtkPageSetup
-is identical to the passed in @page_setup, otherwise it contains the
+@page_setup. If the user cancels the dialog, the returned `GtkPageSetup`
+is identical to the passed in @page_setup, otherwise it contains the
modifications done in the dialog.
Note that this function may use a recursive mainloop to show the page
-setup dialog. See gtk_print_run_page_setup_dialog_async() if this is
+setup dialog. See gtk_print_run_page_setup_dialog_async() if this is
a problem.
@@ -60807,38 +60889,38 @@ a problem.
</parameter_description>
</parameter>
<parameter name="page_setup">
-<parameter_description> an existing #GtkPageSetup
+<parameter_description> an existing `GtkPageSetup`
</parameter_description>
</parameter>
<parameter name="settings">
-<parameter_description> a #GtkPrintSettings
+<parameter_description> a `GtkPrintSettings`
</parameter_description>
</parameter>
</parameters>
-<return> a new #GtkPageSetup
+<return> a new `GtkPageSetup`
</return>
</function>
<function name="gtk_print_run_page_setup_dialog_async">
<description>
-Runs a page setup dialog, letting the user modify the values from @page_setup.
+Runs a page setup dialog, letting the user modify the values from @page_setup.
-In contrast to gtk_print_run_page_setup_dialog(), this function returns after
-showing the page setup dialog on platforms that support this, and calls @done_cb
+In contrast to gtk_print_run_page_setup_dialog(), this function returns after
+showing the page setup dialog on platforms that support this, and calls @done_cb
from a signal handler for the ::response signal of the dialog.
</description>
<parameters>
<parameter name="parent">
-<parameter_description> transient parent, or %NULL
+<parameter_description> transient parent
</parameter_description>
</parameter>
<parameter name="page_setup">
-<parameter_description> an existing #GtkPageSetup, or %NULL
+<parameter_description> an existing `GtkPageSetup`
</parameter_description>
</parameter>
<parameter name="settings">
-<parameter_description> a #GtkPrintSettings
+<parameter_description> a `GtkPrintSettings`
</parameter_description>
</parameter>
<parameter name="done_cb">
@@ -61563,7 +61645,7 @@ See [method@Gtk.PrintSettings.to_file].
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for errors, or %NULL
+<parameter_description> return location for errors
</parameter_description>
</parameter>
</parameters>
@@ -61595,7 +61677,7 @@ to use the default “Print Settings”
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for errors, or %NULL
+<parameter_description> return location for errors
</parameter_description>
</parameter>
</parameters>
@@ -61627,7 +61709,7 @@ Reads the print settings from @file_name.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for errors, or %NULL
+<parameter_description> return location for errors
</parameter_description>
</parameter>
</parameters>
@@ -61671,7 +61753,7 @@ the default “Print Settings”
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for errors, or %NULL
+<parameter_description> return location for errors
</parameter_description>
</parameter>
</parameters>
@@ -61694,7 +61776,7 @@ Associates @value with @key.
</parameter_description>
</parameter>
<parameter name="value">
-<parameter_description> a string value, or %NULL
+<parameter_description> a string value
</parameter_description>
</parameter>
</parameters>
@@ -61810,7 +61892,7 @@ Sets the value of %GTK_PRINT_SETTINGS_DUPLEX.
</parameter_description>
</parameter>
<parameter name="duplex">
-<parameter_description> a #GtkPrintDuplex value
+<parameter_description> a `GtkPrintDuplex` value
</parameter_description>
</parameter>
</parameters>
@@ -61950,7 +62032,7 @@ Sets the value of %GTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT.
</parameter_description>
</parameter>
<parameter name="number_up_layout">
-<parameter_description> a #GtkNumberUpLayout value
+<parameter_description> a `GtkNumberUpLayout` value
</parameter_description>
</parameter>
</parameters>
@@ -62026,7 +62108,7 @@ Sets the value of %GTK_PRINT_SETTINGS_PAGE_SET.
</parameter_description>
</parameter>
<parameter name="page_set">
-<parameter_description> a #GtkPageSet value
+<parameter_description> a `GtkPageSet` value
</parameter_description>
</parameter>
</parameters>
@@ -62108,7 +62190,7 @@ Sets the value of %GTK_PRINT_SETTINGS_PRINT_PAGES.
</parameter_description>
</parameter>
<parameter name="pages">
-<parameter_description> a #GtkPrintPages value
+<parameter_description> a `GtkPrintPages` value
</parameter_description>
</parameter>
</parameters>
@@ -62163,7 +62245,7 @@ Sets the value of %GTK_PRINT_SETTINGS_QUALITY.
</parameter_description>
</parameter>
<parameter name="quality">
-<parameter_description> a #GtkPrintQuality value
+<parameter_description> a `GtkPrintQuality` value
</parameter_description>
</parameter>
</parameters>
@@ -62287,7 +62369,7 @@ If the file could not be written then error is set to either a
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for errors, or %NULL
+<parameter_description> return location for errors
</parameter_description>
</parameter>
</parameters>
@@ -62532,11 +62614,11 @@ Creates a new `GtkPrintUnixDialog`.
</description>
<parameters>
<parameter name="title">
-<parameter_description> Title of the dialog, or %NULL
+<parameter_description> Title of the dialog
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> Transient parent of the dialog, or %NULL
+<parameter_description> Transient parent of the dialog
</parameter_description>
</parameter>
</parameters>
@@ -62658,7 +62740,7 @@ is shown.
</parameter_description>
</parameter>
<parameter name="settings">
-<parameter_description> a `GtkPrintSettings`, or %NULL
+<parameter_description> a `GtkPrintSettings`
</parameter_description>
</parameter>
</parameters>
@@ -62803,7 +62885,7 @@ Gets the description of the printer.
</description>
<parameters>
<parameter name="printer">
-<parameter_description> a #GtkPrinter
+<parameter_description> a `GtkPrinter`
</parameter_description>
</parameter>
</parameters>
@@ -63129,7 +63211,7 @@ Gets the groups in this set.
</description>
<parameters>
<parameter name="set">
-<parameter_description> a #GtkPrinterOptionSet
+<parameter_description> a `GtkPrinterOptionSet`
</parameter_description>
</parameter>
</parameters>
@@ -63256,8 +63338,7 @@ so will become invalid if you change the text in the progress bar.
</parameter_description>
</parameter>
</parameters>
-<return> text, or %NULL; this string is owned by the widget
-and should not be modified or freed.
+<return> the text
</return>
</function>
@@ -63424,7 +63505,7 @@ be styled and sized suitably for containing text, as long as
</parameter_description>
</parameter>
<parameter name="text">
-<parameter_description> a UTF-8 string, or %NULL
+<parameter_description> a UTF-8 string
</parameter_description>
</parameter>
</parameters>
@@ -63633,7 +63714,7 @@ Sends an event to a widget, propagating the event to parent widgets
if the event remains unhandled. This function will emit the event
through all the hierarchy of @widget through all propagation phases.
-Events received by GTK from GDK normally begin at a #GtkRoot widget.
+Events received by GTK from GDK normally begin at a `GtkRoot` widget.
Depending on the type of event, existence of modal dialogs, grabs, etc.,
the event may be propagated; if so, this function is used.
@@ -63647,7 +63728,7 @@ of making up expose events.
</description>
<parameters>
<parameter name="widget">
-<parameter_description> a #GtkWidget
+<parameter_description> a `GtkWidget`
</parameter_description>
</parameter>
<parameter name="event">
@@ -63695,9 +63776,10 @@ a property expression.
<function name="gtk_property_expression_new">
<description>
-Creates an expression that looks up a property via the
-given `expression` or the `this` argument when `expression`
-is `NULL`.
+Creates an expression that looks up a property.
+
+The object to use is found by evaluating the `expression`,
+or using the `this` argument when `expression` is `NULL`.
If the resulting object conforms to `this_type`, its property named
`property_name` will be queried. Otherwise, this expression's
@@ -63729,9 +63811,10 @@ query the `this` object
<function name="gtk_property_expression_new_for_pspec">
<description>
-Creates an expression that looks up a property via the
-given `expression` or the `this` argument when `expression`
-is `NULL`.
+Creates an expression that looks up a property.
+
+The object to use is found by evaluating the `expression`,
+or using the `this` argument when `expression` is `NULL`.
If the resulting object conforms to `this_type`, its
property specified by `pspec` will be queried.
@@ -63909,13 +63992,11 @@ This function is useful mainly for `GtkRange` subclasses.
</parameter_description>
</parameter>
<parameter name="slider_start">
-<parameter_description> return location for the slider's
-start, or %NULL
+<parameter_description> return location for the slider's start
</parameter_description>
</parameter>
<parameter name="slider_end">
-<parameter_description> return location for the slider's
-end, or %NULL
+<parameter_description> return location for the slider's end
</parameter_description>
</parameter>
</parameters>
@@ -64224,6 +64305,9 @@ it will be clamped to fit inside them. The range emits the
<description>
Creates a `GAppInfo` for the specified `GtkRecentInfo`
+In case of error, @error will be set either with a
+%GTK_RECENT_MANAGER_ERROR or a %G_IO_ERROR
+
</description>
<parameters>
@@ -64238,13 +64322,11 @@ application for the MIME type is used
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+<parameter_description> return location for a `GError`
</parameter_description>
</parameter>
</parameters>
-<return> the newly created `GAppInfo`,
-or %NULL. In case of error, @error will be set either with a
-%GTK_RECENT_MANAGER_ERROR or a %G_IO_ERROR
+<return> the newly created `GAppInfo`
</return>
</function>
@@ -64279,7 +64361,7 @@ was added to the recently used resources list.
</parameter_description>
</parameter>
</parameters>
-<return> a #GDateTime for the time
+<return> a `GDateTime` for the time
when the resource was added
</return>
</function>
@@ -64413,8 +64495,7 @@ Retrieves the icon associated to the resource MIME type.
</parameter_description>
</parameter>
</parameters>
-<return> a #GIcon containing the icon, or %NULL.
-Use g_object_unref() when finished using the icon
+<return> a `GIcon` containing the icon
</return>
</function>
@@ -64473,7 +64554,7 @@ for the resource was last modified.
</parameter_description>
</parameter>
</parameters>
-<return> a #GDateTime for the time
+<return> a `GDateTime` for the time
when the resource was last modified
</return>
</function>
@@ -64570,7 +64651,7 @@ for the resource was last visited.
</parameter_description>
</parameter>
</parameters>
-<return> a #GDateTime for the time
+<return> a `GDateTime` for the time
when the resource was last visited
</return>
</function>
@@ -64850,7 +64931,7 @@ like its MIME type, or its display name.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a return location for a #GError, or %NULL
+<parameter_description> a return location for a `GError`
</parameter_description>
</parameter>
</parameters>
@@ -64885,7 +64966,7 @@ by the URIs, but only the URI used in the recently used resources list.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a return location for a #GError, or %NULL
+<parameter_description> a return location for a `GError`
</parameter_description>
</parameter>
</parameters>
@@ -64903,7 +64984,7 @@ resources list, and emits the [signal@Gtk.RecentManager::changed]
signal each time something inside the list changes.
`GtkRecentManager` objects are expensive: be sure to create them
-only when needed. You should use [type_func@Gtk.RecentManager.get_default]
+only when needed. You should use [func@Gtk.RecentManager.get_default]
instead.
@@ -64926,7 +65007,7 @@ Purges every item from the recently used resources list.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> a return location for a #GError, or %NULL
+<parameter_description> a return location for a `GError`
</parameter_description>
</parameter>
</parameters>
@@ -64952,7 +65033,7 @@ list handled by a recent manager.
</parameter_description>
</parameter>
<parameter name="error">
-<parameter_description> return location for a #GError, or %NULL
+<parameter_description> return location for a `GError`
</parameter_description>
</parameter>
</parameters>
@@ -64963,18 +65044,18 @@ removed by the recently used resources list, and %FALSE otherwise
<function name="gtk_render_activity">
<description>
-Renders an activity indicator (such as in #GtkSpinner).
+Renders an activity indicator (such as in `GtkSpinner`).
The state %GTK_STATE_FLAG_CHECKED determines whether there is
activity going on.
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkStyleContext
+<parameter_description> a `GtkStyleContext`
</parameter_description>
</parameter>
<parameter name="cr">
-<parameter_description> a #cairo_t
+<parameter_description> a `cairo_t`
</parameter_description>
</parameter>
<parameter name="x">
@@ -65008,11 +65089,11 @@ Typical arrow rendering at 0, 1⁄2 π;, π; and 3⁄2 π:
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkStyleContext
+<parameter_description> a `GtkStyleContext`
</parameter_description>
</parameter>
<parameter name="cr">
-<parameter_description> a #cairo_t
+<parameter_description> a `cairo_t`
</parameter_description>
</parameter>
<parameter name="angle">
@@ -65047,11 +65128,11 @@ Typical background rendering, showing the effect of
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkStyleContext
+<parameter_description> a `GtkStyleContext`
</parameter_description>
</parameter>
<parameter name="cr">
-<parameter_description> a #cairo_t
+<parameter_description> a `cairo_t`
</parameter_description>
</parameter>
<parameter name="x">
@@ -65076,7 +65157,7 @@ Typical background rendering, showing the effect of
<function name="gtk_render_check">
<description>
-Renders a checkmark (as in a #GtkCheckButton).
+Renders a checkmark (as in a `GtkCheckButton`).
The %GTK_STATE_FLAG_CHECKED state determines whether the check is
on or off, and %GTK_STATE_FLAG_INCONSISTENT determines whether it
@@ -65089,11 +65170,11 @@ Typical checkmark rendering:
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkStyleContext
+<parameter_description> a `GtkStyleContext`
</parameter_description>
</parameter>
<parameter name="cr">
-<parameter_description> a #cairo_t
+<parameter_description> a `cairo_t`
</parameter_description>
</parameter>
<parameter name="x">
@@ -65118,7 +65199,7 @@ Typical checkmark rendering:
<function name="gtk_render_expander">
<description>
-Renders an expander (as used in #GtkTreeView and #GtkExpander) in the area
+Renders an expander (as used in `GtkTreeView` and `GtkExpander`) in the area
defined by @x, @y, @width, @height. The state %GTK_STATE_FLAG_CHECKED
determines whether the expander is collapsed or expanded.
@@ -65129,11 +65210,11 @@ Typical expander rendering:
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkStyleContext
+<parameter_description> a `GtkStyleContext`
</parameter_description>
</parameter>
<parameter name="cr">
-<parameter_description> a #cairo_t
+<parameter_description> a `cairo_t`
</parameter_description>
</parameter>
<parameter name="x">
@@ -65167,11 +65248,11 @@ Typical focus rendering:
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkStyleContext
+<parameter_description> a `GtkStyleContext`
</parameter_description>
</parameter>
<parameter name="cr">
-<parameter_description> a #cairo_t
+<parameter_description> a `cairo_t`
</parameter_description>
</parameter>
<parameter name="x">
@@ -65206,11 +65287,11 @@ Examples of frame rendering, showing the effect of `border-image`,
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkStyleContext
+<parameter_description> a `GtkStyleContext`
</parameter_description>
</parameter>
<parameter name="cr">
-<parameter_description> a #cairo_t
+<parameter_description> a `cairo_t`
</parameter_description>
</parameter>
<parameter name="x">
@@ -65235,9 +65316,8 @@ Examples of frame rendering, showing the effect of `border-image`,
<function name="gtk_render_handle">
<description>
-Renders a handle (as in #GtkPaned and
-#GtkWindow’s resize grip), in the rectangle
-determined by @x, @y, @width, @height.
+Renders a handle (as in `GtkPaned` and `GtkWindow`’s resize grip),
+in the rectangle determined by @x, @y, @width, @height.
Handles rendered for the paned and grip classes:
@@ -65246,11 +65326,11 @@ Handles rendered for the paned and grip classes:
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkStyleContext
+<parameter_description> a `GtkStyleContext`
</parameter_description>
</parameter>
<parameter name="cr">
-<parameter_description> a #cairo_t
+<parameter_description> a `cairo_t`
</parameter_description>
</parameter>
<parameter name="x">
@@ -65285,15 +65365,15 @@ drawing on displays with high pixel densities.
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkStyleContext
+<parameter_description> a `GtkStyleContext`
</parameter_description>
</parameter>
<parameter name="cr">
-<parameter_description> a #cairo_t
+<parameter_description> a `cairo_t`
</parameter_description>
</parameter>
<parameter name="texture">
-<parameter_description> a #GdkTexture containing the icon to draw
+<parameter_description> a `GdkTexture` containing the icon to draw
</parameter_description>
</parameter>
<parameter name="x">
@@ -65301,7 +65381,7 @@ drawing on displays with high pixel densities.
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> Y position for the @texture
+<parameter_description> Y position for the @texture
</parameter_description>
</parameter>
</parameters>
@@ -65315,11 +65395,11 @@ Renders @layout on the coordinates @x, @y
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkStyleContext
+<parameter_description> a `GtkStyleContext`
</parameter_description>
</parameter>
<parameter name="cr">
-<parameter_description> a #cairo_t
+<parameter_description> a `cairo_t`
</parameter_description>
</parameter>
<parameter name="x">
@@ -65331,7 +65411,7 @@ Renders @layout on the coordinates @x, @y
</parameter_description>
</parameter>
<parameter name="layout">
-<parameter_description> the #PangoLayout to render
+<parameter_description> the `PangoLayout` to render
</parameter_description>
</parameter>
</parameters>
@@ -65345,11 +65425,11 @@ Renders a line from (x0, y0) to (x1, y1).
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkStyleContext
+<parameter_description> a `GtkStyleContext`
</parameter_description>
</parameter>
<parameter name="cr">
-<parameter_description> a #cairo_t
+<parameter_description> a `cairo_t`
</parameter_description>
</parameter>
<parameter name="x0">
@@ -65385,11 +65465,11 @@ Typical option mark rendering:
</description>
<parameters>
<parameter name="context">
-<parameter_description> a #GtkStyleContext
+<parameter_description> a `GtkStyleContext`
</parameter_description>
</parameter>
<parameter name="cr">
-<parameter_description> a #cairo_t
+<parameter_description> a `cairo_t`
</parameter_description>
</parameter>
<parameter name="x">
@@ -65708,8 +65788,7 @@ widget.
</parameter_description>
</parameter>
</parameters>
-<return> the currently focused
-widget, or %NULL if there is none.
+<return> the currently focused widget
</return>
</function>
@@ -65763,15 +65842,14 @@ the lower and upper limits of the scales’ adjustment
</parameter_description>
</parameter>
<parameter name="position">
-<parameter_description> where to draw the mark. For a horizontal scale, #GTK_POS_TOP
+<parameter_description> where to draw the mark. For a horizontal scale, %GTK_POS_TOP
and %GTK_POS_LEFT are drawn above the scale, anything else below.
-For a vertical scale, #GTK_POS_LEFT and %GTK_POS_TOP are drawn to
+For a vertical scale, %GTK_POS_LEFT and %GTK_POS_TOP are drawn to
the left of the scale, anything else to the right.
</parameter_description>
</parameter>
<parameter name="markup">
-<parameter_description> Text to be shown at the mark, using
-Pango markup, or %NULL
+<parameter_description> Text to be shown at the mark, using Pango markup
</parameter_description>
</parameter>
</parameters>
@@ -66057,15 +66135,15 @@ values are undefined.
</description>
<parameters>
<parameter name="scale">
-<parameter_description> a #GtkScale
+<parameter_description> a `GtkScale`
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> location to store X offset of layout, or %NULL
+<parameter_description> location to store X offset of layout
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> location to store Y offset of layout, or %NULL
+<parameter_description> location to store Y offset of layout
</parameter_description>
</parameter>
</parameters>
@@ -66143,7 +66221,7 @@ for your needs, use [method@Gtk.Scale.set_digits] to correct it.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GtkScale
+<return> a new `GtkScale`
</return>
</function>
@@ -66185,7 +66263,7 @@ to the slider.
</description>
<parameters>
<parameter name="scale">
-<parameter_description> a #GtkScale
+<parameter_description> a `GtkScale`
</parameter_description>
</parameter>
<parameter name="draw_value">
@@ -66685,12 +66763,12 @@ See [method@Gtk.ScrolledWindow.set_policy].
</parameter>
<parameter name="hscrollbar_policy">
<parameter_description> location to store the policy
-for the horizontal scrollbar, or %NULL
+for the horizontal scrollbar
</parameter_description>
</parameter>
<parameter name="vscrollbar_policy">
<parameter_description> location to store the policy
-for the vertical scrollbar, or %NULL
+for the vertical scrollbar
</parameter_description>
</parameter>
</parameters>
@@ -67340,7 +67418,7 @@ capture and forward the events yourself with
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> a #GtkWidget
+<parameter_description> a `GtkWidget`
</parameter_description>
</parameter>
</parameters>
@@ -67372,7 +67450,7 @@ selected items from the underlying selection model.
</description>
<parameters>
<parameter name="model">
-<parameter_description> the selection model to filter, or %NULL
+<parameter_description> the selection model to filter
</parameter_description>
</parameter>
</parameters>
@@ -67617,8 +67695,7 @@ be selected.
</parameter_description>
</parameter>
<parameter name="selected">
-<parameter_description> bitmask specifying if items should be selected or
-unselected
+<parameter_description> bitmask specifying if items should be selected or unselected
</parameter_description>
</parameter>
<parameter name="mask">
@@ -67730,7 +67807,7 @@ Sets the GTK debug flags.
Gets the `GtkSettings` object for the default display, creating
it if necessary.
-See [type_func@Gtk.Settings.get_for_display].
+See [func@Gtk.Settings.get_for_display].
</description>
@@ -67837,7 +67914,6 @@ The accepted strings are:
</parameter>
</parameters>
<return> a new `GtkShortcutAction`
-or %NULL on error
</return>
</function>
@@ -67922,8 +67998,9 @@ Gets the mnemonics modifiers for when this controller activates its shortcuts.
<function name="gtk_shortcut_controller_get_scope">
<description>
-Gets the scope for when this controller activates its shortcuts. See
-gtk_shortcut_controller_set_scope() for details.
+Gets the scope for when this controller activates its shortcuts.
+
+See [method@Gtk.ShortcutController.set_scope] for details.
</description>
@@ -67993,12 +68070,12 @@ uses an external shortcut list, this function does nothing.
<function name="gtk_shortcut_controller_set_mnemonics_modifiers">
<description>
-Sets the controller to have the given @mnemonics_modifiers.
+Sets the controller to use the given modifier for mnemonics.
The mnemonics modifiers determines which modifiers need to be pressed to allow
activation of shortcuts with mnemonics triggers.
-GTK normally uses the Alt modifier for mnemonics, except in #GtkPopoverMenus,
+GTK normally uses the Alt modifier for mnemonics, except in `GtkPopoverMenu`s,
where mnemonics can be triggered without any modifiers. It should be very
rarely necessary to change this, and doing so is likely to interfere with
other shortcuts.
@@ -68291,8 +68368,8 @@ If the @trigger is %NULL, the never trigger will be used.
<function name="gtk_shortcut_trigger_compare">
<description>
-The types of @trigger1 and @trigger2 are #gconstpointer only to allow
-use of this function as a #GCompareFunc.
+The types of @trigger1 and @trigger2 are `gconstpointer` only to allow
+use of this function as a `GCompareFunc`.
They must each be a `GtkShortcutTrigger`.
@@ -68318,8 +68395,8 @@ or be greater than @trigger2.
<description>
Checks if @trigger1 and @trigger2 trigger under the same conditions.
-The types of @one and @two are #gconstpointer only to allow use of this
-function with #GHashTable. They must each be a `GtkShortcutTrigger`.
+The types of @one and @two are `gconstpointer` only to allow use of this
+function with `GHashTable`. They must each be a `GtkShortcutTrigger`.
</description>
@@ -68346,8 +68423,8 @@ value only per-process. It may change between different processor
architectures or even different versions of GTK. Do not use this
function as a basis for building protocols or file formats.
-The types of @trigger is #gconstpointer only to allow use of this
-function with #GHashTable. They must each be a `GtkShortcutTrigger`.
+The types of @trigger is `gconstpointer` only to allow use of this
+function with `GHashTable`. They must each be a `GtkShortcutTrigger`.
</description>
@@ -68389,7 +68466,6 @@ triggers in XML files, such as GtkBuilder ui files. Use `<` instead of
</parameter>
</parameters>
<return> a new `GtkShortcutTrigger`
-or %NULL on error
</return>
</function>
@@ -68602,7 +68678,7 @@ necessary for sandbox helpers to parent their dialogs properly.
</parameter_description>
</parameter>
<parameter name="cancellable">
-<parameter_description> a #GCancellable to cancel the launch
+<parameter_description> a `GCancellable` to cancel the launch
</parameter_description>
</parameter>
<parameter name="callback">
@@ -68626,11 +68702,11 @@ of the operation.
</description>
<parameters>
<parameter name="parent">
-<parameter_description> the #GtkWindow passed to gtk_show_uri()
+<parameter_description> the `GtkWindow` passed to gtk_show_uri()
</parameter_description>
</parameter>
<parameter name="result">
-<parameter_description> #GAsyncResult that was passed to @callback
+<parameter_description> `GAsyncResult` that was passed to @callback
</parameter_description>
</parameter>
<parameter name="error">
@@ -68786,7 +68862,7 @@ Creates a new selection to handle @model.
</description>
<parameters>
<parameter name="model">
-<parameter_description> the `GListModel` to manage, or %NULL
+<parameter_description> the `GListModel` to manage
</parameter_description>
</parameter>
</parameters>
@@ -69062,7 +69138,7 @@ of the given @model.
</description>
<parameters>
<parameter name="model">
-<parameter_description> The model to use, or %NULL
+<parameter_description> The model to use
</parameter_description>
</parameter>
<parameter name="offset">
@@ -69303,11 +69379,11 @@ current node.
</description>
<parameters>
<parameter name="snapshot">
-<parameter_description> a #GtkSnapshot
+<parameter_description> a `GtkSnapshot`
</parameter_description>
</parameter>
<parameter name="layout">
-<parameter_description> the #PangoLayout to render
+<parameter_description> the `PangoLayout` to render
</parameter_description>
</parameter>
<parameter name="color">
@@ -69368,7 +69444,7 @@ will become the initial node.
</parameter_description>
</parameter>
<parameter name="node">
-<parameter_description> a #GskRenderNode
+<parameter_description> a `GskRenderNode`
</parameter_description>
</parameter>
</parameters>
@@ -70110,11 +70186,11 @@ Draws a text caret using @snapshot at the specified index of @layout.
</parameter_description>
</parameter>
<parameter name="index">
-<parameter_description> the index in the #PangoLayout
+<parameter_description> the index in the `PangoLayout`
</parameter_description>
</parameter>
<parameter name="direction">
-<parameter_description> the #PangoDirection of the text
+<parameter_description> the `PangoDirection` of the text
</parameter_description>
</parameter>
</parameters>
@@ -70146,7 +70222,7 @@ without changing the current node.
</parameter_description>
</parameter>
<parameter name="layout">
-<parameter_description> the #PangoLayout to render
+<parameter_description> the `PangoLayout` to render
</parameter_description>
</parameter>
</parameters>
@@ -70332,7 +70408,7 @@ or %NULL to use the bounds of the snapshot
</parameter_description>
</parameter>
</parameters>
-<return> a new #GdkPaintable
+<return> a new `GdkPaintable`
</return>
</function>
@@ -70498,11 +70574,11 @@ Creates a new sort list model that uses the @sorter to sort @model.
</description>
<parameters>
<parameter name="model">
-<parameter_description> the model to sort, or %NULL
+<parameter_description> the model to sort
</parameter_description>
</parameter>
<parameter name="sorter">
-<parameter_description> the `GtkSorter` to sort @model with, or %NULL
+<parameter_description> the `GtkSorter` to sort @model with,
</parameter_description>
</parameter>
</parameters>
@@ -70583,15 +70659,15 @@ Sets a new sorter on @self.
<function name="gtk_sorter_changed">
<description>
-Emits the [signal@Gtk.Sorter::changed] signal to notify all users
-of the sorter that it has changed.
+Notifies all users of the sorter that it has changed.
-Users of the sorter should then update the sort order via
-gtk_sorter_compare().
+This emits the [signal@Gtk.Sorter::changed] signal. Users
+of the sorter should then update the sort order via
+[method@Gtk.Sorter.compare].
-Depending on the @change parameter, it may be possible to update
-the sort order without a full resorting. Refer to the
-[enum@Gtk.SorterChange] documentation for details.
+Depending on the @change parameter, it may be possible to
+update the sort order without a full resorting. Refer to
+the [enum@Gtk.SorterChange] documentation for details.
This function is intended for implementors of `GtkSorter`
subclasses and should not be called from other functions.
@@ -70760,11 +70836,11 @@ See [method@Gtk.SpinButton.set_increments].
</parameter_description>
</parameter>
<parameter name="step">
-<parameter_description> location to store step increment, or %NULL
+<parameter_description> location to store step increment
</parameter_description>
</parameter>
<parameter name="page">
-<parameter_description> location to store page increment, or %NULL
+<parameter_description> location to store page increment
</parameter_description>
</parameter>
</parameters>
@@ -70800,11 +70876,11 @@ See [method@Gtk.SpinButton.set_range].
</parameter_description>
</parameter>
<parameter name="min">
-<parameter_description> location to store minimum allowed value, or %NULL
+<parameter_description> location to store minimum allowed value
</parameter_description>
</parameter>
<parameter name="max">
-<parameter_description> location to store maximum allowed value, or %NULL
+<parameter_description> location to store maximum allowed value
</parameter_description>
</parameter>
</parameters>
@@ -70903,8 +70979,7 @@ Creates a new `GtkSpinButton`.
</description>
<parameters>
<parameter name="adjustment">
-<parameter_description> the `GtkAdjustment` that this spin
-button should use, or %NULL
+<parameter_description> the `GtkAdjustment` that this spin button should use
</parameter_description>
</parameter>
<parameter name="climb_rate">
@@ -71312,7 +71387,7 @@ The child is identified by the @name.
</parameter_description>
</parameter>
<parameter name="name">
-<parameter_description> the name for @child or %NULL
+<parameter_description> the name for @child
</parameter_description>
</parameter>
</parameters>
@@ -71391,7 +71466,7 @@ Gets whether @stack is horizontally homogeneous.
<function name="gtk_stack_get_interpolate_size">
<description>
-Returns whether the #GtkStack is set up to interpolate between
+Returns whether the `GtkStack` is set up to interpolate between
the sizes of children on page switch.
@@ -71892,7 +71967,7 @@ based on the page that is about to become current.
<function name="gtk_stack_set_vhomogeneous">
<description>
-Sets the #GtkStack to be vertically homogeneous or not.
+Sets the `GtkStack` to be vertically homogeneous or not.
If it is homogeneous, the `GtkStack` will request the same
height for all its children. If it isn't, the stack
@@ -72002,7 +72077,7 @@ Retrieves the stack.
</parameter_description>
</parameter>
</parameters>
-<return> the associated #GtkStack or
+<return> the associated `GtkStack` or
%NULL if none has been set explicitly
</return>
</function>
@@ -72052,8 +72127,7 @@ Retrieves the stack.
</parameter_description>
</parameter>
</parameters>
-<return> the stack, or %NULL if
-none has been set explicitly.
+<return> the stack
</return>
</function>
@@ -72307,7 +72381,6 @@ and by providing a property to look up on the item.
<parameters>
<parameter name="expression">
<parameter_description> The expression to evaluate
-or %NULL for none
</parameter_description>
</parameter>
</parameters>
@@ -72581,7 +72654,7 @@ Gets the expression that is evaluated to obtain strings from items.
</parameter_description>
</parameter>
</parameters>
-<return> a `GtkExpression`, or %NULL
+<return> a `GtkExpression`
</return>
</function>
@@ -72634,7 +72707,7 @@ The expression must have the type %G_TYPE_STRING.
</parameter_description>
</parameter>
<parameter name="expression">
-<parameter_description> a `GtkExpression`, or %NULL
+<parameter_description> a `GtkExpression`
</parameter_description>
</parameter>
</parameters>
@@ -73182,7 +73255,7 @@ Sets the underlying state of the `GtkSwitch`.
Normally, this is the same as [property@Gtk.Switch:active], unless
the switch is set up for delayed state changes. This function is
-typically called from a [signal@Gtk.Switch`::state-set] signal handler.
+typically called from a [signal@Gtk.Switch::state-set] signal handler.
See [signal@Gtk.Switch::state-set] for details.
@@ -73202,18 +73275,18 @@ See [signal@Gtk.Switch::state-set] for details.
<function name="gtk_test_accessible_assert_property">
<description>
-Checks whether a #GtkAccessible implementation has its accessible
+Checks whether a `GtkAccessible` implementation has its accessible
property set to the expected value, and raises an assertion if the
condition is not satisfied.
</description>
<parameters>
<parameter name="accessible">
-<parameter_description> a #GtkAccessible
+<parameter_description> a `GtkAccessible`
</parameter_description>
</parameter>
<parameter name="property">
-<parameter_description> a #GtkAccessibleProperty
+<parameter_description> a `GtkAccessibleProperty`
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -73226,18 +73299,18 @@ condition is not satisfied.
<function name="gtk_test_accessible_assert_relation">
<description>
-Checks whether a #GtkAccessible implementation has its accessible
+Checks whether a `GtkAccessible` implementation has its accessible
relation set to the expected value, and raises an assertion if the
condition is not satisfied.
</description>
<parameters>
<parameter name="accessible">
-<parameter_description> a #GtkAccessible
+<parameter_description> a `GtkAccessible`
</parameter_description>
</parameter>
<parameter name="relation">
-<parameter_description> a #GtkAccessibleRelation
+<parameter_description> a `GtkAccessibleRelation`
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -73250,17 +73323,17 @@ condition is not satisfied.
<function name="gtk_test_accessible_assert_role">
<description>
-Checks whether a #GtkAccessible implementation has the given @role,
+Checks whether a `GtkAccessible` implementation has the given @role,
and raises an assertion if the condition is failed.
</description>
<parameters>
<parameter name="accessible">
-<parameter_description> a #GtkAccessible
+<parameter_description> a `GtkAccessible`
</parameter_description>
</parameter>
<parameter name="role">
-<parameter_description> a #GtkAccessibleRole
+<parameter_description> a `GtkAccessibleRole`
</parameter_description>
</parameter>
</parameters>
@@ -73269,18 +73342,18 @@ and raises an assertion if the condition is failed.
<function name="gtk_test_accessible_assert_state">
<description>
-Checks whether a #GtkAccessible implementation has its accessible
+Checks whether a `GtkAccessible` implementation has its accessible
state set to the expected value, and raises an assertion if the
condition is not satisfied.
</description>
<parameters>
<parameter name="accessible">
-<parameter_description> a #GtkAccessible
+<parameter_description> a `GtkAccessible`
</parameter_description>
</parameter>
<parameter name="state">
-<parameter_description> a #GtkAccessibleRelation
+<parameter_description> a `GtkAccessibleRelation`
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -73300,11 +73373,11 @@ a specific value.
</description>
<parameters>
<parameter name="accessible">
-<parameter_description> a #GtkAccessible
+<parameter_description> a `GtkAccessible`
</parameter_description>
</parameter>
<parameter name="property">
-<parameter_description> a #GtkAccessibleProperty
+<parameter_description> a `GtkAccessibleProperty`
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -73325,11 +73398,11 @@ a specific value.
</description>
<parameters>
<parameter name="accessible">
-<parameter_description> a #GtkAccessible
+<parameter_description> a `GtkAccessible`
</parameter_description>
</parameter>
<parameter name="relation">
-<parameter_description> a #GtkAccessibleRelation
+<parameter_description> a `GtkAccessibleRelation`
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -73350,11 +73423,11 @@ a specific value.
</description>
<parameters>
<parameter name="accessible">
-<parameter_description> a #GtkAccessible
+<parameter_description> a `GtkAccessible`
</parameter_description>
</parameter>
<parameter name="state">
-<parameter_description> a #GtkAccessibleState
+<parameter_description> a `GtkAccessibleState`
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -73368,17 +73441,17 @@ a specific value.
<function name="gtk_test_accessible_has_property">
<description>
-Checks whether the #GtkAccessible has @property set.
+Checks whether the `GtkAccessible` has @property set.
</description>
<parameters>
<parameter name="accessible">
-<parameter_description> a #GtkAccessible
+<parameter_description> a `GtkAccessible`
</parameter_description>
</parameter>
<parameter name="property">
-<parameter_description> a #GtkAccessibleProperty
+<parameter_description> a `GtkAccessibleProperty`
</parameter_description>
</parameter>
</parameters>
@@ -73388,17 +73461,17 @@ Checks whether the #GtkAccessible has @property set.
<function name="gtk_test_accessible_has_relation">
<description>
-Checks whether the #GtkAccessible has @relation set.
+Checks whether the `GtkAccessible` has @relation set.
</description>
<parameters>
<parameter name="accessible">
-<parameter_description> a #GtkAccessible
+<parameter_description> a `GtkAccessible`
</parameter_description>
</parameter>
<parameter name="relation">
-<parameter_description> a #GtkAccessibleRelation
+<parameter_description> a `GtkAccessibleRelation`
</parameter_description>
</parameter>
</parameters>
@@ -73408,18 +73481,18 @@ Checks whether the #GtkAccessible has @relation set.
<function name="gtk_test_accessible_has_role">
<description>
-Checks whether the #GtkAccessible:accessible-role of the accessible
+Checks whether the `GtkAccessible:accessible-role` of the accessible
is @role.
</description>
<parameters>
<parameter name="accessible">
-<parameter_description> a #GtkAccessible
+<parameter_description> a `GtkAccessible`
</parameter_description>
</parameter>
<parameter name="role">
-<parameter_description> a #GtkAccessibleRole
+<parameter_description> a `GtkAccessibleRole`
</parameter_description>
</parameter>
</parameters>
@@ -73429,17 +73502,17 @@ is @role.
<function name="gtk_test_accessible_has_state">
<description>
-Checks whether the #GtkAccessible has @state set.
+Checks whether the `GtkAccessible` has @state set.
</description>
<parameters>
<parameter name="accessible">
-<parameter_description> a #GtkAccessible
+<parameter_description> a `GtkAccessible`
</parameter_description>
</parameter>
<parameter name="state">
-<parameter_description> a #GtkAccessibleState
+<parameter_description> a `GtkAccessibleState`
</parameter_description>
</parameter>
</parameters>
@@ -73467,10 +73540,9 @@ main() function. Changed if any arguments were handled.
</parameter_description>
</parameter>
<parameter name="argvp">
-<parameter_description> Address of the
-`argv` parameter of main().
-Any parameters understood by g_test_init() or gtk_init() are
-stripped before return.
+<parameter_description> Address of the `argv`
+parameter of main(). Any parameters understood by g_test_init()
+or gtk_init() are stripped before return.
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -73535,13 +73607,13 @@ server.
<function name="gtk_text_attributes_copy">
<description>
-Copies @src and returns a new #GtkTextAttributes.
+Copies @src and returns a new `GtkTextAttributes`.
</description>
<parameters>
<parameter name="src">
-<parameter_description> a #GtkTextAttributes to be copied
+<parameter_description> a `GtkTextAttributes` to be copied
</parameter_description>
</parameter>
</parameters>
@@ -73558,11 +73630,11 @@ the same values as @src. Frees existing values in @dest.
</description>
<parameters>
<parameter name="src">
-<parameter_description> a #GtkTextAttributes
+<parameter_description> a `GtkTextAttributes`
</parameter_description>
</parameter>
<parameter name="dest">
-<parameter_description> another #GtkTextAttributes
+<parameter_description> another `GtkTextAttributes`
</parameter_description>
</parameter>
</parameters>
@@ -73571,14 +73643,14 @@ the same values as @src. Frees existing values in @dest.
<function name="gtk_text_attributes_new">
<description>
-Creates a #GtkTextAttributes, which describes
+Creates a `GtkTextAttributes`, which describes
a set of properties on some text.
</description>
<parameters>
</parameters>
-<return> a new #GtkTextAttributes,
+<return> a new `GtkTextAttributes`,
free with gtk_text_attributes_unref().
</return>
</function>
@@ -73591,11 +73663,11 @@ Increments the reference count on @values.
</description>
<parameters>
<parameter name="values">
-<parameter_description> a #GtkTextAttributes
+<parameter_description> a `GtkTextAttributes`
</parameter_description>
</parameter>
</parameters>
-<return> the #GtkTextAttributes that were passed in
+<return> the `GtkTextAttributes` that were passed in
</return>
</function>
@@ -73607,7 +73679,7 @@ if the reference count reaches 0.
</description>
<parameters>
<parameter name="values">
-<parameter_description> a #GtkTextAttributes
+<parameter_description> a `GtkTextAttributes`
</parameter_description>
</parameter>
</parameters>
@@ -73622,8 +73694,8 @@ The mark must not be added to another buffer, and if its name
is not %NULL then there must not be another mark in the buffer
with the same name.
-Emits the `GtkTextBuffer`::mark-set signal as notification of
-the mark's initial placement.
+Emits the [signal@Gtk.TextBuffer::mark-set] signal as notification
+of the mark's initial placement.
</description>
<parameters>
@@ -73774,8 +73846,8 @@ This should be paired with a call to
[method@Gtk.TextBuffer.end_irreversible_action] after the irreversible
action has completed.
-You may nest calls to gtk_text_buffer_begin_irreversible_action() and
-gtk_text_buffer_end_irreversible_action() pairs.
+You may nest calls to gtk_text_buffer_begin_irreversible_action()
+and gtk_text_buffer_end_irreversible_action() pairs.
</description>
<parameters>
@@ -73878,12 +73950,12 @@ with right gravity (when you type, the cursor stays on the right
side of the text you’re typing).
The caller of this function does not own a
-reference to the returned #GtkTextMark, so you can ignore the
+reference to the returned `GtkTextMark`, so you can ignore the
return value if you like. Marks are owned by the buffer and go
away when the buffer does.
-Emits the `GtkTextBuffer`::mark-set signal as notification of
-the mark's initial placement.
+Emits the [signal@Gtk.TextBuffer::mark-set] signal as notification
+of the mark's initial placement.
</description>
@@ -73893,7 +73965,7 @@ the mark's initial placement.
</parameter_description>
</parameter>
<parameter name="mark_name">
-<parameter_description> name for mark, or %NULL
+<parameter_description> name for mark
</parameter_description>
</parameter>
<parameter name="where">
@@ -73905,7 +73977,7 @@ the mark's initial placement.
</parameter_description>
</parameter>
</parameters>
-<return> the new #GtkTextMark object
+<return> the new `GtkTextMark` object
</return>
</function>
@@ -73933,11 +74005,11 @@ of properties to set on the tag, as with g_object_set().
</parameter_description>
</parameter>
<parameter name="tag_name">
-<parameter_description> name of the new tag, or %NULL
+<parameter_description> name of the new tag
</parameter_description>
</parameter>
<parameter name="first_property_name">
-<parameter_description> name of first property to set, or %NULL
+<parameter_description> name of first property to set
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -74121,11 +74193,11 @@ This will cause any previous operations in the undo/redo
queue to be cleared.
This should be called after completing modifications to the
-text buffer after gtk_text_buffer_begin_irreversible_action()
+text buffer after [method@Gtk.TextBuffer.begin_irreversible_action]
was called.
-You may nest calls to gtk_text_buffer_begin_irreversible_action() and
-gtk_text_buffer_end_irreversible_action() pairs.
+You may nest calls to gtk_text_buffer_begin_irreversible_action()
+and gtk_text_buffer_end_irreversible_action() pairs.
</description>
<parameters>
@@ -74338,7 +74410,7 @@ Obtains the location of @anchor within @buffer.
<description>
Initializes @iter to the start of the given line.
-If @line_number is greater than the number of lines
+If @line_number is greater than or equal to the number of lines
in the @buffer, the end iterator is returned.
@@ -74368,7 +74440,7 @@ Obtains an iterator pointing to @byte_index within the given line.
@byte_index must be the start of a UTF-8 character. Note bytes, not
characters; UTF-8 may encode one character as multiple bytes.
-If @line_number is greater than the number of lines in the @buffer,
+If @line_number is greater than or equal to the number of lines in the @buffer,
the end iterator is returned. And if @byte_index is off the
end of the line, the iterator at the end of the line is returned.
@@ -74403,7 +74475,7 @@ Obtains an iterator pointing to @char_offset within the given line.
Note characters, not bytes; UTF-8 may encode one character as multiple
bytes.
-If @line_number is greater than the number of lines in the @buffer,
+If @line_number is greater than or equal to the number of lines in the @buffer,
the end iterator is returned. And if @char_offset is off the
end of the line, the iterator at the end of the line is returned.
@@ -74515,7 +74587,7 @@ mark exists in the buffer.
</parameter_description>
</parameter>
</parameters>
-<return> a #GtkTextMark, or %NULL
+<return> a `GtkTextMark`
</return>
</function>
@@ -74982,7 +75054,7 @@ Used instead of simply getting/inserting text because it preserves
images and tags. If @start and @end are in a different buffer from
@buffer, the two buffers must share the same tag table.
-Implemented via emissions of the insert_text and apply_tag signals,
+Implemented via emissions of the ::insert-text and ::apply-tag signals,
so expect those.
</description>
@@ -75128,8 +75200,8 @@ to pass in tag names instead of tag objects.
<description>
Moves @mark to the new location @where.
-Emits the `GtkTextBuffer`::mark-set
-signal as notification of the move.
+Emits the [signal@Gtk.TextBuffer::mark-set] signal
+as notification of the move.
</description>
<parameters>
@@ -75212,7 +75284,7 @@ data will be inserted.
</parameter_description>
</parameter>
<parameter name="override_location">
-<parameter_description> location to insert pasted text, or %NULL
+<parameter_description> location to insert pasted text
</parameter_description>
</parameter>
<parameter name="default_editable">
@@ -75404,6 +75476,9 @@ be optimized.
<description>
Sets whether or not to enable undoable actions in the text buffer.
+Undoable actions in this context are changes to the text content of
+the buffer. Changes to tags and marks are not tracked.
+
If enabled, the user will be able to undo the last number of actions
up to [method@Gtk.TextBuffer.get_max_undo_levels].
@@ -75613,7 +75688,10 @@ function [method@Gtk.TextBuffer.create_child_anchor].
<function name="gtk_text_get_activates_default">
<description>
-Retrieves the value set by gtk_text_set_activates_default().
+Returns whether pressing Enter will activate
+the default widget for the window containing @self.
+
+See [method Gtk Text.set_activates_default].
</description>
@@ -75629,8 +75707,9 @@ Retrieves the value set by gtk_text_set_activates_default().
<function name="gtk_text_get_attributes">
<description>
-Gets the attribute list that was set on the `GtkText`
-using gtk_text_set_attributes().
+Gets the attribute list that was set on the `GtkText`.
+
+See [method Gtk Text.set_attributes].
</description>
@@ -75640,15 +75719,14 @@ using gtk_text_set_attributes().
</parameter_description>
</parameter>
</parameters>
-<return> the attribute list,
-or %NULL if none was set.
+<return> the attribute list
</return>
</function>
<function name="gtk_text_get_buffer">
<description>
Get the `GtkEntryBuffer` object which holds the text for
-this self.
+this widget.
</description>
@@ -75681,7 +75759,9 @@ Returns whether Emoji completion is enabled for this
<function name="gtk_text_get_extra_menu">
<description>
-Gets the menu model set with gtk_text_set_extra_menu().
+Gets the menu model for extra items in the context menu.
+
+See [method Gtk Text.set_extra_menu].
</description>
@@ -75725,8 +75805,7 @@ Gets the input purpose of the `GtkText`.
<function name="gtk_text_get_invisible_char">
<description>
-Retrieves the character displayed in place of the real characters
-for entries with visibility set to false.
+Retrieves the character displayed when visibility is set to false.
Note that GTK does not compute this value unless it needs it,
so the value returned by this function is not very useful unless
@@ -75769,7 +75848,9 @@ in `GtkText`, or 0 if there is no maximum.
<function name="gtk_text_get_overwrite_mode">
<description>
-Gets the value set by gtk_text_set_overwrite_mode().
+Gets whether text is overwritten when typing in the `GtkText`.
+
+See [method Gtk Text.set_overwrite_mode].
</description>
@@ -75779,7 +75860,7 @@ Gets the value set by gtk_text_set_overwrite_mode().
</parameter_description>
</parameter>
</parameters>
-<return> whether the text is overwritten when typing.
+<return> whether the text is overwritten when typing
</return>
</function>
@@ -75788,6 +75869,8 @@ Gets the value set by gtk_text_set_overwrite_mode().
Retrieves the text that will be displayed when
@self is empty and unfocused
+If no placeholder text has been set, %NULL will be returned.
+
</description>
<parameters>
@@ -75796,11 +75879,7 @@ Retrieves the text that will be displayed when
</parameter_description>
</parameter>
</parameters>
-<return> a pointer
-to the placeholder text as a string. This string
-points to internally allocated storage in the widget
-and must not be freed, modified or stored. If no placeholder
-text has been set, %NULL will be returned.
+<return> the placeholder text
</return>
</function>
@@ -75823,8 +75902,9 @@ with the content.
<function name="gtk_text_get_tabs">
<description>
-Gets the tabstops that were set on the `GtkText`
-using gtk_text_set_tabs().
+Gets the tabstops that were set on the `GtkText`.
+
+See [method Gtk Text.set_tabs].
</description>
@@ -75834,8 +75914,7 @@ using gtk_text_set_tabs().
</parameter_description>
</parameter>
</parameters>
-<return> the tabstops,
-or %NULL if none was set.
+<return> the tabstops
</return>
</function>
@@ -76040,7 +76119,7 @@ but goes backward from @iter.
</parameter_description>
</parameter>
<parameter name="limit">
-<parameter_description> search limit, or %NULL for none
+<parameter_description> search limit
</parameter_description>
</parameter>
</parameters>
@@ -76116,11 +76195,11 @@ even if there is a possible @match_start before or at @iter.
</parameter_description>
</parameter>
<parameter name="match_start">
-<parameter_description> return location for start of match, or %NULL
+<parameter_description> return location for start of match
</parameter_description>
</parameter>
<parameter name="match_end">
-<parameter_description> return location for end of match, or %NULL
+<parameter_description> return location for end of match
</parameter_description>
</parameter>
<parameter name="limit">
@@ -76187,7 +76266,7 @@ gtk_text_iter_get_slice().
</description>
<parameters>
<parameter name="iter">
-<parameter_description> a #GtkTextIter
+<parameter_description> a `GtkTextIter`
</parameter_description>
</parameter>
<parameter name="count">
@@ -76219,7 +76298,7 @@ if no toggle is found.
</parameter_description>
</parameter>
<parameter name="tag">
-<parameter_description> a `GtkTextTag`, or %NULL
+<parameter_description> a `GtkTextTag`
</parameter_description>
</parameter>
</parameters>
@@ -76475,7 +76554,7 @@ Returns whether the character at @iter is within an editable region
of text.
Non-editable text is “locked” and can’t be changed by the
-user via #GtkTextView. If no tags applied to this text affect
+user via `GtkTextView`. If no tags applied to this text affect
editability, @default_setting will be returned.
You don’t want to use this function to decide whether text can be
@@ -76567,7 +76646,7 @@ returns %TRUE, [method@Gtk.TextIter.has_tag] will return
</parameter_description>
</parameter>
<parameter name="tag">
-<parameter_description> a `GtkTextTag`, or %NULL
+<parameter_description> a `GtkTextTag`
</parameter_description>
</parameter>
</parameters>
@@ -76746,7 +76825,7 @@ If @pred never returns %TRUE, @iter is set to @limit if
</parameter_description>
</parameter>
<parameter name="limit">
-<parameter_description> search limit, or %NULL for none
+<parameter_description> search limit
</parameter_description>
</parameter>
</parameters>
@@ -76833,11 +76912,11 @@ even if there is a possible @match_end after or at @iter.
</parameter_description>
</parameter>
<parameter name="match_start">
-<parameter_description> return location for start of match, or %NULL
+<parameter_description> return location for start of match
</parameter_description>
</parameter>
<parameter name="match_end">
-<parameter_description> return location for end of match, or %NULL
+<parameter_description> return location for end of match
</parameter_description>
</parameter>
<parameter name="limit">
@@ -76906,7 +76985,7 @@ rather than gtk_text_iter_get_slice().
</description>
<parameters>
<parameter name="iter">
-<parameter_description> a #GtkTextIter
+<parameter_description> a `GtkTextIter`
</parameter_description>
</parameter>
<parameter name="count">
@@ -76982,7 +77061,7 @@ if no toggle is found.
</parameter_description>
</parameter>
<parameter name="tag">
-<parameter_description> a `GtkTextTag`, or %NULL
+<parameter_description> a `GtkTextTag`
</parameter_description>
</parameter>
</parameters>
@@ -77453,7 +77532,7 @@ but you have to free the list itself.
</description>
<parameters>
<parameter name="iter">
-<parameter_description> a #GtkTextIter
+<parameter_description> a `GtkTextIter`
</parameter_description>
</parameter>
</parameters>
@@ -77786,7 +77865,7 @@ pre-sorted range.
<description>
Moves iterator @iter to the start of the line @line_number.
-If @line_number is negative or larger than the number of lines
+If @line_number is negative or larger than or equal to the number of lines
in the buffer, moves @iter to the start of the last line in the buffer.
</description>
@@ -77970,7 +78049,7 @@ will also return %TRUE for the same parameters.
</parameter_description>
</parameter>
<parameter name="tag">
-<parameter_description> a `GtkTextTag`, or %NULL
+<parameter_description> a `GtkTextTag`
</parameter_description>
</parameter>
</parameters>
@@ -78013,7 +78092,7 @@ gtk_text_iter_ends_tag())
</parameter_description>
</parameter>
<parameter name="tag">
-<parameter_description> a `GtkTextTag`, or %NULL
+<parameter_description> a `GtkTextTag`
</parameter_description>
</parameter>
</parameters>
@@ -78031,11 +78110,11 @@ iterator in this range.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GtkTextLayout
+<parameter_description> a `GtkTextLayout`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a #GtkTextIter
+<parameter_description> a `GtkTextIter`
</parameter_description>
</parameter>
<parameter name="top">
@@ -78060,7 +78139,7 @@ gtk_text_layout_set_buffer().
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GtkTextLayout
+<parameter_description> a `GtkTextLayout`
</parameter_description>
</parameter>
</parameters>
@@ -78082,19 +78161,19 @@ direction of the paragraph are inserted.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GtkTextLayout
+<parameter_description> a `GtkTextLayout`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a #GtkTextIter
+<parameter_description> a `GtkTextIter`
</parameter_description>
</parameter>
<parameter name="strong_pos">
-<parameter_description> location to store the strong cursor position, or %NULL
+<parameter_description> location to store the strong cursor position
</parameter_description>
</parameter>
<parameter name="weak_pos">
-<parameter_description> location to store the weak cursor position, or %NULL
+<parameter_description> location to store the weak cursor position
</parameter_description>
</parameter>
</parameters>
@@ -78109,7 +78188,7 @@ Returns whether the insertion cursor will be shown.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GtkTextLayout
+<parameter_description> a `GtkTextLayout`
</parameter_description>
</parameter>
</parameters>
@@ -78126,7 +78205,7 @@ at the given y.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GtkLayout
+<parameter_description> a `GtkLayout`
</parameter_description>
</parameter>
<parameter name="target_iter">
@@ -78154,18 +78233,19 @@ the given iter.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GtkTextLayout
+<parameter_description> a `GtkTextLayout`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a #GtkTextIter
+<parameter_description> a `GtkTextIter`
</parameter_description>
</parameter>
<parameter name="y">
-<parameter_description> location to store the top of the paragraph in pixels,
-or %NULL.
-@height location to store the height of the paragraph in pixels,
-or %NULL.
+<parameter_description> location to store the top of the paragraph in pixels
+</parameter_description>
+</parameter>
+<parameter name="height">
+<parameter_description> location to store the height of the paragraph in pixels
</parameter_description>
</parameter>
</parameters>
@@ -78174,13 +78254,13 @@ or %NULL.
<function name="gtk_text_layout_is_valid">
<description>
-Check if there are any invalid regions in a #GtkTextLayout’s buffer
+Check if there are any invalid regions in a `GtkTextLayout`’s buffer
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GtkTextLayout
+<parameter_description> a `GtkTextLayout`
</parameter_description>
</parameter>
</parameters>
@@ -78195,7 +78275,7 @@ Tests whether an iterator is at the start of a display line.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GtkTextLayout
+<parameter_description> a `GtkTextLayout`
</parameter_description>
</parameter>
<parameter name="iter">
@@ -78213,7 +78293,7 @@ Move to the beginning or end of a display line.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GtkTextLayout
+<parameter_description> a `GtkTextLayout`
</parameter_description>
</parameter>
<parameter name="direction">
@@ -78234,11 +78314,11 @@ this operation.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GtkLayout
+<parameter_description> a `GtkLayout`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a #GtkTextIter
+<parameter_description> a `GtkTextIter`
</parameter_description>
</parameter>
</parameters>
@@ -78253,11 +78333,11 @@ of a wrapped paragraph are treated as distinct for this operation.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GtkLayout
+<parameter_description> a `GtkLayout`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a #GtkTextIter
+<parameter_description> a `GtkTextIter`
</parameter_description>
</parameter>
</parameters>
@@ -78273,15 +78353,15 @@ treated as distinct for this operation.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GtkTextLayout
+<parameter_description> a `GtkTextLayout`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a #GtkTextIter
+<parameter_description> a `GtkTextIter`
</parameter_description>
</parameter>
<parameter name="x">
-<parameter_description> X coordinate
+<parameter_description> X coordinate
</parameter_description>
</parameter>
</parameters>
@@ -78305,15 +78385,15 @@ is moved off of the end of a run.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GtkTextLayout
+<parameter_description> a `GtkTextLayout`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a #GtkTextIter
+<parameter_description> a `GtkTextIter`
</parameter_description>
</parameter>
<parameter name="count">
-<parameter_description> number of characters to move (negative moves left, positive moves right)
+<parameter_description> number of characters to move (negative moves left, positive moves right)
</parameter_description>
</parameter>
</parameters>
@@ -78344,13 +78424,13 @@ left-to-right insertion and right-to-left insertion.
<function name="gtk_text_layout_set_cursor_visible">
<description>
Sets whether the insertion cursor should be shown. Generally,
-widgets using #GtkTextLayout will hide the cursor when the
+widgets using `GtkTextLayout` will hide the cursor when the
widget does not have the input focus.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GtkTextLayout
+<parameter_description> a `GtkTextLayout`
</parameter_description>
</parameter>
<parameter name="cursor_visible">
@@ -78385,7 +78465,7 @@ Sets overwrite mode
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GtkTextLayout
+<parameter_description> a `GtkTextLayout`
</parameter_description>
</parameter>
<parameter name="overwrite">
@@ -78405,7 +78485,7 @@ yet committed into the buffer.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #PangoLayout
+<parameter_description> a `PangoLayout`
</parameter_description>
</parameter>
<parameter name="preedit_string">
@@ -78413,7 +78493,7 @@ yet committed into the buffer.
</parameter_description>
</parameter>
<parameter name="preedit_attrs">
-<parameter_description> a #PangoAttrList of attributes that apply to @preedit_string
+<parameter_description> a `PangoAttrList` of attributes that apply to @preedit_string
</parameter_description>
</parameter>
<parameter name="cursor_pos">
@@ -78426,13 +78506,13 @@ yet committed into the buffer.
<function name="gtk_text_layout_validate">
<description>
-Validate regions of a #GtkTextLayout. The ::changed signal will
+Validate regions of a `GtkTextLayout`. The ::changed signal will
be emitted for each region validated.
</description>
<parameters>
<parameter name="tree">
-<parameter_description> a #GtkTextLayout
+<parameter_description> a `GtkTextLayout`
</parameter_description>
</parameter>
<parameter name="max_pixels">
@@ -78446,13 +78526,13 @@ than one paragraph beyond this limit will be validated)
<function name="gtk_text_layout_validate_yrange">
<description>
-Ensure that a region of a #GtkTextLayout is valid. The ::changed
+Ensure that a region of a `GtkTextLayout` is valid. The ::changed
signal will be emitted if any lines are validated.
</description>
<parameters>
<parameter name="layout">
-<parameter_description> a #GtkTextLayout
+<parameter_description> a `GtkTextLayout`
</parameter_description>
</parameter>
<parameter name="anchor">
@@ -78579,7 +78659,7 @@ right side of the text you’re typing).
</description>
<parameters>
<parameter name="name">
-<parameter_description> mark name or %NULL
+<parameter_description> mark name
</parameter_description>
</parameter>
<parameter name="left_gravity">
@@ -78593,17 +78673,19 @@ right side of the text you’re typing).
<function name="gtk_text_mark_set_visible">
<description>
-Sets the visibility of @mark; the insertion point is normally
-visible, i.e. you can see it as a vertical bar. Also, the text
-widget uses a visible mark to indicate where a drop will occur when
-dragging-and-dropping text. Most other marks are not visible.
-Marks are not visible by default.
+Sets the visibility of @mark.
+The insertion point is normally visible, i.e. you can see it as
+a vertical bar. Also, the text widget uses a visible mark to
+indicate where a drop will occur when dragging-and-dropping text.
+Most other marks are not visible.
+
+Marks are not visible by default.
</description>
<parameters>
<parameter name="mark">
-<parameter_description> a #GtkTextMark
+<parameter_description> a GtkTextMark
</parameter_description>
</parameter>
<parameter name="setting">
@@ -78644,8 +78726,8 @@ Creates a new `GtkText` with the specified text buffer.
<function name="gtk_text_set_activates_default">
<description>
-If @activates is %TRUE, pressing Enter in the @self will
-activate the default widget for the window containing @self.
+If @activates is %TRUE, pressing Enter will activate
+the default widget for the window containing @self.
This usually means that the dialog containing the `GtkText`
will be closed, since the default widget is usually one of
@@ -78676,7 +78758,7 @@ Sets attributes that are applied to the text.
</parameter_description>
</parameter>
<parameter name="attrs">
-<parameter_description> a `PangoAttrList` or %NULL to unset
+<parameter_description> a `PangoAttrList`
</parameter_description>
</parameter>
</parameters>
@@ -78785,8 +78867,7 @@ input methods to adjust their behaviour.
<function name="gtk_text_set_invisible_char">
<description>
-Sets the character to use in place of the actual text when
-in “password mode”.
+Sets the character to use when in “password mode”.
By default, GTK picks the best invisible char available in the
current font. If you set the invisible char to 0, then the user
@@ -78867,7 +78948,7 @@ contents of the `GtkText`.
</parameter>
<parameter name="text">
<parameter_description> a string to be displayed when @self
-is empty and unfocused, or %NULL
+is empty and unfocused
</parameter_description>
</parameter>
</parameters>
@@ -79007,7 +79088,7 @@ Creates a `GtkTextTag`.
</description>
<parameters>
<parameter name="name">
-<parameter_description> tag name, or %NULL
+<parameter_description> tag name
</parameter_description>
</parameter>
</parameters>
@@ -79128,8 +79209,7 @@ Look up a named tag.
</parameter_description>
</parameter>
</parameters>
-<return> The tag,
-or %NULL if none by that name is in the table.
+<return> The tag
</return>
</function>
@@ -79195,7 +79275,7 @@ Creates a drag and drop icon from @text.
</description>
<parameters>
<parameter name="widget">
-<parameter_description> #GtkWidget to extract the pango context
+<parameter_description> `GtkWidget` to extract the pango context
</parameter_description>
</parameter>
<parameter name="text">
@@ -79207,7 +79287,7 @@ Creates a drag and drop icon from @text.
</parameter_description>
</parameter>
</parameters>
-<return> a #GdkPaintable to use as DND icon
+<return> a `GdkPaintable` to use as DND icon
</return>
</function>
@@ -79244,7 +79324,7 @@ buffer coordinates).
@child will scroll with the text view.
If instead you want a widget that will not move with the
-`GtkTextView` contents see #GtkOverlay.
+`GtkTextView` contents see `GtkOverlay`.
</description>
<parameters>
@@ -79253,7 +79333,7 @@ If instead you want a widget that will not move with the
</parameter_description>
</parameter>
<parameter name="child">
-<parameter_description> a #GtkWidget
+<parameter_description> a `GtkWidget`
</parameter_description>
</parameter>
<parameter name="xpos">
@@ -79335,7 +79415,7 @@ Converts buffer coordinates to window coordinates.
</parameter_description>
</parameter>
<parameter name="win">
-<parameter_description> a #GtkTextWindowType
+<parameter_description> a `GtkTextWindowType`
</parameter_description>
</parameter>
<parameter name="buffer_x">
@@ -79347,11 +79427,11 @@ Converts buffer coordinates to window coordinates.
</parameter_description>
</parameter>
<parameter name="window_x">
-<parameter_description> window x coordinate return location or %NULL
+<parameter_description> window x coordinate return location
</parameter_description>
</parameter>
<parameter name="window_y">
-<parameter_description> window y coordinate return location or %NULL
+<parameter_description> window y coordinate return location
</parameter_description>
</parameter>
</parameters>
@@ -79416,7 +79496,7 @@ views, since they depend on the contents of the `GtkTextBuffer`.
<function name="gtk_text_view_get_accepts_tab">
<description>
-Returns whether pressing the Tab key inserts a tab characters.
+Returns whether pressing the <kbd>Tab</kbd> key inserts a tab characters.
See [method@Gtk.TextView.set_accepts_tab].
@@ -79502,13 +79582,11 @@ coordinates to coordinates for one of the windows in the text view.
</parameter_description>
</parameter>
<parameter name="strong">
-<parameter_description> location to store the strong
-cursor position (may be %NULL)
+<parameter_description> location to store the strong cursor position
</parameter_description>
</parameter>
<parameter name="weak">
-<parameter_description> location to store the weak
-cursor position (may be %NULL)
+<parameter_description> location to store the weak cursor position
</parameter_description>
</parameter>
</parameters>
@@ -79587,7 +79665,7 @@ See [method@Gtk.TextView.set_gutter].
</parameter_description>
</parameter>
</parameters>
-<return> a `GtkWidget` or %NULL
+<return> a `GtkWidget`
</return>
</function>
@@ -80380,7 +80458,7 @@ get the mark onscreen)
<function name="gtk_text_view_set_accepts_tab">
<description>
-Sets the behavior of the text widget when the Tab key is pressed.
+Sets the behavior of the text widget when the <kbd>Tab</kbd> key is pressed.
If @accepts_tab is %TRUE, a tab character is inserted. If @accepts_tab
is %FALSE the keyboard focus is moved to the next widget in the focus
@@ -80530,7 +80608,7 @@ Places @widget into the gutter specified by @win.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> a `GtkWidget` or %NULL
+<parameter_description> a `GtkWidget`
</parameter_description>
</parameter>
</parameters>
@@ -80777,7 +80855,7 @@ Tags in the buffer may override the default.
</parameter_description>
</parameter>
<parameter name="tabs">
-<parameter_description> tabs as a #PangoTabArray
+<parameter_description> tabs as a `PangoTabArray`
</parameter_description>
</parameter>
</parameters>
@@ -80858,7 +80936,7 @@ coordinates.
</parameter_description>
</parameter>
<parameter name="win">
-<parameter_description> a #GtkTextWindowType
+<parameter_description> a `GtkTextWindowType`
</parameter_description>
</parameter>
<parameter name="window_x">
@@ -80870,11 +80948,11 @@ coordinates.
</parameter_description>
</parameter>
<parameter name="buffer_x">
-<parameter_description> buffer x coordinate return location or %NULL
+<parameter_description> buffer x coordinate return location
</parameter_description>
</parameter>
<parameter name="buffer_y">
-<parameter_description> buffer y coordinate return location or %NULL
+<parameter_description> buffer y coordinate return location
</parameter_description>
</parameter>
</parameters>
@@ -80980,7 +81058,7 @@ at a time.
Setting up groups in a cycle leads to undefined behavior.
-Note that the same effect can be achieved via the [interface@Gtk.Actionable]
+Note that the same effect can be achieved via the [iface@Gtk.Actionable]
API, by using the same action with parameter type and state type 's'
for all buttons in the group, and giving each button its own target
value.
@@ -81021,18 +81099,18 @@ There is no good reason for an application ever to call this function.
Replaces the widget packed into the tooltip with
@custom_widget. @custom_widget does not get destroyed when the tooltip goes
away.
-By default a box with a #GtkImage and #GtkLabel is embedded in
+By default a box with a `GtkImage` and `GtkLabel` is embedded in
the tooltip, which can be configured using gtk_tooltip_set_markup()
and gtk_tooltip_set_icon().
</description>
<parameters>
<parameter name="tooltip">
-<parameter_description> a #GtkTooltip
+<parameter_description> a `GtkTooltip`
</parameter_description>
</parameter>
<parameter name="custom_widget">
-<parameter_description> a #GtkWidget, or %NULL to unset the old custom widget.
+<parameter_description> a `GtkWidget`, or %NULL to unset the old custom widget.
</parameter_description>
</parameter>
</parameters>
@@ -81047,11 +81125,11 @@ Sets the icon of the tooltip (which is in front of the text) to be
</description>
<parameters>
<parameter name="tooltip">
-<parameter_description> a #GtkTooltip
+<parameter_description> a `GtkTooltip`
</parameter_description>
</parameter>
<parameter name="paintable">
-<parameter_description> a #GdkPaintable, or %NULL
+<parameter_description> a `GdkPaintable`
</parameter_description>
</parameter>
</parameters>
@@ -81067,11 +81145,11 @@ by @size. If @gicon is %NULL, the image will be hidden.
</description>
<parameters>
<parameter name="tooltip">
-<parameter_description> a #GtkTooltip
+<parameter_description> a `GtkTooltip`
</parameter_description>
</parameter>
<parameter name="gicon">
-<parameter_description> a #GIcon representing the icon, or %NULL
+<parameter_description> a `GIcon` representing the icon
</parameter_description>
</parameter>
</parameters>
@@ -81087,11 +81165,11 @@ by @size. If @icon_name is %NULL, the image will be hidden.
</description>
<parameters>
<parameter name="tooltip">
-<parameter_description> a #GtkTooltip
+<parameter_description> a `GtkTooltip`
</parameter_description>
</parameter>
<parameter name="icon_name">
-<parameter_description> an icon name, or %NULL
+<parameter_description> an icon name
</parameter_description>
</parameter>
</parameters>
@@ -81133,7 +81211,7 @@ See also [method@Gtk.Tooltip.set_markup].
</parameter_description>
</parameter>
<parameter name="text">
-<parameter_description> a text string or %NULL
+<parameter_description> a text string
</parameter_description>
</parameter>
</parameters>
@@ -81144,21 +81222,21 @@ See also [method@Gtk.Tooltip.set_markup].
<description>
Sets the area of the widget, where the contents of this tooltip apply,
to be @rect (in widget coordinates). This is especially useful for
-properly setting tooltips on #GtkTreeView rows and cells, #GtkIconViews,
+properly setting tooltips on `GtkTreeView` rows and cells, `GtkIconViews`,
etc.
-For setting tooltips on #GtkTreeView, please refer to the convenience
+For setting tooltips on `GtkTreeView`, please refer to the convenience
functions for this: gtk_tree_view_set_tooltip_row() and
gtk_tree_view_set_tooltip_cell().
</description>
<parameters>
<parameter name="tooltip">
-<parameter_description> a #GtkTooltip
+<parameter_description> a `GtkTooltip`
</parameter_description>
</parameter>
<parameter name="rect">
-<parameter_description> a #GdkRectangle
+<parameter_description> a `GdkRectangle`
</parameter_description>
</parameter>
</parameters>
@@ -81173,7 +81251,7 @@ Creates a content provider for dragging @path from @tree_model.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="path">
@@ -81181,13 +81259,13 @@ Creates a content provider for dragging @path from @tree_model.
</parameter_description>
</parameter>
</parameters>
-<return> a new #GdkContentProvider
+<return> a new `GdkContentProvider`
</return>
</function>
<function name="gtk_tree_drag_dest_drag_data_received">
<description>
-Asks the #GtkTreeDragDest to insert a row before the path @dest,
+Asks the `GtkTreeDragDest` to insert a row before the path @dest,
deriving the contents of the row from @value. If @dest is
outside the tree so that inserting before it is impossible, %FALSE
will be returned. Also, %FALSE may be returned if the new row is
@@ -81198,7 +81276,7 @@ a @dest no longer found in the model!
</description>
<parameters>
<parameter name="drag_dest">
-<parameter_description> a #GtkTreeDragDest
+<parameter_description> a `GtkTreeDragDest`
</parameter_description>
</parameter>
<parameter name="dest">
@@ -81226,7 +81304,7 @@ parent of @dest_path doesn’t exist, though.
</description>
<parameters>
<parameter name="drag_dest">
-<parameter_description> a #GtkTreeDragDest
+<parameter_description> a `GtkTreeDragDest`
</parameter_description>
</parameter>
<parameter name="dest_path">
@@ -81244,7 +81322,7 @@ parent of @dest_path doesn’t exist, though.
<function name="gtk_tree_drag_source_drag_data_delete">
<description>
-Asks the #GtkTreeDragSource to delete the row at @path, because
+Asks the `GtkTreeDragSource` to delete the row at @path, because
it was moved somewhere else via drag-and-drop. Returns %FALSE
if the deletion fails because @path no longer exists, or for
some model-specific reason. Should robustly handle a @path no
@@ -81254,7 +81332,7 @@ longer found in the model!
</description>
<parameters>
<parameter name="drag_source">
-<parameter_description> a #GtkTreeDragSource
+<parameter_description> a `GtkTreeDragSource`
</parameter_description>
</parameter>
<parameter name="path">
@@ -81268,7 +81346,7 @@ longer found in the model!
<function name="gtk_tree_drag_source_drag_data_get">
<description>
-Asks the #GtkTreeDragSource to return a #GdkContentProvider representing
+Asks the `GtkTreeDragSource` to return a `GdkContentProvider` representing
the row at @path. Should robustly handle a @path no
longer found in the model!
@@ -81276,7 +81354,7 @@ longer found in the model!
</description>
<parameters>
<parameter name="drag_source">
-<parameter_description> a #GtkTreeDragSource
+<parameter_description> a `GtkTreeDragSource`
</parameter_description>
</parameter>
<parameter name="path">
@@ -81284,14 +81362,14 @@ longer found in the model!
</parameter_description>
</parameter>
</parameters>
-<return> a #GdkContentProvider for the
-given @path or %NULL if none exists
+<return> a `GdkContentProvider` for the
+given @path
</return>
</function>
<function name="gtk_tree_drag_source_row_draggable">
<description>
-Asks the #GtkTreeDragSource whether a particular row can be used as
+Asks the `GtkTreeDragSource` whether a particular row can be used as
the source of a DND operation. If the source doesn’t implement
this interface, the row is assumed draggable.
@@ -81299,7 +81377,7 @@ this interface, the row is assumed draggable.
</description>
<parameters>
<parameter name="drag_source">
-<parameter_description> a #GtkTreeDragSource
+<parameter_description> a `GtkTreeDragSource`
</parameter_description>
</parameter>
<parameter name="path">
@@ -81388,7 +81466,7 @@ Sets the content widget to display.
</parameter_description>
</parameter>
<parameter name="child">
-<parameter_description> a `GtkWidget`, or %NULL
+<parameter_description> a `GtkWidget`
</parameter_description>
</parameter>
</parameters>
@@ -81406,7 +81484,7 @@ Sets the tree list row that this expander should manage.
</parameter_description>
</parameter>
<parameter name="list_row">
-<parameter_description> a `GtkTreeListRow`, or %NULL
+<parameter_description> a `GtkTreeListRow`
</parameter_description>
</parameter>
</parameters>
@@ -81424,11 +81502,11 @@ The returned path must be freed with gtk_tree_path_free().
</description>
<parameters>
<parameter name="value">
-<parameter_description> a #GValue
+<parameter_description> a `GValue`
</parameter_description>
</parameter>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="path">
@@ -81454,7 +81532,7 @@ You must free this iter with gtk_tree_iter_free().
</description>
<parameters>
<parameter name="iter">
-<parameter_description> a #GtkTreeIter-struct
+<parameter_description> a `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -81877,7 +81955,7 @@ being %FALSE as it can only sort [class@Gtk.TreeListRow]s.
</description>
<parameters>
<parameter name="sorter">
-<parameter_description> a `GtkSorter`, or %NULL
+<parameter_description> a `GtkSorter`
</parameter_description>
</parameter>
</parameters>
@@ -81899,7 +81977,7 @@ the tree list rows passed to @self.
</parameter_description>
</parameter>
<parameter name="sorter">
-<parameter_description> The sorter to use, or %NULL
+<parameter_description> The sorter to use
</parameter_description>
</parameter>
</parameters>
@@ -81918,7 +81996,7 @@ all unreffed iters will be invalid.
</description>
<parameters>
<parameter name="filter">
-<parameter_description> A #GtkTreeModelFilter.
+<parameter_description> A `GtkTreeModelFilter`
</parameter_description>
</parameter>
</parameters>
@@ -81935,15 +82013,15 @@ returned.
</description>
<parameters>
<parameter name="filter">
-<parameter_description> A #GtkTreeModelFilter.
+<parameter_description> A `GtkTreeModelFilter`
</parameter_description>
</parameter>
<parameter name="filter_iter">
-<parameter_description> An uninitialized #GtkTreeIter.
+<parameter_description> An uninitialized `GtkTreeIter`
</parameter_description>
</parameter>
<parameter name="child_iter">
-<parameter_description> A valid #GtkTreeIter pointing to a row on the child model.
+<parameter_description> A valid `GtkTreeIter` pointing to a row on the child model.
</parameter_description>
</parameter>
</parameters>
@@ -81964,15 +82042,15 @@ is returned.
</description>
<parameters>
<parameter name="filter">
-<parameter_description> A #GtkTreeModelFilter.
+<parameter_description> A `GtkTreeModelFilter`
</parameter_description>
</parameter>
<parameter name="child_path">
-<parameter_description> A #GtkTreePath to convert.
+<parameter_description> A `GtkTreePath` to convert.
</parameter_description>
</parameter>
</parameters>
-<return> A newly allocated #GtkTreePath, or %NULL.
+<return> A newly allocated `GtkTreePath`
</return>
</function>
@@ -81983,15 +82061,15 @@ Sets @child_iter to point to the row pointed to by @filter_iter.
</description>
<parameters>
<parameter name="filter">
-<parameter_description> A #GtkTreeModelFilter.
+<parameter_description> A `GtkTreeModelFilter`
</parameter_description>
</parameter>
<parameter name="child_iter">
-<parameter_description> An uninitialized #GtkTreeIter.
+<parameter_description> An uninitialized `GtkTreeIter`
</parameter_description>
</parameter>
<parameter name="filter_iter">
-<parameter_description> A valid #GtkTreeIter pointing to a row on @filter.
+<parameter_description> A valid `GtkTreeIter` pointing to a row on @filter.
</parameter_description>
</parameter>
</parameters>
@@ -82009,15 +82087,15 @@ does not point to a location in the child model, %NULL is returned.
</description>
<parameters>
<parameter name="filter">
-<parameter_description> A #GtkTreeModelFilter.
+<parameter_description> A `GtkTreeModelFilter`
</parameter_description>
</parameter>
<parameter name="filter_path">
-<parameter_description> A #GtkTreePath to convert.
+<parameter_description> A `GtkTreePath` to convert.
</parameter_description>
</parameter>
</parameters>
-<return> A newly allocated #GtkTreePath, or %NULL.
+<return> A newly allocated `GtkTreePath`
</return>
</function>
@@ -82029,32 +82107,32 @@ Returns a pointer to the child model of @filter.
</description>
<parameters>
<parameter name="filter">
-<parameter_description> A #GtkTreeModelFilter.
+<parameter_description> A `GtkTreeModelFilter`
</parameter_description>
</parameter>
</parameters>
-<return> A pointer to a #GtkTreeModel.
+<return> A pointer to a `GtkTreeModel`
</return>
</function>
<function name="gtk_tree_model_filter_new">
<description>
-Creates a new #GtkTreeModel, with @child_model as the child_model
+Creates a new `GtkTreeModel`, with @child_model as the child_model
and @root as the virtual root.
</description>
<parameters>
<parameter name="child_model">
-<parameter_description> A #GtkTreeModel.
+<parameter_description> A `GtkTreeModel`.
</parameter_description>
</parameter>
<parameter name="root">
-<parameter_description> A #GtkTreePath or %NULL.
+<parameter_description> A `GtkTreePath`
</parameter_description>
</parameter>
</parameters>
-<return> A new #GtkTreeModel.
+<return> A new `GtkTreeModel`.
</return>
</function>
@@ -82066,7 +82144,7 @@ the filter to re-evaluate whether a row is visible or not.
</description>
<parameters>
<parameter name="filter">
-<parameter_description> A #GtkTreeModelFilter.
+<parameter_description> A `GtkTreeModelFilter`
</parameter_description>
</parameter>
</parameters>
@@ -82089,7 +82167,7 @@ can only be called once for a given filter model.
</description>
<parameters>
<parameter name="filter">
-<parameter_description> A #GtkTreeModelFilter.
+<parameter_description> A `GtkTreeModelFilter`
</parameter_description>
</parameter>
<parameter name="n_columns">
@@ -82097,19 +82175,19 @@ can only be called once for a given filter model.
</parameter_description>
</parameter>
<parameter name="types">
-<parameter_description> The #GTypes of the columns.
+<parameter_description> The `GType`s of the columns.
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> A #GtkTreeModelFilterModifyFunc
+<parameter_description> A `GtkTreeModelFilterModifyFunc`
</parameter_description>
</parameter>
<parameter name="data">
-<parameter_description> User data to pass to the modify function, or %NULL.
+<parameter_description> User data to pass to the modify function
</parameter_description>
</parameter>
<parameter name="destroy">
-<parameter_description> Destroy notifier of @data, or %NULL.
+<parameter_description> Destroy notifier of @data
</parameter_description>
</parameter>
</parameters>
@@ -82130,11 +82208,11 @@ once for a given filter model.
</description>
<parameters>
<parameter name="filter">
-<parameter_description> A #GtkTreeModelFilter
+<parameter_description> A `GtkTreeModelFilter`
</parameter_description>
</parameter>
<parameter name="column">
-<parameter_description> A #int which is the column containing the visible information
+<parameter_description> A `int` which is the column containing the visible information
</parameter_description>
</parameter>
</parameters>
@@ -82182,19 +82260,19 @@ once for a given filter model.
</description>
<parameters>
<parameter name="filter">
-<parameter_description> A #GtkTreeModelFilter
+<parameter_description> A `GtkTreeModelFilter`
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> A #GtkTreeModelFilterVisibleFunc, the visible function
+<parameter_description> A `GtkTreeModelFilterVisibleFunc`, the visible function
</parameter_description>
</parameter>
<parameter name="data">
-<parameter_description> User data to pass to the visible function, or %NULL
+<parameter_description> User data to pass to the visible function
</parameter_description>
</parameter>
<parameter name="destroy">
-<parameter_description> Destroy notifier of @data, or %NULL
+<parameter_description> Destroy notifier of @data
</parameter_description>
</parameter>
</parameters>
@@ -82203,7 +82281,7 @@ once for a given filter model.
<function name="gtk_tree_model_foreach">
<description>
-Calls func on each node in model in a depth-first fashion.
+Calls @func on each node in model in a depth-first fashion.
If @func returns %TRUE, then the tree ceases to be walked,
and gtk_tree_model_foreach() returns.
@@ -82211,7 +82289,7 @@ and gtk_tree_model_foreach() returns.
</description>
<parameters>
<parameter name="model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="func">
@@ -82229,6 +82307,7 @@ and gtk_tree_model_foreach() returns.
<function name="gtk_tree_model_get">
<description>
Gets the value of one or more cells in the row referenced by @iter.
+
The variable argument list should contain integer column numbers,
each column number followed by a place to store the value being
retrieved. The list is terminated by a -1. For example, to get a
@@ -82244,7 +82323,7 @@ Other values are passed by value.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="iter">
@@ -82268,7 +82347,7 @@ Returns the type of the column.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="index_">
@@ -82284,7 +82363,7 @@ Returns the type of the column.
<description>
Returns a set of flags supported by this interface.
-The flags are a bitwise combination of #GtkTreeModelFlags.
+The flags are a bitwise combination of `GtkTreeModel`Flags.
The flags supported should not change during the lifetime
of the @tree_model.
@@ -82292,7 +82371,7 @@ of the @tree_model.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
</parameters>
@@ -82302,22 +82381,24 @@ of the @tree_model.
<function name="gtk_tree_model_get_iter">
<description>
-Sets @iter to a valid iterator pointing to @path. If @path does
-not exist, @iter is set to an invalid iterator and %FALSE is returned.
+Sets @iter to a valid iterator pointing to @path.
+
+If @path does not exist, @iter is set to an invalid
+iterator and %FALSE is returned.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the uninitialized #GtkTreeIter-struct
+<parameter_description> the uninitialized `GtkTreeIter`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> the #GtkTreePath-struct
+<parameter_description> the `GtkTreePath`
</parameter_description>
</parameter>
</parameters>
@@ -82328,18 +82409,17 @@ not exist, @iter is set to an invalid iterator and %FALSE is returned.
<function name="gtk_tree_model_get_iter_first">
<description>
Initializes @iter with the first iterator in the tree
-(the one at the path "0") and returns %TRUE. Returns
-%FALSE if the tree is empty.
+(the one at the path "0").
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the uninitialized #GtkTreeIter-struct
+<parameter_description> the uninitialized `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -82350,21 +82430,23 @@ Initializes @iter with the first iterator in the tree
<function name="gtk_tree_model_get_iter_from_string">
<description>
Sets @iter to a valid iterator pointing to @path_string, if it
-exists. Otherwise, @iter is left invalid and %FALSE is returned.
+exists.
+
+Otherwise, @iter is left invalid and %FALSE is returned.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> an uninitialized #GtkTreeIter-struct
+<parameter_description> an uninitialized `GtkTreeIter`
</parameter_description>
</parameter>
<parameter name="path_string">
-<parameter_description> a string representation of a #GtkTreePath-struct
+<parameter_description> a string representation of a `GtkTreePath`
</parameter_description>
</parameter>
</parameters>
@@ -82380,7 +82462,7 @@ Returns the number of columns supported by @tree_model.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
</parameters>
@@ -82390,7 +82472,7 @@ Returns the number of columns supported by @tree_model.
<function name="gtk_tree_model_get_path">
<description>
-Returns a newly-created #GtkTreePath-struct referenced by @iter.
+Returns a newly-created `GtkTreePath` referenced by @iter.
This path should be freed with gtk_tree_path_free().
@@ -82398,15 +82480,15 @@ This path should be freed with gtk_tree_path_free().
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter-struct
+<parameter_description> the `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
-<return> a newly-created #GtkTreePath-struct
+<return> a newly-created `GtkTreePath`
</return>
</function>
@@ -82422,28 +82504,29 @@ return value for this string.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a #GtkTreeIter-struct
+<parameter_description> a `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
-<return> a newly-allocated string.
-Must be freed with g_free().
+<return> a newly-allocated string
</return>
</function>
<function name="gtk_tree_model_get_valist">
<description>
-See gtk_tree_model_get(), this version takes a va_list
+Gets the value of one or more cells in the row referenced by @iter.
+
+See [method Gtk TreeModel get], this version takes a va_list
for language bindings to use.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="iter">
@@ -82468,11 +82551,11 @@ to free any allocated memory.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter-struct
+<parameter_description> the `GtkTreeIter`
</parameter_description>
</parameter>
<parameter name="column">
@@ -82480,7 +82563,7 @@ to free any allocated memory.
</parameter_description>
</parameter>
<parameter name="value">
-<parameter_description> an empty #GValue to set
+<parameter_description> an empty `GValue` to set
</parameter_description>
</parameter>
</parameters>
@@ -82502,15 +82585,15 @@ If @parent is %NULL returns the first node, equivalent to
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the new #GtkTreeIter-struct to be set to the child
+<parameter_description> the new `GtkTreeIter` to be set to the child
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> the #GtkTreeIter-struct, or %NULL
+<parameter_description> the `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -82526,11 +82609,11 @@ Returns %TRUE if @iter has children, %FALSE otherwise.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter-struct to test for children
+<parameter_description> the `GtkTreeIter` to test for children
</parameter_description>
</parameter>
</parameters>
@@ -82549,11 +82632,11 @@ of toplevel nodes is returned.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter-struct, or %NULL
+<parameter_description> the `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -82572,11 +82655,11 @@ to be invalid.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter-struct
+<parameter_description> the `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -82598,15 +82681,15 @@ is set.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter-struct to set to the nth child
+<parameter_description> the `GtkTreeIter` to set to the nth child
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> the #GtkTreeIter-struct to get the child from, or %NULL.
+<parameter_description> the `GtkTreeIter` to get the child from
</parameter_description>
</parameter>
<parameter name="n">
@@ -82634,15 +82717,15 @@ and @iter cannot point to the same memory location.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the new #GtkTreeIter-struct to set to the parent
+<parameter_description> the new `GtkTreeIter` to set to the parent
</parameter_description>
</parameter>
<parameter name="child">
-<parameter_description> the #GtkTreeIter-struct
+<parameter_description> the `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -82661,11 +82744,11 @@ set to be invalid.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter-struct
+<parameter_description> the `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -82696,11 +82779,11 @@ of its reffed state.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter-struct
+<parameter_description> the `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -82709,20 +82792,22 @@ of its reffed state.
<function name="gtk_tree_model_row_changed">
<description>
-Emits the #GtkTreeModel::row-changed signal on @tree_model.
+Emits the ::row-changed signal on @tree_model.
+
+See [signal@Gtk.TreeModel::row-changed].
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct pointing to the changed row
+<parameter_description> a `GtkTreePath` pointing to the changed row
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a valid #GtkTreeIter-struct pointing to the changed row
+<parameter_description> a valid `GtkTreeIter` pointing to the changed row
</parameter_description>
</parameter>
</parameters>
@@ -82731,7 +82816,9 @@ Emits the #GtkTreeModel::row-changed signal on @tree_model.
<function name="gtk_tree_model_row_deleted">
<description>
-Emits the #GtkTreeModel::row-deleted signal on @tree_model.
+Emits the ::row-deleted signal on @tree_model.
+
+See [signal@Gtk.TreeModel::row-deleted].
This should be called by models after a row has been removed.
The location pointed to by @path should be the location that
@@ -82743,11 +82830,11 @@ outstanding references on the deleted node should not be released.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct pointing to the previous location of
+<parameter_description> a `GtkTreePath` pointing to the previous location of
the deleted row
</parameter_description>
</parameter>
@@ -82757,22 +82844,25 @@ the deleted row
<function name="gtk_tree_model_row_has_child_toggled">
<description>
-Emits the #GtkTreeModel::row-has-child-toggled signal on
-@tree_model. This should be called by models after the child
+Emits the ::row-has-child-toggled signal on @tree_model.
+
+See [signal@Gtk.TreeModel::row-has-child-toggled].
+
+This should be called by models after the child
state of a node changes.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct pointing to the changed row
+<parameter_description> a `GtkTreePath` pointing to the changed row
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a valid #GtkTreeIter-struct pointing to the changed row
+<parameter_description> a valid `GtkTreeIter` pointing to the changed row
</parameter_description>
</parameter>
</parameters>
@@ -82781,20 +82871,22 @@ state of a node changes.
<function name="gtk_tree_model_row_inserted">
<description>
-Emits the #GtkTreeModel::row-inserted signal on @tree_model.
+Emits the ::row-inserted signal on @tree_model.
+
+See [signal@Gtk.TreeModel::row-inserted].
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct pointing to the inserted row
+<parameter_description> a `GtkTreePath` pointing to the inserted row
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a valid #GtkTreeIter-struct pointing to the inserted row
+<parameter_description> a valid `GtkTreeIter` pointing to the inserted row
</parameter_description>
</parameter>
</parameters>
@@ -82803,7 +82895,9 @@ Emits the #GtkTreeModel::row-inserted signal on @tree_model.
<function name="gtk_tree_model_rows_reordered">
<description>
-Emits the #GtkTreeModel::rows-reordered signal on @tree_model.
+Emits the ::rows-reordered signal on @tree_model.
+
+See [signal@Gtk.TreeModel::rows-reordered].
This should be called by models when their rows have been
reordered.
@@ -82811,16 +82905,16 @@ reordered.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct pointing to the tree node whose children
+<parameter_description> a `GtkTreePath` pointing to the tree node whose children
have been reordered
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a valid #GtkTreeIter-struct pointing to the node whose children
+<parameter_description> a valid `GtkTreeIter` pointing to the node whose children
have been reordered, or %NULL if the depth of @path is 0
</parameter_description>
</parameter>
@@ -82836,7 +82930,9 @@ i.e. @new_order`[newpos] = oldpos`
<function name="gtk_tree_model_rows_reordered_with_length">
<description>
-Emits the #GtkTreeModel::rows-reordered signal on @tree_model.
+Emits the ::rows-reordered signal on @tree_model.
+
+See [signal@Gtk.TreeModel::rows-reordered].
This should be called by models when their rows have been
reordered.
@@ -82844,16 +82940,16 @@ reordered.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct pointing to the tree node whose children
+<parameter_description> a `GtkTreePath` pointing to the tree node whose children
have been reordered
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a valid #GtkTreeIter-struct pointing to the node
+<parameter_description> a valid `GtkTreeIter` pointing to the node
whose children have been reordered, or %NULL if the depth
of @path is 0
</parameter_description>
@@ -82885,7 +82981,7 @@ iters will be invalid.
</description>
<parameters>
<parameter name="tree_model_sort">
-<parameter_description> A #GtkTreeModelSort
+<parameter_description> A `GtkTreeModelSort`
</parameter_description>
</parameter>
</parameters>
@@ -82902,15 +82998,15 @@ is returned. Note: a boolean is only returned since 2.14.
</description>
<parameters>
<parameter name="tree_model_sort">
-<parameter_description> A #GtkTreeModelSort
+<parameter_description> A `GtkTreeModelSort`
</parameter_description>
</parameter>
<parameter name="sort_iter">
-<parameter_description> An uninitialized #GtkTreeIter.
+<parameter_description> An uninitialized `GtkTreeIter`
</parameter_description>
</parameter>
<parameter name="child_iter">
-<parameter_description> A valid #GtkTreeIter pointing to a row on the child model
+<parameter_description> A valid `GtkTreeIter` pointing to a row on the child model
</parameter_description>
</parameter>
</parameters>
@@ -82930,15 +83026,15 @@ path on the child model, then %NULL is returned.
</description>
<parameters>
<parameter name="tree_model_sort">
-<parameter_description> A #GtkTreeModelSort
+<parameter_description> A `GtkTreeModelSort`
</parameter_description>
</parameter>
<parameter name="child_path">
-<parameter_description> A #GtkTreePath to convert
+<parameter_description> A `GtkTreePath` to convert
</parameter_description>
</parameter>
</parameters>
-<return> A newly allocated #GtkTreePath, or %NULL
+<return> A newly allocated `GtkTreePath`
</return>
</function>
@@ -82949,15 +83045,15 @@ Sets @child_iter to point to the row pointed to by @sorted_iter.
</description>
<parameters>
<parameter name="tree_model_sort">
-<parameter_description> A #GtkTreeModelSort
+<parameter_description> A `GtkTreeModelSort`
</parameter_description>
</parameter>
<parameter name="child_iter">
-<parameter_description> An uninitialized #GtkTreeIter
+<parameter_description> An uninitialized `GtkTreeIter`
</parameter_description>
</parameter>
<parameter name="sorted_iter">
-<parameter_description> A valid #GtkTreeIter pointing to a row on @tree_model_sort.
+<parameter_description> A valid `GtkTreeIter` pointing to a row on @tree_model_sort.
</parameter_description>
</parameter>
</parameters>
@@ -82976,27 +83072,27 @@ sorted. If @sorted_path does not point to a location in the child model,
</description>
<parameters>
<parameter name="tree_model_sort">
-<parameter_description> A #GtkTreeModelSort
+<parameter_description> A `GtkTreeModelSort`
</parameter_description>
</parameter>
<parameter name="sorted_path">
-<parameter_description> A #GtkTreePath to convert
+<parameter_description> A `GtkTreePath` to convert
</parameter_description>
</parameter>
</parameters>
-<return> A newly allocated #GtkTreePath, or %NULL
+<return> A newly allocated `GtkTreePath`
</return>
</function>
<function name="gtk_tree_model_sort_get_model">
<description>
-Returns the model the #GtkTreeModelSort is sorting.
+Returns the model the `GtkTreeModelSort` is sorting.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModelSort
+<parameter_description> a `GtkTreeModelSort`
</parameter_description>
</parameter>
</parameters>
@@ -83009,17 +83105,17 @@ Returns the model the #GtkTreeModelSort is sorting.
> This function is slow. Only use it for debugging and/or testing
> purposes.
-Checks if the given iter is a valid iter for this #GtkTreeModelSort.
+Checks if the given iter is a valid iter for this `GtkTreeModelSort`.
</description>
<parameters>
<parameter name="tree_model_sort">
-<parameter_description> A #GtkTreeModelSort.
+<parameter_description> A `GtkTreeModelSort`.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> A #GtkTreeIter.
+<parameter_description> A `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -83029,17 +83125,17 @@ Checks if the given iter is a valid iter for this #GtkTreeModelSort.
<function name="gtk_tree_model_sort_new_with_model">
<description>
-Creates a new #GtkTreeModelSort, with @child_model as the child model.
+Creates a new `GtkTreeModelSort`, with @child_model as the child model.
</description>
<parameters>
<parameter name="child_model">
-<parameter_description> A #GtkTreeModel
+<parameter_description> A `GtkTreeModel`
</parameter_description>
</parameter>
</parameters>
-<return> A new #GtkTreeModelSort.
+<return> A new `GtkTreeModelSort`.
</return>
</function>
@@ -83047,13 +83143,13 @@ Creates a new #GtkTreeModelSort, with @child_model as the child model.
<description>
This resets the default sort function to be in the “unsorted” state. That
is, it is in the same order as the child model. It will re-sort the model
-to be in the same order as the child model only if the #GtkTreeModelSort
+to be in the same order as the child model only if the `GtkTreeModelSort`
is in “unsorted” state.
</description>
<parameters>
<parameter name="tree_model_sort">
-<parameter_description> A #GtkTreeModelSort
+<parameter_description> A `GtkTreeModelSort`
</parameter_description>
</parameter>
</parameters>
@@ -83070,11 +83166,11 @@ function is set.
</description>
<parameters>
<parameter name="tree_model_sort">
-<parameter_description> The #GtkTreeModelSort.
+<parameter_description> The `GtkTreeModelSort`.
</parameter_description>
</parameter>
<parameter name="child_model">
-<parameter_description> A #GtkTreeModel, or %NULL.
+<parameter_description> A `GtkTreeModel`
</parameter_description>
</parameter>
</parameters>
@@ -83095,11 +83191,11 @@ Please note that nodes that are deleted are not unreffed.
</description>
<parameters>
<parameter name="tree_model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> the #GtkTreeIter-struct
+<parameter_description> the `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -83115,7 +83211,7 @@ As a result, the depth of the path is increased.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
<parameter name="index_">
@@ -83138,11 +83234,11 @@ If the two nodes are equal, then 0 is returned.
</description>
<parameters>
<parameter name="a">
-<parameter_description> a #GtkTreePath-struct
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
<parameter name="b">
-<parameter_description> a #GtkTreePath-struct to compare with
+<parameter_description> a `GtkTreePath` to compare with
</parameter_description>
</parameter>
</parameters>
@@ -83152,17 +83248,17 @@ If the two nodes are equal, then 0 is returned.
<function name="gtk_tree_path_copy">
<description>
-Creates a new #GtkTreePath-struct as a copy of @path.
+Creates a new `GtkTreePath` as a copy of @path.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
</parameters>
-<return> a new #GtkTreePath-struct
+<return> a new `GtkTreePath`
</return>
</function>
@@ -83173,7 +83269,7 @@ Moves @path to point to the first child of the current path.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
</parameters>
@@ -83187,7 +83283,7 @@ Frees @path. If @path is %NULL, it simply returns.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
</parameters>
@@ -83202,7 +83298,7 @@ Returns the current depth of @path.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
</parameters>
@@ -83223,11 +83319,11 @@ The length of the array can be obtained with gtk_tree_path_get_depth().
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
</parameters>
-<return> The current indices, or %NULL
+<return> The current indices
</return>
</function>
@@ -83243,17 +83339,17 @@ The array should not be freed.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
<parameter name="depth">
<parameter_description> return location for number of elements
-returned in the integer array, or %NULL
+returned in the integer array
</parameter_description>
</parameter>
</parameters>
<return> The current
-indices, or %NULL
+indices
</return>
</function>
@@ -83265,11 +83361,11 @@ Returns %TRUE if @descendant is a descendant of @path.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
<parameter name="descendant">
-<parameter_description> another #GtkTreePath-struct
+<parameter_description> another `GtkTreePath`
</parameter_description>
</parameter>
</parameters>
@@ -83285,11 +83381,11 @@ Returns %TRUE if @path is a descendant of @ancestor.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
<parameter name="ancestor">
-<parameter_description> another #GtkTreePath-struct
+<parameter_description> another `GtkTreePath`
</parameter_description>
</parameter>
</parameters>
@@ -83299,20 +83395,20 @@ Returns %TRUE if @path is a descendant of @ancestor.
<function name="gtk_tree_path_new">
<description>
-Creates a new #GtkTreePath-struct.
+Creates a new `GtkTreePath`
This refers to a row.
</description>
<parameters>
</parameters>
-<return> A newly created #GtkTreePath-struct.
+<return> A newly created `GtkTreePath`.
</return>
</function>
<function name="gtk_tree_path_new_first">
<description>
-Creates a new #GtkTreePath-struct.
+Creates a new `GtkTreePath`.
The string representation of this path is “0”.
@@ -83320,7 +83416,7 @@ The string representation of this path is “0”.
</description>
<parameters>
</parameters>
-<return> A new #GtkTreePath-struct
+<return> A new `GtkTreePath`
</return>
</function>
@@ -83340,7 +83436,7 @@ Creates a new path with @first_index and @varargs as indices.
</parameter_description>
</parameter>
</parameters>
-<return> A newly created #GtkTreePath-struct
+<return> A newly created `GtkTreePath`
</return>
</function>
@@ -83360,13 +83456,13 @@ Creates a new path with the given @indices array of @length.
</parameter_description>
</parameter>
</parameters>
-<return> A newly created #GtkTreePath-struct
+<return> A newly created `GtkTreePath`
</return>
</function>
<function name="gtk_tree_path_new_from_string">
<description>
-Creates a new #GtkTreePath-struct initialized to @path.
+Creates a new `GtkTreePath` initialized to @path.
@path is expected to be a colon separated list of numbers.
For example, the string “10:4:0” would create a path of depth
@@ -83382,7 +83478,7 @@ If an invalid path string is passed in, %NULL is returned.
</parameter_description>
</parameter>
</parameters>
-<return> A newly-created #GtkTreePath-struct, or %NULL
+<return> A newly-created `GtkTreePath`
</return>
</function>
@@ -83393,7 +83489,7 @@ Moves the @path to point to the next node at the current depth.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
</parameters>
@@ -83409,7 +83505,7 @@ As a result, the depth of the path is increased.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
<parameter name="index_">
@@ -83429,7 +83525,7 @@ current depth, if it exists.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
</parameters>
@@ -83451,12 +83547,11 @@ depth 0, %NULL is returned.
</description>
<parameters>
<parameter name="path">
-<parameter_description> A #GtkTreePath-struct
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
</parameters>
-<return> A newly-allocated string.
-Must be freed with g_free().
+<return> A newly-allocated string
</return>
</function>
@@ -83468,7 +83563,7 @@ Moves the @path to point to its parent node, if it has a parent.
</description>
<parameters>
<parameter name="path">
-<parameter_description> a #GtkTreePath-struct
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
</parameters>
@@ -83499,13 +83594,13 @@ trees) of @tree.
<function name="gtk_tree_row_reference_copy">
<description>
-Copies a #GtkTreeRowReference.
+Copies a `GtkTreeRowReference`.
</description>
<parameters>
<parameter name="reference">
-<parameter_description> a #GtkTreeRowReference
+<parameter_description> a `GtkTreeRowReference`
</parameter_description>
</parameter>
</parameters>
@@ -83517,12 +83612,12 @@ Copies a #GtkTreeRowReference.
<description>
Lets a set of row reference created by
gtk_tree_row_reference_new_proxy() know that the
-model emitted the #GtkTreeModel::row-deleted signal.
+model emitted the ::row-deleted signal.
</description>
<parameters>
<parameter name="proxy">
-<parameter_description> a #GObject
+<parameter_description> a `GObject`
</parameter_description>
</parameter>
<parameter name="path">
@@ -83540,7 +83635,7 @@ Free’s @reference. @reference may be %NULL
</description>
<parameters>
<parameter name="reference">
-<parameter_description> a #GtkTreeRowReference, or %NULL
+<parameter_description> a `GtkTreeRowReference`
</parameter_description>
</parameter>
</parameters>
@@ -83555,7 +83650,7 @@ Returns the model that the row reference is monitoring.
</description>
<parameters>
<parameter name="reference">
-<parameter_description> a #GtkTreeRowReference
+<parameter_description> a `GtkTreeRowReference`
</parameter_description>
</parameter>
</parameters>
@@ -83572,11 +83667,11 @@ or %NULL if the path pointed to is no longer valid.
</description>
<parameters>
<parameter name="reference">
-<parameter_description> a #GtkTreeRowReference
+<parameter_description> a `GtkTreeRowReference`
</parameter_description>
</parameter>
</parameters>
-<return> a current path, or %NULL
+<return> a current path
</return>
</function>
@@ -83584,12 +83679,12 @@ or %NULL if the path pointed to is no longer valid.
<description>
Lets a set of row reference created by
gtk_tree_row_reference_new_proxy() know that the
-model emitted the #GtkTreeModel::row-inserted signal.
+model emitted the ::row-inserted signal.
</description>
<parameters>
<parameter name="proxy">
-<parameter_description> a #GObject
+<parameter_description> a `GObject`
</parameter_description>
</parameter>
<parameter name="path">
@@ -83613,15 +83708,15 @@ propagated, and the path is updated appropriately. If
</description>
<parameters>
<parameter name="model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a valid #GtkTreePath-struct to monitor
+<parameter_description> a valid `GtkTreePath` to monitor
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated #GtkTreeRowReference, or %NULL
+<return> a newly allocated `GtkTreeRowReference`
</return>
</function>
@@ -83643,7 +83738,7 @@ gtk_tree_row_reference_reordered().
These functions must be called exactly once per proxy when the
corresponding signal on the model is emitted. This single call
updates all row references for that proxy. Since built-in GTK
-objects like #GtkTreeView already use this mechanism internally,
+objects like `GtkTreeView` already use this mechanism internally,
using them as the proxy object will produce unpredictable results.
Further more, passing the same object as @model and @proxy
doesn’t work for reasons of internal implementation.
@@ -83656,19 +83751,19 @@ itself, and is not generally needed by most applications.
</description>
<parameters>
<parameter name="proxy">
-<parameter_description> a proxy #GObject
+<parameter_description> a proxy `GObject`
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> a #GtkTreeModel
+<parameter_description> a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a valid #GtkTreePath-struct to monitor
+<parameter_description> a valid `GtkTreePath` to monitor
</parameter_description>
</parameter>
</parameters>
-<return> a newly allocated #GtkTreeRowReference, or %NULL
+<return> a newly allocated `GtkTreeRowReference`
</return>
</function>
@@ -83676,12 +83771,12 @@ itself, and is not generally needed by most applications.
<description>
Lets a set of row reference created by
gtk_tree_row_reference_new_proxy() know that the
-model emitted the #GtkTreeModel::rows-reordered signal.
+model emitted the ::rows-reordered signal.
</description>
<parameters>
<parameter name="proxy">
-<parameter_description> a #GObject
+<parameter_description> a `GObject`
</parameter_description>
</parameter>
<parameter name="path">
@@ -83709,7 +83804,7 @@ a current valid path.
</description>
<parameters>
<parameter name="reference">
-<parameter_description> a #GtkTreeRowReference, or %NULL
+<parameter_description> a `GtkTreeRowReference`
</parameter_description>
</parameter>
</parameters>
@@ -83725,7 +83820,7 @@ Returns the number of rows that have been selected in @tree.
</description>
<parameters>
<parameter name="selection">
-<parameter_description> A #GtkTreeSelection.
+<parameter_description> A `GtkTreeSelection`.
</parameter_description>
</parameter>
</parameters>
@@ -83742,7 +83837,7 @@ gtk_tree_selection_set_mode().
</description>
<parameters>
<parameter name="selection">
-<parameter_description> a #GtkTreeSelection
+<parameter_description> a `GtkTreeSelection`
</parameter_description>
</parameter>
</parameters>
@@ -83758,7 +83853,7 @@ Returns the current selection function.
</description>
<parameters>
<parameter name="selection">
-<parameter_description> A #GtkTreeSelection.
+<parameter_description> A `GtkTreeSelection`.
</parameter_description>
</parameter>
</parameters>
@@ -83769,24 +83864,24 @@ Returns the current selection function.
<function name="gtk_tree_selection_get_selected">
<description>
Sets @iter to the currently selected node if @selection is set to
-#GTK_SELECTION_SINGLE or #GTK_SELECTION_BROWSE. @iter may be NULL if you
+%GTK_SELECTION_SINGLE or %GTK_SELECTION_BROWSE. @iter may be NULL if you
just want to test if @selection has any selected nodes. @model is filled
with the current model as a convenience. This function will not work if you
-use @selection is #GTK_SELECTION_MULTIPLE.
+use @selection is %GTK_SELECTION_MULTIPLE.
</description>
<parameters>
<parameter name="selection">
-<parameter_description> A #GtkTreeSelection.
+<parameter_description> A `GtkTreeSelection`.
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> A pointer to set to the #GtkTreeModel, or NULL.
+<parameter_description> A pointer to set to the `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> The #GtkTreeIter, or NULL.
+<parameter_description> The `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -83798,7 +83893,7 @@ use @selection is #GTK_SELECTION_MULTIPLE.
<description>
Creates a list of path of all selected rows. Additionally, if you are
planning on modifying the model after calling this function, you may
-want to convert the returned list into a list of #GtkTreeRowReferences.
+want to convert the returned list into a list of `GtkTreeRowReference`s.
To do this, you can use gtk_tree_row_reference_new().
To free the return value, use:
@@ -83810,15 +83905,15 @@ g_list_free_full (list, (GDestroyNotify) gtk_tree_path_free);
</description>
<parameters>
<parameter name="selection">
-<parameter_description> A #GtkTreeSelection.
+<parameter_description> A `GtkTreeSelection`.
</parameter_description>
</parameter>
<parameter name="model">
-<parameter_description> A pointer to set to the #GtkTreeModel, or %NULL.
+<parameter_description> A pointer to set to the `GtkTreeModel`
</parameter_description>
</parameter>
</parameters>
-<return> A #GList containing a #GtkTreePath for each selected row.
+<return> A `GList` containing a `GtkTreePath` for each selected row.
</return>
</function>
@@ -83830,11 +83925,11 @@ Returns the tree view associated with @selection.
</description>
<parameters>
<parameter name="selection">
-<parameter_description> A #GtkTreeSelection
+<parameter_description> A `GtkTreeSelection`
</parameter_description>
</parameter>
</parameters>
-<return> A #GtkTreeView
+<return> A `GtkTreeView`
</return>
</function>
@@ -83846,7 +83941,7 @@ Returns the user data for the selection function.
</description>
<parameters>
<parameter name="selection">
-<parameter_description> A #GtkTreeSelection.
+<parameter_description> A `GtkTreeSelection`.
</parameter_description>
</parameter>
</parameters>
@@ -83862,11 +83957,11 @@ Returns %TRUE if the row at @iter is currently selected.
</description>
<parameters>
<parameter name="selection">
-<parameter_description> A #GtkTreeSelection
+<parameter_description> A `GtkTreeSelection`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> A valid #GtkTreeIter
+<parameter_description> A valid `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -83883,11 +83978,11 @@ does not point to a valid location, %FALSE is returned
</description>
<parameters>
<parameter name="selection">
-<parameter_description> A #GtkTreeSelection.
+<parameter_description> A `GtkTreeSelection`.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> A #GtkTreePath to check selection on.
+<parameter_description> A `GtkTreePath` to check selection on.
</parameter_description>
</parameter>
</parameters>
@@ -83897,13 +83992,13 @@ does not point to a valid location, %FALSE is returned
<function name="gtk_tree_selection_select_all">
<description>
-Selects all the nodes. @selection must be set to #GTK_SELECTION_MULTIPLE
+Selects all the nodes. @selection must be set to %GTK_SELECTION_MULTIPLE
mode.
</description>
<parameters>
<parameter name="selection">
-<parameter_description> A #GtkTreeSelection.
+<parameter_description> A `GtkTreeSelection`.
</parameter_description>
</parameter>
</parameters>
@@ -83917,11 +84012,11 @@ Selects the specified iterator.
</description>
<parameters>
<parameter name="selection">
-<parameter_description> A #GtkTreeSelection.
+<parameter_description> A `GtkTreeSelection`.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> The #GtkTreeIter to be selected.
+<parameter_description> The `GtkTreeIter` to be selected.
</parameter_description>
</parameter>
</parameters>
@@ -83935,11 +84030,11 @@ Select the row at @path.
</description>
<parameters>
<parameter name="selection">
-<parameter_description> A #GtkTreeSelection.
+<parameter_description> A `GtkTreeSelection`.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> The #GtkTreePath to be selected.
+<parameter_description> The `GtkTreePath` to be selected.
</parameter_description>
</parameter>
</parameters>
@@ -83949,12 +84044,12 @@ Select the row at @path.
<function name="gtk_tree_selection_select_range">
<description>
Selects a range of nodes, determined by @start_path and @end_path inclusive.
-@selection must be set to #GTK_SELECTION_MULTIPLE mode.
+@selection must be set to %GTK_SELECTION_MULTIPLE mode.
</description>
<parameters>
<parameter name="selection">
-<parameter_description> A #GtkTreeSelection.
+<parameter_description> A `GtkTreeSelection`.
</parameter_description>
</parameter>
<parameter name="start_path">
@@ -83978,7 +84073,7 @@ gtk_tree_selection_get_selected_rows() might be more useful.
</description>
<parameters>
<parameter name="selection">
-<parameter_description> A #GtkTreeSelection.
+<parameter_description> A `GtkTreeSelection`.
</parameter_description>
</parameter>
<parameter name="func">
@@ -83996,13 +84091,13 @@ gtk_tree_selection_get_selected_rows() might be more useful.
<function name="gtk_tree_selection_set_mode">
<description>
Sets the selection mode of the @selection. If the previous type was
-#GTK_SELECTION_MULTIPLE, then the anchor is kept selected, if it was
+%GTK_SELECTION_MULTIPLE, then the anchor is kept selected, if it was
previously selected.
</description>
<parameters>
<parameter name="selection">
-<parameter_description> A #GtkTreeSelection.
+<parameter_description> A `GtkTreeSelection`.
</parameter_description>
</parameter>
<parameter name="type">
@@ -84025,7 +84120,7 @@ if the state of the node should be left unchanged.
</description>
<parameters>
<parameter name="selection">
-<parameter_description> A #GtkTreeSelection.
+<parameter_description> A `GtkTreeSelection`.
</parameter_description>
</parameter>
<parameter name="func">
@@ -84051,7 +84146,7 @@ Unselects all the nodes.
</description>
<parameters>
<parameter name="selection">
-<parameter_description> A #GtkTreeSelection.
+<parameter_description> A `GtkTreeSelection`.
</parameter_description>
</parameter>
</parameters>
@@ -84065,11 +84160,11 @@ Unselects the specified iterator.
</description>
<parameters>
<parameter name="selection">
-<parameter_description> A #GtkTreeSelection.
+<parameter_description> A `GtkTreeSelection`.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> The #GtkTreeIter to be unselected.
+<parameter_description> The `GtkTreeIter` to be unselected.
</parameter_description>
</parameter>
</parameters>
@@ -84083,11 +84178,11 @@ Unselects the row at @path.
</description>
<parameters>
<parameter name="selection">
-<parameter_description> A #GtkTreeSelection.
+<parameter_description> A `GtkTreeSelection`.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> The #GtkTreePath to be unselected.
+<parameter_description> The `GtkTreePath` to be unselected.
</parameter_description>
</parameter>
</parameters>
@@ -84102,7 +84197,7 @@ inclusive.
</description>
<parameters>
<parameter name="selection">
-<parameter_description> A #GtkTreeSelection.
+<parameter_description> A `GtkTreeSelection`.
</parameter_description>
</parameter>
<parameter name="start_path">
@@ -84128,7 +84223,7 @@ order. It returns %TRUE unless the @sort_column_id is
</description>
<parameters>
<parameter name="sortable">
-<parameter_description> A #GtkTreeSortable
+<parameter_description> A `GtkTreeSortable`
</parameter_description>
</parameter>
<parameter name="sort_column_id">
@@ -84136,7 +84231,7 @@ order. It returns %TRUE unless the @sort_column_id is
</parameter_description>
</parameter>
<parameter name="order">
-<parameter_description> The #GtkSortType to be filled in
+<parameter_description> The `GtkSortType` to be filled in
</parameter_description>
</parameter>
</parameters>
@@ -84155,7 +84250,7 @@ go back to the default state, or not.
</description>
<parameters>
<parameter name="sortable">
-<parameter_description> A #GtkTreeSortable
+<parameter_description> A `GtkTreeSortable`
</parameter_description>
</parameter>
</parameters>
@@ -84178,7 +84273,7 @@ is %GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, the model will be unsorted.
</description>
<parameters>
<parameter name="sortable">
-<parameter_description> A #GtkTreeSortable
+<parameter_description> A `GtkTreeSortable`
</parameter_description>
</parameter>
<parameter name="sort_func">
@@ -84186,11 +84281,11 @@ is %GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, the model will be unsorted.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> User data to pass to @sort_func, or %NULL
+<parameter_description> User data to pass to @sort_func
</parameter_description>
</parameter>
<parameter name="destroy">
-<parameter_description> Destroy notifier of @user_data, or %NULL
+<parameter_description> Destroy notifier of @user_data
</parameter_description>
</parameter>
</parameters>
@@ -84201,7 +84296,7 @@ is %GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, the model will be unsorted.
<description>
Sets the current sort column to be @sort_column_id. The @sortable will
resort itself to reflect this change, after emitting a
-#GtkTreeSortable::sort-column-changed signal. @sort_column_id may either be
+`GtkTreeSortable::sort-column-changed` signal. @sort_column_id may either be
a regular column id, or one of the following special values:
- %GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID: the default sort function
@@ -84212,7 +84307,7 @@ will be used, if it is set
</description>
<parameters>
<parameter name="sortable">
-<parameter_description> A #GtkTreeSortable
+<parameter_description> A `GtkTreeSortable`
</parameter_description>
</parameter>
<parameter name="sort_column_id">
@@ -84236,7 +84331,7 @@ the model will sort using this function.
</description>
<parameters>
<parameter name="sortable">
-<parameter_description> A #GtkTreeSortable
+<parameter_description> A `GtkTreeSortable`
</parameter_description>
</parameter>
<parameter name="sort_column_id">
@@ -84248,11 +84343,11 @@ the model will sort using this function.
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> User data to pass to @sort_func, or %NULL
+<parameter_description> User data to pass to @sort_func
</parameter_description>
</parameter>
<parameter name="destroy">
-<parameter_description> Destroy notifier of @user_data, or %NULL
+<parameter_description> Destroy notifier of @user_data
</parameter_description>
</parameter>
</parameters>
@@ -84261,12 +84356,12 @@ the model will sort using this function.
<function name="gtk_tree_sortable_sort_column_changed">
<description>
-Emits a #GtkTreeSortable::sort-column-changed signal on @sortable.
+Emits a `GtkTreeSortable::sort-column-changed` signal on @sortable.
</description>
<parameters>
<parameter name="sortable">
-<parameter_description> A #GtkTreeSortable
+<parameter_description> A `GtkTreeSortable`
</parameter_description>
</parameter>
</parameters>
@@ -84284,15 +84379,15 @@ gtk_tree_store_set() or gtk_tree_store_set_value().
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore
+<parameter_description> A `GtkTreeStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> An unset #GtkTreeIter to set to the appended row
+<parameter_description> An unset `GtkTreeIter` to set to the appended row
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> A valid `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -84306,7 +84401,7 @@ Removes all rows from @tree_store
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> a #GtkTreeStore
+<parameter_description> a `GtkTreeStore`
</parameter_description>
</parameter>
</parameters>
@@ -84327,15 +84422,15 @@ gtk_tree_store_set_value().
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore
+<parameter_description> A `GtkTreeStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> An unset #GtkTreeIter to set to the new row
+<parameter_description> An unset `GtkTreeIter` to set to the new row
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> A valid `GtkTreeIter`
</parameter_description>
</parameter>
<parameter name="position">
@@ -84362,19 +84457,19 @@ gtk_tree_store_set() or gtk_tree_store_set_value().
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore
+<parameter_description> A `GtkTreeStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> An unset #GtkTreeIter to set to the new row
+<parameter_description> An unset `GtkTreeIter` to set to the new row
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> A valid `GtkTreeIter`
</parameter_description>
</parameter>
<parameter name="sibling">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> A valid `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -84397,19 +84492,19 @@ gtk_tree_store_set() or gtk_tree_store_set_value().
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore
+<parameter_description> A `GtkTreeStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> An unset #GtkTreeIter to set to the new row
+<parameter_description> An unset `GtkTreeIter` to set to the new row
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> A valid `GtkTreeIter`
</parameter_description>
</parameter>
<parameter name="sibling">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> A valid `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -84440,15 +84535,15 @@ inserting rows in a sorted tree store.
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore
+<parameter_description> A `GtkTreeStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> An unset #GtkTreeIter to set the new row, or %NULL.
+<parameter_description> An unset `GtkTreeIter` to set the new row
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> A valid `GtkTreeIter`
</parameter_description>
</parameter>
<parameter name="position">
@@ -84472,15 +84567,15 @@ function is mainly intended for language bindings.
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore
+<parameter_description> A `GtkTreeStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> An unset #GtkTreeIter to set the new row, or %NULL.
+<parameter_description> An unset `GtkTreeIter` to set the new row
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> A valid `GtkTreeIter`
</parameter_description>
</parameter>
<parameter name="position">
@@ -84512,15 +84607,15 @@ parent (or grandparent or great-grandparent) of @descendant.
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore
+<parameter_description> A `GtkTreeStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> A valid #GtkTreeIter
+<parameter_description> A valid `GtkTreeIter`
</parameter_description>
</parameter>
<parameter name="descendant">
-<parameter_description> A valid #GtkTreeIter
+<parameter_description> A valid `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -84537,11 +84632,11 @@ for anything down a level, etc.
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore
+<parameter_description> A `GtkTreeStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> A valid #GtkTreeIter
+<parameter_description> A valid `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -84554,17 +84649,17 @@ for anything down a level, etc.
WARNING: This function is slow. Only use it for debugging and/or testing
purposes.
-Checks if the given iter is a valid iter for this #GtkTreeStore.
+Checks if the given iter is a valid iter for this `GtkTreeStore`.
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore.
+<parameter_description> A `GtkTreeStore`.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> A #GtkTreeIter.
+<parameter_description> A `GtkTreeIter`.
</parameter_description>
</parameter>
</parameters>
@@ -84582,15 +84677,15 @@ to the start of the level.
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore.
+<parameter_description> A `GtkTreeStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> A #GtkTreeIter.
+<parameter_description> A `GtkTreeIter`.
</parameter_description>
</parameter>
<parameter name="position">
-<parameter_description> A #GtkTreeIter.
+<parameter_description> A `GtkTreeIter`.
</parameter_description>
</parameter>
</parameters>
@@ -84607,15 +84702,15 @@ moved to the end of the level.
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore.
+<parameter_description> A `GtkTreeStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> A #GtkTreeIter.
+<parameter_description> A `GtkTreeIter`
</parameter_description>
</parameter>
<parameter name="position">
-<parameter_description> A #GtkTreeIter or %NULL.
+<parameter_description> A `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -84628,9 +84723,14 @@ Creates a new tree store as with @n_columns columns each of the types passed
in. Note that only types derived from standard GObject fundamental types
are supported.
-As an example, `gtk_tree_store_new (3, G_TYPE_INT, G_TYPE_STRING,
-GDK_TYPE_TEXTURE);` will create a new #GtkTreeStore with three columns, of type
-#int, #gchararray, and #GdkTexture respectively.
+As an example,
+
+```
+gtk_tree_store_new (3, G_TYPE_INT, G_TYPE_STRING, GDK_TYPE_TEXTURE);
+```
+
+will create a new `GtkTreeStore` with three columns, of type
+`int`, `gchararray`, and `GdkTexture` respectively.
</description>
@@ -84640,11 +84740,11 @@ GDK_TYPE_TEXTURE);` will create a new #GtkTreeStore with three columns, of type
</parameter_description>
</parameter>
<parameter name="Varargs">
-<parameter_description> all #GType types for the columns, from first to last
+<parameter_description> all `GType` types for the columns, from first to last
</parameter_description>
</parameter>
</parameters>
-<return> a new #GtkTreeStore
+<return> a new `GtkTreeStore`
</return>
</function>
@@ -84660,11 +84760,11 @@ Non vararg creation function. Used primarily by language bindings.
</parameter_description>
</parameter>
<parameter name="types">
-<parameter_description> an array of #GType types for the columns, from first to last
+<parameter_description> an array of `GType` types for the columns, from first to last
</parameter_description>
</parameter>
</parameters>
-<return> a new #GtkTreeStore
+<return> a new `GtkTreeStore`
</return>
</function>
@@ -84679,15 +84779,15 @@ call gtk_tree_store_set() or gtk_tree_store_set_value().
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore
+<parameter_description> A `GtkTreeStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> An unset #GtkTreeIter to set to the prepended row
+<parameter_description> An unset `GtkTreeIter` to set to the prepended row
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> A valid #GtkTreeIter, or %NULL
+<parameter_description> A valid `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -84704,11 +84804,11 @@ last one.
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore
+<parameter_description> A `GtkTreeStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> A valid #GtkTreeIter
+<parameter_description> A valid `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
@@ -84725,11 +84825,11 @@ unsorted stores.
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore
+<parameter_description> A `GtkTreeStore`
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> A #GtkTreeIter, or %NULL
+<parameter_description> A `GtkTreeIter`
</parameter_description>
</parameter>
<parameter name="new_order">
@@ -84757,11 +84857,11 @@ will be copied if it is a %G_TYPE_STRING or %G_TYPE_BOXED.
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore
+<parameter_description> A `GtkTreeStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> A valid #GtkTreeIter for the row being modified
+<parameter_description> A valid `GtkTreeIter` for the row being modified
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -84783,7 +84883,7 @@ subclasses of those types such as %GDK_TYPE_PIXBUF.
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> a #GtkTreeStore
+<parameter_description> a `GtkTreeStore`
</parameter_description>
</parameter>
<parameter name="column">
@@ -84800,15 +84900,15 @@ subclasses of those types such as %GDK_TYPE_PIXBUF.
<function name="gtk_tree_store_set_column_types">
<description>
-This function is meant primarily for #GObjects that inherit from
-#GtkTreeStore, and should only be used when constructing a new
-#GtkTreeStore. It will not function after a row has been added,
-or a method on the #GtkTreeModel interface is called.
+This function is meant primarily for `GObjects` that inherit from
+`GtkTreeStore`, and should only be used when constructing a new
+`GtkTreeStore`. It will not function after a row has been added,
+or a method on the `GtkTreeModel` interface is called.
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore
+<parameter_description> A `GtkTreeStore`
</parameter_description>
</parameter>
<parameter name="n_columns">
@@ -84816,7 +84916,7 @@ or a method on the #GtkTreeModel interface is called.
</parameter_description>
</parameter>
<parameter name="types">
-<parameter_description> An array of #GType types, one for each column
+<parameter_description> An array of `GType` types, one for each column
</parameter_description>
</parameter>
</parameters>
@@ -84832,11 +84932,11 @@ use by language bindings.
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore
+<parameter_description> A `GtkTreeStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> A valid #GtkTreeIter for the row being modified
+<parameter_description> A valid `GtkTreeIter` for the row being modified
</parameter_description>
</parameter>
<parameter name="var_args">
@@ -84857,11 +84957,11 @@ column.
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> a #GtkTreeStore
+<parameter_description> a `GtkTreeStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> A valid #GtkTreeIter for the row being modified
+<parameter_description> A valid `GtkTreeIter` for the row being modified
</parameter_description>
</parameter>
<parameter name="column">
@@ -84886,11 +84986,11 @@ the number of columns to change is not known until run-time.
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore
+<parameter_description> A `GtkTreeStore`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> A valid #GtkTreeIter for the row being modified
+<parameter_description> A valid `GtkTreeIter` for the row being modified
</parameter_description>
</parameter>
<parameter name="columns">
@@ -84917,15 +85017,15 @@ only works with unsorted stores.
</description>
<parameters>
<parameter name="tree_store">
-<parameter_description> A #GtkTreeStore.
+<parameter_description> A `GtkTreeStore`.
</parameter_description>
</parameter>
<parameter name="a">
-<parameter_description> A #GtkTreeIter.
+<parameter_description> A `GtkTreeIter`.
</parameter_description>
</parameter>
<parameter name="b">
-<parameter_description> Another #GtkTreeIter.
+<parameter_description> Another `GtkTreeIter`.
</parameter_description>
</parameter>
</parameters>
@@ -84942,11 +85042,11 @@ GTK_TREE_VIEW_COLUMN_FIXED.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView.
+<parameter_description> A `GtkTreeView`.
</parameter_description>
</parameter>
<parameter name="column">
-<parameter_description> The #GtkTreeViewColumn to add.
+<parameter_description> The `GtkTreeViewColumn` to add.
</parameter_description>
</parameter>
</parameters>
@@ -84961,7 +85061,7 @@ Recursively collapses all visible, expanded nodes in @tree_view.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView.
+<parameter_description> A `GtkTreeView`.
</parameter_description>
</parameter>
</parameters>
@@ -84976,7 +85076,7 @@ Collapses a row (hides its child rows, if they exist).
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="path">
@@ -84990,21 +85090,23 @@ Collapses a row (hides its child rows, if they exist).
<function name="gtk_tree_view_column_add_attribute">
<description>
-Adds an attribute mapping to the list in @tree_column. The @column is the
+Adds an attribute mapping to the list in @tree_column.
+
+The @column is the
column of the model to get a value from, and the @attribute is the
parameter on @cell_renderer to be set from the value. So for example
if column 2 of the model contains strings, you could have the
-“text” attribute of a #GtkCellRendererText get its values from
+“text” attribute of a `GtkCellRendererText` get its values from
column 2.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`
</parameter_description>
</parameter>
<parameter name="cell_renderer">
-<parameter_description> the #GtkCellRenderer to set attributes on
+<parameter_description> the `GtkCellRenderer` to set attributes on
</parameter_description>
</parameter>
<parameter name="attribute">
@@ -85021,61 +85123,61 @@ column 2.
<function name="gtk_tree_view_column_cell_get_position">
<description>
-Obtains the horizontal position and size of a cell in a column. If the
-cell is not found in the column, @start_pos and @width are not changed and
-%FALSE is returned.
+Obtains the horizontal position and size of a cell in a column.
+
+If the cell is not found in the column, @start_pos and @width
+are not changed and %FALSE is returned.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> a #GtkTreeViewColumn
+<parameter_description> a `GtkTreeViewColumn`
</parameter_description>
</parameter>
<parameter name="cell_renderer">
-<parameter_description> a #GtkCellRenderer
+<parameter_description> a `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="x_offset">
<parameter_description> return location for the horizontal
-position of @cell within @tree_column, may be %NULL
+position of @cell within @tree_column
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> return location for the width of @cell,
-may be %NULL
+<parameter_description> return location for the width of @cell
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if @cell belongs to @tree_column.
+<return> %TRUE if @cell belongs to @tree_column
</return>
</function>
<function name="gtk_tree_view_column_cell_get_size">
<description>
Obtains the width and height needed to render the column. This is used
-primarily by the #GtkTreeView.
+primarily by the `GtkTreeView`.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
<parameter name="x_offset">
-<parameter_description> location to return x offset of a cell relative to @cell_area, or %NULL
+<parameter_description> location to return x offset of a cell relative to @cell_area
</parameter_description>
</parameter>
<parameter name="y_offset">
-<parameter_description> location to return y offset of a cell relative to @cell_area, or %NULL
+<parameter_description> location to return y offset of a cell relative to @cell_area
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> location to return width needed to render a cell, or %NULL
+<parameter_description> location to return width needed to render a cell
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> location to return height needed to render a cell, or %NULL
+<parameter_description> location to return height needed to render a cell
</parameter_description>
</parameter>
</parameters>
@@ -85092,7 +85194,7 @@ gtk_tree_view_column_cell_set_cell_data()
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn
+<parameter_description> A `GtkTreeViewColumn`
</parameter_description>
</parameter>
</parameters>
@@ -85105,20 +85207,20 @@ gtk_tree_view_column_cell_set_cell_data()
Sets the cell renderer based on the @tree_model and @iter. That is, for
every attribute mapping in @tree_column, it will get a value from the set
column on the @iter, and use that value to set the attribute on the cell
-renderer. This is used primarily by the #GtkTreeView.
+renderer. This is used primarily by the `GtkTreeView`.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
<parameter name="tree_model">
-<parameter_description> The #GtkTreeModel to get the cell renderers attributes from.
+<parameter_description> The `GtkTreeModel` to get the cell renderers attributes from.
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> The #GtkTreeIter to get the cell renderer’s attributes from.
+<parameter_description> The `GtkTreeIter` to get the cell renderer’s attributes from.
</parameter_description>
</parameter>
<parameter name="is_expander">
@@ -85136,16 +85238,16 @@ renderer. This is used primarily by the #GtkTreeView.
<function name="gtk_tree_view_column_cell_snapshot">
<description>
Renders the cell contained by #tree_column. This is used primarily by the
-#GtkTreeView.
+`GtkTreeView`.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
<parameter name="snapshot">
-<parameter_description> #GtkSnapshot to draw to
+<parameter_description> `GtkSnapshot` to draw to
</parameter_description>
</parameter>
<parameter name="background_area">
@@ -85171,7 +85273,7 @@ Unsets all the mappings on all renderers on the @tree_column.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn
+<parameter_description> A `GtkTreeViewColumn`
</parameter_description>
</parameter>
</parameters>
@@ -85186,11 +85288,11 @@ gtk_tree_view_column_set_attributes().
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> a #GtkTreeViewColumn
+<parameter_description> a `GtkTreeViewColumn`
</parameter_description>
</parameter>
<parameter name="cell_renderer">
-<parameter_description> a #GtkCellRenderer to clear the attribute mapping on.
+<parameter_description> a `GtkCellRenderer` to clear the attribute mapping on.
</parameter_description>
</parameter>
</parameters>
@@ -85205,7 +85307,7 @@ Emits the “clicked” signal on the column. This function will only work if
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> a #GtkTreeViewColumn
+<parameter_description> a `GtkTreeViewColumn`
</parameter_description>
</parameter>
</parameters>
@@ -85220,11 +85322,11 @@ Sets the current keyboard focus to be at @cell, if the column contains
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn
+<parameter_description> A `GtkTreeViewColumn`
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> A #GtkCellRenderer
+<parameter_description> A `GtkCellRenderer`
</parameter_description>
</parameter>
</parameters>
@@ -85240,7 +85342,7 @@ between 0.0 and 1.0.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
</parameters>
@@ -85256,7 +85358,7 @@ Returns the button used in the treeview column header
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn
+<parameter_description> A `GtkTreeViewColumn`
</parameter_description>
</parameter>
</parameters>
@@ -85272,7 +85374,7 @@ Returns %TRUE if the user can click on the header for the column.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> a #GtkTreeViewColumn
+<parameter_description> a `GtkTreeViewColumn`
</parameter_description>
</parameter>
</parameters>
@@ -85288,7 +85390,7 @@ Returns %TRUE if the column expands to fill available space.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
</parameters>
@@ -85305,7 +85407,7 @@ width of the column; for that, use gtk_tree_view_column_get_width().
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
</parameters>
@@ -85322,7 +85424,7 @@ width is set.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
</parameters>
@@ -85339,7 +85441,7 @@ width is set.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
</parameters>
@@ -85355,7 +85457,7 @@ Returns %TRUE if the @tree_column can be reordered by the user.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn
+<parameter_description> A `GtkTreeViewColumn`
</parameter_description>
</parameter>
</parameters>
@@ -85371,7 +85473,7 @@ Returns %TRUE if the @tree_column can be resized by the end user.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn
+<parameter_description> A `GtkTreeViewColumn`
</parameter_description>
</parameter>
</parameters>
@@ -85387,7 +85489,7 @@ Returns the current type of @tree_column.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
</parameters>
@@ -85397,20 +85499,21 @@ Returns the current type of @tree_column.
<function name="gtk_tree_view_column_get_sort_column_id">
<description>
-Gets the logical @sort_column_id that the model sorts on when this
-column is selected for sorting.
-See gtk_tree_view_column_set_sort_column_id().
+Gets the logical @sort_column_id that the model sorts on
+when this column is selected for sorting.
+
+See [method@Gtk.TreeViewColumn.set_sort_column_id].
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> a #GtkTreeViewColumn
+<parameter_description> a `GtkTreeViewColumn`
</parameter_description>
</parameter>
</parameters>
<return> the current @sort_column_id for this column, or -1 if
-this column can’t be used for sorting.
+this column can’t be used for sorting
</return>
</function>
@@ -85422,7 +85525,7 @@ Gets the value set by gtk_tree_view_column_set_sort_indicator().
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> a #GtkTreeViewColumn
+<parameter_description> a `GtkTreeViewColumn`
</parameter_description>
</parameter>
</parameters>
@@ -85438,7 +85541,7 @@ Gets the value set by gtk_tree_view_column_set_sort_order().
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> a #GtkTreeViewColumn
+<parameter_description> a `GtkTreeViewColumn`
</parameter_description>
</parameter>
</parameters>
@@ -85454,7 +85557,7 @@ Returns the spacing of @tree_column.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
</parameters>
@@ -85470,7 +85573,7 @@ Returns the title of the widget.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
</parameters>
@@ -85481,7 +85584,7 @@ modified or freed.
<function name="gtk_tree_view_column_get_tree_view">
<description>
-Returns the #GtkTreeView wherein @tree_column has been inserted.
+Returns the `GtkTreeView` wherein @tree_column has been inserted.
If @column is currently not inserted in any tree view, %NULL is
returned.
@@ -85489,12 +85592,12 @@ returned.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn
+<parameter_description> A `GtkTreeViewColumn`
</parameter_description>
</parameter>
</parameters>
-<return> The tree view wherein @column has
-been inserted if any, %NULL otherwise.
+<return> The tree view wherein @column
+has been inserted
</return>
</function>
@@ -85506,7 +85609,7 @@ Returns %TRUE if @tree_column is visible.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
</parameters>
@@ -85517,19 +85620,19 @@ the tree will show the column.
<function name="gtk_tree_view_column_get_widget">
<description>
-Returns the #GtkWidget in the button on the column header.
+Returns the `GtkWidget` in the button on the column header.
+
If a custom widget has not been set then %NULL is returned.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`
</parameter_description>
</parameter>
</parameters>
-<return> The #GtkWidget in the column
-header, or %NULL
+<return> The `GtkWidget` in the column header
</return>
</function>
@@ -85541,7 +85644,7 @@ Returns the current size of @tree_column in pixels.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
</parameters>
@@ -85557,7 +85660,7 @@ Returns the current X offset of @tree_column in pixels.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
</parameters>
@@ -85567,38 +85670,38 @@ Returns the current X offset of @tree_column in pixels.
<function name="gtk_tree_view_column_new">
<description>
-Creates a new #GtkTreeViewColumn.
+Creates a new `GtkTreeViewColumn`.
</description>
<parameters>
</parameters>
-<return> A newly created #GtkTreeViewColumn.
+<return> A newly created `GtkTreeViewColumn`.
</return>
</function>
<function name="gtk_tree_view_column_new_with_area">
<description>
-Creates a new #GtkTreeViewColumn using @area to render its cells.
+Creates a new `GtkTreeViewColumn` using @area to render its cells.
</description>
<parameters>
<parameter name="area">
-<parameter_description> the #GtkCellArea that the newly created column should use to layout cells.
+<parameter_description> the `GtkCellArea` that the newly created column should use to layout cells.
</parameter_description>
</parameter>
</parameters>
-<return> A newly created #GtkTreeViewColumn.
+<return> A newly created `GtkTreeViewColumn`.
</return>
</function>
<function name="gtk_tree_view_column_new_with_attributes">
<description>
-Creates a new #GtkTreeViewColumn with a number of default values.
+Creates a new `GtkTreeViewColumn` with a number of default values.
This is equivalent to calling gtk_tree_view_column_set_title(),
gtk_tree_view_column_pack_start(), and
-gtk_tree_view_column_set_attributes() on the newly created #GtkTreeViewColumn.
+gtk_tree_view_column_set_attributes() on the newly created `GtkTreeViewColumn`.
Here’s a simple example:
|[<!-- language="C" -->
@@ -85624,7 +85727,7 @@ NULL);
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> The #GtkCellRenderer
+<parameter_description> The `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -85632,7 +85735,7 @@ NULL);
</parameter_description>
</parameter>
</parameters>
-<return> A newly created #GtkTreeViewColumn.
+<return> A newly created `GtkTreeViewColumn`.
</return>
</function>
@@ -85645,11 +85748,11 @@ evenly between cells for which @expand is %TRUE.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> The #GtkCellRenderer.
+<parameter_description> The `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="expand">
@@ -85669,11 +85772,11 @@ evenly between cells for which @expand is %TRUE.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> The #GtkCellRenderer.
+<parameter_description> The `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="expand">
@@ -85692,7 +85795,7 @@ their sizes renegotiated.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn
+<parameter_description> A `GtkTreeViewColumn`
</parameter_description>
</parameter>
</parameters>
@@ -85708,7 +85811,7 @@ for center, 1.0 for right.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
<parameter name="xalign">
@@ -85722,6 +85825,7 @@ for center, 1.0 for right.
<function name="gtk_tree_view_column_set_attributes">
<description>
Sets the attributes in the list as the attributes of @tree_column.
+
The attributes should be in attribute/column order, as in
gtk_tree_view_column_add_attribute(). All existing attributes
are removed, and replaced with the new attributes.
@@ -85729,11 +85833,11 @@ are removed, and replaced with the new attributes.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn
+<parameter_description> A `GtkTreeViewColumn`
</parameter_description>
</parameter>
<parameter name="cell_renderer">
-<parameter_description> the #GtkCellRenderer we’re setting the attributes of
+<parameter_description> the `GtkCellRenderer` we’re setting the attributes of
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -85746,7 +85850,9 @@ are removed, and replaced with the new attributes.
<function name="gtk_tree_view_column_set_cell_data_func">
<description>
-Sets the #GtkTreeCellDataFunc to use for the column. This
+Sets the `GtkTreeCellDataFunc` to use for the column.
+
+This
function is used instead of the standard attributes mapping for
setting the column value, and should set the value of @tree_column's
cell renderer as appropriate. @func may be %NULL to remove an
@@ -85755,15 +85861,15 @@ older one.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn
+<parameter_description> A `GtkTreeViewColumn`
</parameter_description>
</parameter>
<parameter name="cell_renderer">
-<parameter_description> A #GtkCellRenderer
+<parameter_description> A `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> The #GtkTreeCellDataFunc to use.
+<parameter_description> The `GtkTreeCellDataFunc` to use.
</parameter_description>
</parameter>
<parameter name="func_data">
@@ -85786,7 +85892,7 @@ active, then it can take keyboard focus, and can be clicked.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
<parameter name="clickable">
@@ -85810,7 +85916,7 @@ resized by the user.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
<parameter name="expand">
@@ -85827,7 +85933,7 @@ If @fixed_width is not -1, sets the fixed width of @tree_column; otherwise
unsets it. The effective value of @fixed_width is clamped between the
minimum and maximum width of the column; however, the value stored in the
“fixed-width” property is not clamped. If the column sizing is
-#GTK_TREE_VIEW_COLUMN_GROW_ONLY or #GTK_TREE_VIEW_COLUMN_AUTOSIZE, setting
+%GTK_TREE_VIEW_COLUMN_GROW_ONLY or %GTK_TREE_VIEW_COLUMN_AUTOSIZE, setting
a fixed width overrides the automatically calculated width. Note that
@fixed_width is only a hint to GTK; the width actually allocated to the
column may be greater or less than requested.
@@ -85838,7 +85944,7 @@ resized by the user.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
<parameter name="fixed_width">
@@ -85859,7 +85965,7 @@ fill any extra space.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
<parameter name="max_width">
@@ -85878,7 +85984,7 @@ minimum width is unset.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
<parameter name="min_width">
@@ -85897,7 +86003,7 @@ dragging the header.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn
+<parameter_description> A `GtkTreeViewColumn`
</parameter_description>
</parameter>
<parameter name="reorderable">
@@ -85911,14 +86017,16 @@ dragging the header.
<function name="gtk_tree_view_column_set_resizable">
<description>
If @resizable is %TRUE, then the user can explicitly resize the column by
-grabbing the outer edge of the column button. If resizable is %TRUE and
-sizing mode of the column is #GTK_TREE_VIEW_COLUMN_AUTOSIZE, then the sizing
-mode is changed to #GTK_TREE_VIEW_COLUMN_GROW_ONLY.
+grabbing the outer edge of the column button.
+
+If resizable is %TRUE and
+sizing mode of the column is %GTK_TREE_VIEW_COLUMN_AUTOSIZE, then the sizing
+mode is changed to %GTK_TREE_VIEW_COLUMN_GROW_ONLY.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn
+<parameter_description> A `GtkTreeViewColumn`
</parameter_description>
</parameter>
<parameter name="resizable">
@@ -85936,11 +86044,11 @@ Sets the growth behavior of @tree_column to @type.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
<parameter name="type">
-<parameter_description> The #GtkTreeViewColumnSizing.
+<parameter_description> The `GtkTreeViewColumn`Sizing.
</parameter_description>
</parameter>
</parameters>
@@ -85955,7 +86063,7 @@ is selected for sorting. Doing so makes the column header clickable.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> a #GtkTreeViewColumn
+<parameter_description> a `GtkTreeViewColumn`
</parameter_description>
</parameter>
<parameter name="sort_column_id">
@@ -85977,7 +86085,7 @@ the arrow.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> a #GtkTreeViewColumn
+<parameter_description> a `GtkTreeViewColumn`
</parameter_description>
</parameter>
<parameter name="setting">
@@ -86005,7 +86113,7 @@ calling this function; see gtk_tree_view_column_set_sort_indicator().
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> a #GtkTreeViewColumn
+<parameter_description> a `GtkTreeViewColumn`
</parameter_description>
</parameter>
<parameter name="order">
@@ -86024,7 +86132,7 @@ place between cell renderers packed into it.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
<parameter name="spacing">
@@ -86043,7 +86151,7 @@ this value is ignored.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
<parameter name="title">
@@ -86061,7 +86169,7 @@ Sets the visibility of @tree_column.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
<parameter name="visible">
@@ -86075,16 +86183,16 @@ Sets the visibility of @tree_column.
<function name="gtk_tree_view_column_set_widget">
<description>
Sets the widget in the header to be @widget. If widget is %NULL, then the
-header button is set with a #GtkLabel set to the title of @tree_column.
+header button is set with a `GtkLabel` set to the title of @tree_column.
</description>
<parameters>
<parameter name="tree_column">
-<parameter_description> A #GtkTreeViewColumn.
+<parameter_description> A `GtkTreeViewColumn`.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> A child #GtkWidget, or %NULL.
+<parameter_description> A child `GtkWidget`
</parameter_description>
</parameter>
</parameters>
@@ -86099,7 +86207,7 @@ treeview has been realized.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView.
+<parameter_description> A `GtkTreeView`.
</parameter_description>
</parameter>
</parameters>
@@ -86114,7 +86222,7 @@ tree (the full scrollable area of the tree).
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="bx">
@@ -86144,7 +86252,7 @@ Converts bin_window coordinates to widget relative coordinates.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="bx">
@@ -86175,7 +86283,7 @@ to bin_window coordinates.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="tx">
@@ -86206,7 +86314,7 @@ to widget coordinates.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="tx">
@@ -86236,7 +86344,7 @@ Converts widget coordinates to coordinates for the bin_window.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="wx">
@@ -86267,7 +86375,7 @@ tree (the full scrollable area of the tree).
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="wx">
@@ -86292,18 +86400,18 @@ tree (the full scrollable area of the tree).
<function name="gtk_tree_view_create_row_drag_icon">
<description>
-Creates a #cairo_surface_t representation of the row at @path.
+Creates a `cairo_surface_t` representation of the row at @path.
This image is used for a drag icon.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath in @tree_view
+<parameter_description> a `GtkTreePath` in @tree_view
</parameter_description>
</parameter>
</parameters>
@@ -86314,12 +86422,12 @@ This image is used for a drag icon.
<function name="gtk_tree_view_enable_model_drag_dest">
<description>
Turns @tree_view into a drop destination for automatic DND. Calling
-this method sets #GtkTreeView:reorderable to %FALSE.
+this method sets `GtkTreeView`:reorderable to %FALSE.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="formats">
@@ -86338,12 +86446,12 @@ widget
<function name="gtk_tree_view_enable_model_drag_source">
<description>
Turns @tree_view into a drag source for automatic DND. Calling this
-method sets #GtkTreeView:reorderable to %FALSE.
+method sets `GtkTreeView`:reorderable to %FALSE.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="start_button_mask">
@@ -86370,7 +86478,7 @@ Recursively expands all nodes in the @tree_view.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView.
+<parameter_description> A `GtkTreeView`.
</parameter_description>
</parameter>
</parameters>
@@ -86385,7 +86493,7 @@ Opens the row so its children are visible.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="path">
@@ -86409,7 +86517,7 @@ Expands the row at @path. This will also expand all parent rows of
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView.
+<parameter_description> A `GtkTreeView`.
</parameter_description>
</parameter>
<parameter name="path">
@@ -86428,7 +86536,7 @@ Gets the setting set by gtk_tree_view_set_activate_on_single_click().
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
@@ -86452,15 +86560,15 @@ itself, excluding surrounding borders and the tree expander area.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
+<parameter_description> a `GtkTreePath` for the row, or %NULL to get only horizontal coordinates
</parameter_description>
</parameter>
<parameter name="column">
-<parameter_description> a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordinates
+<parameter_description> a `GtkTreeViewColumn` for the column, or %NULL to get only vertical coordinates
</parameter_description>
</parameter>
<parameter name="rect">
@@ -86486,15 +86594,15 @@ realized.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
+<parameter_description> a `GtkTreePath` for the row, or %NULL to get only horizontal coordinates
</parameter_description>
</parameter>
<parameter name="column">
-<parameter_description> a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordinates
+<parameter_description> a `GtkTreeViewColumn` for the column, or %NULL to get only vertical coordinates
</parameter_description>
</parameter>
<parameter name="rect">
@@ -86507,13 +86615,13 @@ realized.
<function name="gtk_tree_view_get_column">
<description>
-Gets the #GtkTreeViewColumn at the given position in the #tree_view.
+Gets the `GtkTreeViewColumn` at the given position in the #tree_view.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView.
+<parameter_description> A `GtkTreeView`.
</parameter_description>
</parameter>
<parameter name="n">
@@ -86521,25 +86629,25 @@ Gets the #GtkTreeViewColumn at the given position in the #tree_view.
</parameter_description>
</parameter>
</parameters>
-<return> The #GtkTreeViewColumn, or %NULL if the
+<return> The `GtkTreeViewColumn`, or %NULL if the
position is outside the range of columns.
</return>
</function>
<function name="gtk_tree_view_get_columns">
<description>
-Returns a #GList of all the #GtkTreeViewColumn s currently in @tree_view.
+Returns a `GList` of all the `GtkTreeViewColumn`s currently in @tree_view.
The returned list must be freed with g_list_free ().
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
-<return> A list of #GtkTreeViewColumn s
+<return> A list of `GtkTreeViewColumn`s
</return>
</function>
@@ -86549,23 +86657,23 @@ Fills in @path and @focus_column with the current path and focus column. If
the cursor isn’t currently set, then *@path will be %NULL. If no column
currently has focus, then *@focus_column will be %NULL.
-The returned #GtkTreePath must be freed with gtk_tree_path_free() when
+The returned `GtkTreePath` must be freed with gtk_tree_path_free() when
you are done with it.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="path">
<parameter_description> A pointer to be
-filled with the current cursor path, or %NULL
+filled with the current cursor path
</parameter_description>
</parameter>
<parameter name="focus_column">
<parameter_description> A
-pointer to be filled with the current focus column, or %NULL
+pointer to be filled with the current focus column
</parameter_description>
</parameter>
</parameters>
@@ -86583,7 +86691,7 @@ return %FALSE if @tree_view is not realized or does not have a model.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="drag_x">
@@ -86596,7 +86704,7 @@ return %FALSE if @tree_view is not realized or does not have a model.
</parameter>
<parameter name="path">
<parameter_description> Return location for the path of
-the highlighted row, or %NULL.
+the highlighted row
</parameter_description>
</parameter>
<parameter name="pos">
@@ -86617,15 +86725,15 @@ Gets information about the row that is highlighted for feedback.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> Return location for the path of the highlighted row, or %NULL.
+<parameter_description> Return location for the path of the highlighted row
</parameter_description>
</parameter>
<parameter name="pos">
-<parameter_description> Return location for the drop position, or %NULL
+<parameter_description> Return location for the drop position
</parameter_description>
</parameter>
</parameters>
@@ -86641,7 +86749,7 @@ by typing in text.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
@@ -86657,7 +86765,7 @@ Returns whether or not tree lines are drawn in @tree_view.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView.
+<parameter_description> a `GtkTreeView`.
</parameter_description>
</parameter>
</parameters>
@@ -86676,7 +86784,7 @@ This column has the expander arrow drawn next to it.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
@@ -86692,7 +86800,7 @@ Returns whether fixed height mode is turned on for @tree_view.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
@@ -86708,11 +86816,11 @@ Returns which grid lines are enabled in @tree_view.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
-<return> a #GtkTreeViewGridLines value indicating which grid lines
+<return> a `GtkTreeView`GridLines value indicating which grid lines
are enabled.
</return>
</function>
@@ -86725,7 +86833,7 @@ Returns whether all header columns are clickable.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView.
+<parameter_description> A `GtkTreeView`.
</parameter_description>
</parameter>
</parameters>
@@ -86741,7 +86849,7 @@ Returns %TRUE if the headers on the @tree_view are visible.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView.
+<parameter_description> A `GtkTreeView`.
</parameter_description>
</parameter>
</parameters>
@@ -86757,7 +86865,7 @@ Returns whether hover expansion mode is turned on for @tree_view.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
@@ -86773,7 +86881,7 @@ Returns whether hover selection mode is turned on for @tree_view.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
@@ -86790,7 +86898,7 @@ in @tree_view.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView.
+<parameter_description> a `GtkTreeView`.
</parameter_description>
</parameter>
</parameters>
@@ -86801,19 +86909,18 @@ in @tree_view.
<function name="gtk_tree_view_get_model">
<description>
-Returns the model the #GtkTreeView is based on. Returns %NULL if the
+Returns the model the `GtkTreeView` is based on. Returns %NULL if the
model is unset.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
-<return> A #GtkTreeModel, or %NULL if
-none is currently being used.
+<return> A `GtkTreeModel`
</return>
</function>
@@ -86825,7 +86932,7 @@ Queries the number of columns in the given @tree_view.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
@@ -86840,7 +86947,7 @@ That is, @x and @y are relative to an events coordinates. Widget-relative
coordinates must be converted using
gtk_tree_view_convert_widget_to_bin_window_coords(). It is primarily for
things like popup menus. If @path is non-%NULL, then it will be filled
-with the #GtkTreePath at that point. This path should be freed with
+with the `GtkTreePath` at that point. This path should be freed with
gtk_tree_path_free(). If @column is non-%NULL, then it will be filled
with the column at that point. @cell_x and @cell_y return the coordinates
relative to the cell background (i.e. the @background_area passed to
@@ -86856,7 +86963,7 @@ gtk_tree_view_convert_widget_to_bin_window_coords().
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView.
+<parameter_description> A `GtkTreeView`.
</parameter_description>
</parameter>
<parameter name="x">
@@ -86868,23 +86975,23 @@ gtk_tree_view_convert_widget_to_bin_window_coords().
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> A pointer to a #GtkTreePath
-pointer to be filled in, or %NULL
+<parameter_description> A pointer to a `GtkTreePath`
+pointer to be filled in
</parameter_description>
</parameter>
<parameter name="column">
<parameter_description> A pointer to
-a #GtkTreeViewColumn pointer to be filled in, or %NULL
+a `GtkTreeViewColumn` pointer to be filled in
</parameter_description>
</parameter>
<parameter name="cell_x">
<parameter_description> A pointer where the X coordinate
-relative to the cell can be placed, or %NULL
+relative to the cell can be placed
</parameter_description>
</parameter>
<parameter name="cell_y">
<parameter_description> A pointer where the Y coordinate
-relative to the cell can be placed, or %NULL
+relative to the cell can be placed
</parameter_description>
</parameter>
</parameters>
@@ -86901,7 +87008,7 @@ gtk_tree_view_set_reorderable().
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
@@ -86917,7 +87024,7 @@ Returns the current row separator function.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
@@ -86928,14 +87035,14 @@ Returns the current row separator function.
<function name="gtk_tree_view_get_rubber_banding">
<description>
Returns whether rubber banding is turned on for @tree_view. If the
-selection mode is #GTK_SELECTION_MULTIPLE, rubber banding will allow the
+selection mode is %GTK_SELECTION_MULTIPLE, rubber banding will allow the
user to select multiple rows by dragging the mouse.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
@@ -86951,7 +87058,7 @@ Gets the column searched on by the interactive search code.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
@@ -86961,7 +87068,7 @@ Gets the column searched on by the interactive search code.
<function name="gtk_tree_view_get_search_entry">
<description>
-Returns the #GtkEntry which is currently in use as interactive search
+Returns the `GtkEntry` which is currently in use as interactive search
entry for @tree_view. In case the built-in entry is being used, %NULL
will be returned.
@@ -86969,7 +87076,7 @@ will be returned.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
@@ -86985,7 +87092,7 @@ Returns the compare function currently in use.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
@@ -86995,17 +87102,17 @@ Returns the compare function currently in use.
<function name="gtk_tree_view_get_selection">
<description>
-Gets the #GtkTreeSelection associated with @tree_view.
+Gets the `GtkTreeSelection` associated with @tree_view.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView.
+<parameter_description> A `GtkTreeView`.
</parameter_description>
</parameter>
</parameters>
-<return> A #GtkTreeSelection object.
+<return> A `GtkTreeSelection` object.
</return>
</function>
@@ -87017,7 +87124,7 @@ Returns whether or not expanders are drawn in @tree_view.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView.
+<parameter_description> a `GtkTreeView`.
</parameter_description>
</parameter>
</parameters>
@@ -87035,7 +87142,7 @@ displaying tooltips on @tree_view’s rows.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
@@ -87046,23 +87153,23 @@ used, or -1 if this is disabled.
<function name="gtk_tree_view_get_tooltip_context">
<description>
-This function is supposed to be used in a #GtkWidget::query-tooltip
-signal handler for #GtkTreeView. The @x, @y and @keyboard_tip values
+This function is supposed to be used in a ::query-tooltip
+signal handler for `GtkTreeView`. The @x, @y and @keyboard_tip values
which are received in the signal handler, should be passed to this
function without modification.
The return value indicates whether there is a tree view row at the given
-coordinates (%TRUE) or not (%FALSE) for mouse tooltips. For keyboard
-tooltips the row returned will be the cursor row. When %TRUE, then any of
+coordinates (%TRUE) or not (%FALSE) for mouse tooltips. For keyboard
+tooltips the row returned will be the cursor row. When %TRUE, then any of
@model, @path and @iter which have been provided will be set to point to
-that row and the corresponding model. @x and @y will always be converted
+that row and the corresponding model. @x and @y will always be converted
to be relative to @tree_view’s bin_window if @keyboard_tooltip is %FALSE.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="x">
@@ -87079,19 +87186,19 @@ to be relative to @tree_view’s bin_window if @keyboard_tooltip is %FALSE.
</parameter>
<parameter name="model">
<parameter_description> a pointer to
-receive a #GtkTreeModel or %NULL
+receive a `GtkTreeModel`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a pointer to receive a #GtkTreePath or %NULL
+<parameter_description> a pointer to receive a `GtkTreePath`
</parameter_description>
</parameter>
<parameter name="iter">
-<parameter_description> a pointer to receive a #GtkTreeIter or %NULL
+<parameter_description> a pointer to receive a `GtkTreeIter`
</parameter_description>
</parameter>
</parameters>
-<return> whether or not the given tooltip context points to a row.
+<return> whether or not the given tooltip context points to a row
</return>
</function>
@@ -87106,16 +87213,15 @@ The paths should be freed with gtk_tree_path_free() after use.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="start_path">
-<parameter_description> Return location for start of region,
-or %NULL.
+<parameter_description> Return location for start of region
</parameter_description>
</parameter>
<parameter name="end_path">
-<parameter_description> Return location for end of region, or %NULL.
+<parameter_description> Return location for end of region
</parameter_description>
</parameter>
</parameters>
@@ -87134,7 +87240,7 @@ scrollable area of the tree.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="visible_rect">
@@ -87156,11 +87262,11 @@ set to be GTK_TREE_VIEW_COLUMN_FIXED.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView.
+<parameter_description> A `GtkTreeView`.
</parameter_description>
</parameter>
<parameter name="column">
-<parameter_description> The #GtkTreeViewColumn to be inserted.
+<parameter_description> The `GtkTreeViewColumn` to be inserted.
</parameter_description>
</parameter>
<parameter name="position">
@@ -87174,7 +87280,7 @@ set to be GTK_TREE_VIEW_COLUMN_FIXED.
<function name="gtk_tree_view_insert_column_with_attributes">
<description>
-Creates a new #GtkTreeViewColumn and inserts it into the @tree_view at
+Creates a new `GtkTreeViewColumn` and inserts it into the @tree_view at
@position. If @position is -1, then the newly created column is inserted at
the end. The column is initialized with the attributes given. If @tree_view
has “fixed_height” mode enabled, then the new column will have its sizing
@@ -87184,7 +87290,7 @@ property set to be GTK_TREE_VIEW_COLUMN_FIXED.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="position">
@@ -87196,7 +87302,7 @@ property set to be GTK_TREE_VIEW_COLUMN_FIXED.
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> The #GtkCellRenderer
+<parameter_description> The `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="Varargs">
@@ -87210,8 +87316,8 @@ property set to be GTK_TREE_VIEW_COLUMN_FIXED.
<function name="gtk_tree_view_insert_column_with_data_func">
<description>
-Convenience function that inserts a new column into the #GtkTreeView
-with the given cell renderer and a #GtkTreeCellDataFunc to set cell renderer
+Convenience function that inserts a new column into the `GtkTreeView`
+with the given cell renderer and a `GtkTreeCellDataFunc` to set cell renderer
attributes (normally using data from the model). See also
gtk_tree_view_column_set_cell_data_func(), gtk_tree_view_column_pack_start().
If @tree_view has “fixed_height” mode enabled, then the new column will have its
@@ -87221,7 +87327,7 @@ If @tree_view has “fixed_height” mode enabled, then the new column will have
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="position">
@@ -87277,7 +87383,7 @@ gtk_tree_view_get_path_at_pos() for more information.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="x">
@@ -87289,23 +87395,23 @@ gtk_tree_view_get_path_at_pos() for more information.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> A pointer to a #GtkTreePath pointer to
-be filled in, or %NULL
+<parameter_description> A pointer to a `GtkTreePath` pointer to
+be filled in
</parameter_description>
</parameter>
<parameter name="column">
<parameter_description> A pointer to a
-#GtkTreeViewColumn pointer to be filled in, or %NULL
+`GtkTreeViewColumn` pointer to be filled in
</parameter_description>
</parameter>
<parameter name="cell_x">
<parameter_description> A pointer where the X coordinate relative to the
-cell can be placed, or %NULL
+cell can be placed
</parameter_description>
</parameter>
<parameter name="cell_y">
<parameter_description> A pointer where the Y coordinate relative to the
-cell can be placed, or %NULL
+cell can be placed
</parameter_description>
</parameter>
</parameters>
@@ -87323,7 +87429,7 @@ in @tree_view.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
@@ -87339,7 +87445,7 @@ Calls @func on all expanded rows.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="func">
@@ -87362,15 +87468,15 @@ Moves @column to be after to @base_column. If @base_column is %NULL, then
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="column">
-<parameter_description> The #GtkTreeViewColumn to be moved.
+<parameter_description> The `GtkTreeViewColumn` to be moved.
</parameter_description>
</parameter>
<parameter name="base_column">
-<parameter_description> The #GtkTreeViewColumn to be moved relative to, or %NULL.
+<parameter_description> The `GtkTreeViewColumn` to be moved relative to
</parameter_description>
</parameter>
</parameters>
@@ -87379,19 +87485,19 @@ Moves @column to be after to @base_column. If @base_column is %NULL, then
<function name="gtk_tree_view_new">
<description>
-Creates a new #GtkTreeView widget.
+Creates a new `GtkTreeView` widget.
</description>
<parameters>
</parameters>
-<return> A newly created #GtkTreeView widget.
+<return> A newly created `GtkTreeView` widget.
</return>
</function>
<function name="gtk_tree_view_new_with_model">
<description>
-Creates a new #GtkTreeView widget with the model initialized to @model.
+Creates a new `GtkTreeView` widget with the model initialized to @model.
</description>
@@ -87401,7 +87507,7 @@ Creates a new #GtkTreeView widget with the model initialized to @model.
</parameter_description>
</parameter>
</parameters>
-<return> A newly created #GtkTreeView widget.
+<return> A newly created `GtkTreeView` widget.
</return>
</function>
@@ -87413,11 +87519,11 @@ Removes @column from @tree_view.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView.
+<parameter_description> A `GtkTreeView`.
</parameter_description>
</parameter>
<parameter name="column">
-<parameter_description> The #GtkTreeViewColumn to remove.
+<parameter_description> The `GtkTreeViewColumn` to remove.
</parameter_description>
</parameter>
</parameters>
@@ -87432,15 +87538,15 @@ Activates the cell determined by @path and @column.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> The #GtkTreePath to be activated.
+<parameter_description> The `GtkTreePath` to be activated.
</parameter_description>
</parameter>
<parameter name="column">
-<parameter_description> The #GtkTreeViewColumn to be activated.
+<parameter_description> The `GtkTreeViewColumn` to be activated.
</parameter_description>
</parameter>
</parameters>
@@ -87455,11 +87561,11 @@ Returns %TRUE if the node pointed to by @path is expanded in @tree_view.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView.
+<parameter_description> A `GtkTreeView`.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> A #GtkTreePath to test expansion state.
+<parameter_description> A `GtkTreePath` to test expansion state.
</parameter_description>
</parameter>
</parameters>
@@ -87489,15 +87595,15 @@ path will be modified to reflect this change.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView.
+<parameter_description> A `GtkTreeView`.
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> The path of the row to move to, or %NULL.
+<parameter_description> The path of the row to move to
</parameter_description>
</parameter>
<parameter name="column">
-<parameter_description> The #GtkTreeViewColumn to move horizontally to, or %NULL.
+<parameter_description> The `GtkTreeViewColumn` to move horizontally to
</parameter_description>
</parameter>
<parameter name="use_align">
@@ -87529,7 +87635,7 @@ If either @tree_x or @tree_y are -1, then that direction isn’t scrolled.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="tree_x">
@@ -87546,13 +87652,13 @@ If either @tree_x or @tree_y are -1, then that direction isn’t scrolled.
<function name="gtk_tree_view_set_activate_on_single_click">
<description>
-Cause the #GtkTreeView::row-activated signal to be emitted
+Cause the `GtkTreeView`::row-activated signal to be emitted
on a single click instead of a double click.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="single">
@@ -87568,9 +87674,9 @@ on a single click instead of a double click.
Sets a user function for determining where a column may be dropped when
dragged. This function is called on every column pair in turn at the
beginning of a column drag to determine where a drop can take place. The
-arguments passed to @func are: the @tree_view, the #GtkTreeViewColumn being
-dragged, the two #GtkTreeViewColumn s determining the drop spot, and
-@user_data. If either of the #GtkTreeViewColumn arguments for the drop spot
+arguments passed to @func are: the @tree_view, the `GtkTreeViewColumn` being
+dragged, the two `GtkTreeViewColumn`s determining the drop spot, and
+@user_data. If either of the `GtkTreeViewColumn` arguments for the drop spot
are %NULL, then they indicate an edge. If @func is set to be %NULL, then
@tree_view reverts to the default behavior of allowing all columns to be
dropped everywhere.
@@ -87578,19 +87684,19 @@ dropped everywhere.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView.
+<parameter_description> A `GtkTreeView`.
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> A function to determine which columns are reorderable, or %NULL.
+<parameter_description> A function to determine which columns are reorderable
</parameter_description>
</parameter>
<parameter name="user_data">
-<parameter_description> User data to be passed to @func, or %NULL
+<parameter_description> User data to be passed to @func
</parameter_description>
</parameter>
<parameter name="destroy">
-<parameter_description> Destroy notifier for @user_data, or %NULL
+<parameter_description> Destroy notifier for @user_data
</parameter_description>
</parameter>
</parameters>
@@ -87614,15 +87720,15 @@ and the function will return without failing.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> A #GtkTreePath
+<parameter_description> A `GtkTreePath`
</parameter_description>
</parameter>
<parameter name="focus_column">
-<parameter_description> A #GtkTreeViewColumn, or %NULL
+<parameter_description> A `GtkTreeViewColumn`
</parameter_description>
</parameter>
<parameter name="start_editing">
@@ -87653,19 +87759,19 @@ and the function will return without failing.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> A #GtkTreePath
+<parameter_description> A `GtkTreePath`
</parameter_description>
</parameter>
<parameter name="focus_column">
-<parameter_description> A #GtkTreeViewColumn, or %NULL
+<parameter_description> A `GtkTreeViewColumn`
</parameter_description>
</parameter>
<parameter name="focus_cell">
-<parameter_description> A #GtkCellRenderer, or %NULL
+<parameter_description> A `GtkCellRenderer`
</parameter_description>
</parameter>
<parameter name="start_editing">
@@ -87684,11 +87790,11 @@ If @path is %NULL, an existing highlight is removed.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> The path of the row to highlight, or %NULL
+<parameter_description> The path of the row to highlight
</parameter_description>
</parameter>
<parameter name="pos">
@@ -87710,7 +87816,7 @@ using the “start-interactive-search” key binding.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="enable_search">
@@ -87729,7 +87835,7 @@ This does not have any visible effects for lists.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="enabled">
@@ -87752,7 +87858,7 @@ expander column to a hidden column.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="column">
@@ -87766,7 +87872,7 @@ expander column to a hidden column.
<function name="gtk_tree_view_set_fixed_height_mode">
<description>
Enables or disables the fixed height mode of @tree_view.
-Fixed height mode speeds up #GtkTreeView by assuming that all
+Fixed height mode speeds up `GtkTreeView` by assuming that all
rows have the same height.
Only enable this option if all rows are the same height and all
columns are of type %GTK_TREE_VIEW_COLUMN_FIXED.
@@ -87774,7 +87880,7 @@ columns are of type %GTK_TREE_VIEW_COLUMN_FIXED.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="enable">
@@ -87792,11 +87898,11 @@ Sets which grid lines to draw in @tree_view.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="grid_lines">
-<parameter_description> a #GtkTreeViewGridLines value indicating which grid lines to
+<parameter_description> a `GtkTreeView`GridLines value indicating which grid lines to
enable.
</parameter_description>
</parameter>
@@ -87811,7 +87917,7 @@ Allow the column title buttons to be clicked.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView.
+<parameter_description> A `GtkTreeView`.
</parameter_description>
</parameter>
<parameter name="setting">
@@ -87829,7 +87935,7 @@ Sets the visibility state of the headers.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView.
+<parameter_description> A `GtkTreeView`.
</parameter_description>
</parameter>
<parameter name="headers_visible">
@@ -87849,7 +87955,7 @@ moves over them.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="expand">
@@ -87870,7 +87976,7 @@ Currently, this works only for the selection modes
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="hover">
@@ -87892,7 +87998,7 @@ This does not have any visible effects for lists.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="indentation">
@@ -87905,14 +88011,14 @@ This does not have any visible effects for lists.
<function name="gtk_tree_view_set_model">
<description>
-Sets the model for a #GtkTreeView. If the @tree_view already has a model
+Sets the model for a `GtkTreeView`. If the @tree_view already has a model
set, it will remove it before setting the new model. If @model is %NULL,
then it will unset the old model.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView.
+<parameter_description> A `GtkTreeView`.
</parameter_description>
</parameter>
<parameter name="model">
@@ -87926,12 +88032,12 @@ then it will unset the old model.
<function name="gtk_tree_view_set_reorderable">
<description>
This function is a convenience function to allow you to reorder
-models that support the #GtkTreeDragSourceIface and the
-#GtkTreeDragDestIface. Both #GtkTreeStore and #GtkListStore support
+models that support the `GtkTreeDragSourceIface` and the
+`GtkTreeDragDestIface`. Both `GtkTreeStore` and `GtkListStore` support
these. If @reorderable is %TRUE, then the user can reorder the
model by dragging and dropping rows. The developer can listen to
-these changes by connecting to the model’s #GtkTreeModel::row-inserted
-and #GtkTreeModel::row-deleted signals. The reordering is implemented
+these changes by connecting to the model’s `GtkTreeModel::row-inserted`
+and `GtkTreeModel::row-deleted` signals. The reordering is implemented
by setting up the tree view as a drag source and destination.
Therefore, drag and drop can not be used in a reorderable view for any
other purpose.
@@ -87943,7 +88049,7 @@ handle drag and drop manually.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView.
+<parameter_description> A `GtkTreeView`.
</parameter_description>
</parameter>
<parameter name="reorderable">
@@ -87963,19 +88069,19 @@ function is %NULL, no separators are drawn. This is the default value.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="func">
-<parameter_description> a #GtkTreeViewRowSeparatorFunc
+<parameter_description> a `GtkTreeView`RowSeparatorFunc
</parameter_description>
</parameter>
<parameter name="data">
-<parameter_description> user data to pass to @func, or %NULL
+<parameter_description> user data to pass to @func
</parameter_description>
</parameter>
<parameter name="destroy">
-<parameter_description> destroy notifier for @data, or %NULL
+<parameter_description> destroy notifier for @data
</parameter_description>
</parameter>
</parameters>
@@ -87985,13 +88091,13 @@ function is %NULL, no separators are drawn. This is the default value.
<function name="gtk_tree_view_set_rubber_banding">
<description>
Enables or disables rubber banding in @tree_view. If the selection mode
-is #GTK_SELECTION_MULTIPLE, rubber banding will allow the user to select
+is %GTK_SELECTION_MULTIPLE, rubber banding will allow the user to select
multiple rows by dragging the mouse.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="enable">
@@ -88017,7 +88123,7 @@ column is reset to -1 when the model is changed.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="column">
@@ -88039,11 +88145,11 @@ entry again.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="entry">
-<parameter_description> the entry the interactive search code of @tree_view should use or %NULL
+<parameter_description> the entry the interactive search code of @tree_view should use
</parameter_description>
</parameter>
</parameters>
@@ -88054,12 +88160,12 @@ entry again.
<description>
Sets the compare function for the interactive search capabilities; note
that somewhat like strcmp() returning 0 for equality
-#GtkTreeViewSearchEqualFunc returns %FALSE on matches.
+`GtkTreeView`SearchEqualFunc returns %FALSE on matches.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> A #GtkTreeView
+<parameter_description> A `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="search_equal_func">
@@ -88067,11 +88173,11 @@ that somewhat like strcmp() returning 0 for equality
</parameter_description>
</parameter>
<parameter name="search_user_data">
-<parameter_description> user data to pass to @search_equal_func, or %NULL
+<parameter_description> user data to pass to @search_equal_func
</parameter_description>
</parameter>
<parameter name="search_destroy">
-<parameter_description> Destroy notifier for @search_user_data, or %NULL
+<parameter_description> Destroy notifier for @search_user_data
</parameter_description>
</parameter>
</parameters>
@@ -88091,7 +88197,7 @@ This does not have any visible effects for lists.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="enabled">
@@ -88119,23 +88225,23 @@ See also gtk_tree_view_set_tooltip_column() for a simpler alternative.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="tooltip">
-<parameter_description> a #GtkTooltip
+<parameter_description> a `GtkTooltip`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath or %NULL
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
<parameter name="column">
-<parameter_description> a #GtkTreeViewColumn or %NULL
+<parameter_description> a `GtkTreeViewColumn`
</parameter_description>
</parameter>
<parameter name="cell">
-<parameter_description> a #GtkCellRenderer or %NULL
+<parameter_description> a `GtkCellRenderer`
</parameter_description>
</parameter>
</parameters>
@@ -88145,12 +88251,12 @@ See also gtk_tree_view_set_tooltip_column() for a simpler alternative.
<function name="gtk_tree_view_set_tooltip_column">
<description>
If you only plan to have simple (text-only) tooltips on full rows, you
-can use this function to have #GtkTreeView handle these automatically
+can use this function to have `GtkTreeView` handle these automatically
for you. @column should be set to the column in @tree_view’s model
containing the tooltip texts, or -1 to disable this feature.
-When enabled, #GtkWidget:has-tooltip will be set to %TRUE and
-@tree_view will connect a #GtkWidget::query-tooltip signal handler.
+When enabled, `GtkWidget:has-tooltip` will be set to %TRUE and
+@tree_view will connect a `GtkWidget::query-tooltip` signal handler.
Note that the signal handler sets the text with gtk_tooltip_set_markup(),
so &, <, etc have to be escaped in the text.
@@ -88158,7 +88264,7 @@ so &, <, etc have to be escaped in the text.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="column">
@@ -88178,15 +88284,15 @@ See also gtk_tooltip_set_tip_area().
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
<parameter name="tooltip">
-<parameter_description> a #GtkTooltip
+<parameter_description> a `GtkTooltip`
</parameter_description>
</parameter>
<parameter name="path">
-<parameter_description> a #GtkTreePath
+<parameter_description> a `GtkTreePath`
</parameter_description>
</parameter>
</parameters>
@@ -88197,12 +88303,12 @@ See also gtk_tooltip_set_tip_area().
<description>
Undoes the effect of
gtk_tree_view_enable_model_drag_dest(). Calling this method sets
-#GtkTreeView:reorderable to %FALSE.
+`GtkTreeView`:reorderable to %FALSE.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
@@ -88213,12 +88319,12 @@ gtk_tree_view_enable_model_drag_dest(). Calling this method sets
<description>
Undoes the effect of
gtk_tree_view_enable_model_drag_source(). Calling this method sets
-#GtkTreeView:reorderable to %FALSE.
+`GtkTreeView`:reorderable to %FALSE.
</description>
<parameters>
<parameter name="tree_view">
-<parameter_description> a #GtkTreeView
+<parameter_description> a `GtkTreeView`
</parameter_description>
</parameter>
</parameters>
@@ -88699,18 +88805,18 @@ gtk_widget_class_install_action().
<function name="gtk_widget_activate">
<description>
-For widgets that can be “activated” (buttons, menu items, etc.)
+For widgets that can be “activated” (buttons, menu items, etc.),
this function activates them.
The activation will emit the signal set using
-gtk_widget_class_set_activate_signal() during class initialization.
+[method@Gtk.WidgetClass.set_activate_signal] during class initialization.
-Activation is what happens when you press Enter on a widget during
-key navigation.
+Activation is what happens when you press <kbd>Enter</kbd>
+on a widget during key navigation.
If you wish to handle the activation keybinding yourself, it is
-recommended to use gtk_widget_class_add_shortcut() with an action
-created with gtk_signal_action_new().
+recommended to use [method@Gtk.WidgetClass.add_shortcut] with an action
+created with [ctor Gtk SignalAction new].
If @widget isn't activatable, the function returns %FALSE.
@@ -88785,7 +88891,7 @@ as returned by `g_action_get_parameter_type()`.
</parameter_description>
</parameter>
<parameter name="args">
-<parameter_description> parameters to use, or %NULL
+<parameter_description> parameters to use
</parameter_description>
</parameter>
</parameters>
@@ -88822,7 +88928,7 @@ creating any kind of [class@Gtk.EventController].
</parameter_description>
</parameter>
<parameter name="controller">
-<parameter_description> a #GtkEventController that hasn't been
+<parameter_description> a `GtkEventController` that hasn't been
added to a widget yet
</parameter_description>
</parameter>
@@ -88862,8 +88968,7 @@ Adds a widget to the list of mnemonic labels for this widget.
See [method@Gtk.Widget.list_mnemonic_labels]. Note the
list of mnemonic labels for the widget is cleared when the
widget is destroyed, so the caller must make sure to update
-its internal state at this point as well, by using a connection
-to the [signal@Gtk.Widget::destroy] signal or a weak notifier.
+its internal state at this point as well.
</description>
<parameters>
@@ -88881,8 +88986,8 @@ to the [signal@Gtk.Widget::destroy] signal or a weak notifier.
<function name="gtk_widget_add_surface_transform_changed_callback">
<description>
-Invokes the callback whenever the surface relative transform of the widget
-changes.
+Invokes the callback whenever the surface relative transform of
+the widget changes.
</description>
@@ -88904,8 +89009,8 @@ changes.
</parameter_description>
</parameter>
</parameters>
-<return> an id for the connection of this callback. Remove the callback by
-passing the id returned from this function to
+<return> an id for the connection of this callback. Remove the
+callback by passing the id returned from this function to
[method@Gtk.Widget.remove_surface_transform_changed_callback]
</return>
</function>
@@ -88922,7 +89027,7 @@ reason, is most suitable for handling graphics that change every
frame or every few frames. The tick callback does not automatically
imply a relayout or repaint. If you want a repaint or relayout, and
aren’t changing widget properties that would trigger that (for example,
-changing the text of a #GtkLabel), then you will have to call
+changing the text of a `GtkLabel`), then you will have to call
[method@Gtk.Widget.queue_resize] or [method@Gtk.Widget.queue_draw]
yourself.
@@ -89048,9 +89153,9 @@ The arguments and format string must be provided in the same way as
with g_variant_new().
This function is a convenience wrapper around
-gtk_widget_class_add_shortcut() and must be called during class
+[method@Gtk.WidgetClass.add_shortcut] and must be called during class
initialization. It does not provide for user_data, if you need that,
-you will have to use gtk_widget_class_add_shortcut() with a custom
+you will have to use [method@GtkWidgetClass.add_shortcut] with a custom
shortcut.
</description>
@@ -89072,12 +89177,12 @@ shortcut.
</parameter_description>
</parameter>
<parameter name="format_string">
-<parameter_description> GVariant format string for arguments or %NULL for
-no arguments
+<parameter_description> GVariant format string for arguments
+or %NULL for no arguments
</parameter_description>
</parameter>
<parameter name="Varargs">
-<parameter_description> arguments, as given by format string.
+<parameter_description> arguments, as given by format string
</parameter_description>
</parameter>
</parameters>
@@ -89093,7 +89198,7 @@ The arguments and format string must be provided in the same way as
with g_variant_new().
This function is a convenience wrapper around
-gtk_widget_class_add_shortcut() and must be called during class
+[method@Gtk.WidgetClass.add_shortcut] and must be called during class
initialization.
</description>
@@ -89115,12 +89220,12 @@ initialization.
</parameter_description>
</parameter>
<parameter name="format_string">
-<parameter_description> GVariant format string for arguments or %NULL for
-no arguments
+<parameter_description> GVariant format string for arguments
+or %NULL for no arguments
</parameter_description>
</parameter>
<parameter name="Varargs">
-<parameter_description> arguments, as given by format string.
+<parameter_description> arguments, as given by format string
</parameter_description>
</parameter>
</parameters>
@@ -89136,7 +89241,7 @@ The arguments and format string must be provided in the same way as
with g_variant_new().
This function is a convenience wrapper around
-gtk_widget_class_add_shortcut() and must be called during class
+[method@Gtk.WidgetClass.add_shortcut] and must be called during class
initialization.
</description>
@@ -89158,12 +89263,12 @@ initialization.
</parameter_description>
</parameter>
<parameter name="format_string">
-<parameter_description> GVariant format string for arguments or %NULL for
-no arguments
+<parameter_description> GVariant format string for arguments
+or %NULL for no arguments
</parameter_description>
</parameter>
<parameter name="Varargs">
-<parameter_description> arguments, as given by format string.
+<parameter_description> arguments, as given by format string
</parameter_description>
</parameter>
</parameters>
@@ -89190,7 +89295,7 @@ otherwise it is not guaranteed that the shortcut will be installed.
</parameter_description>
</parameter>
<parameter name="shortcut">
-<parameter_description> the #GtkShortcut to add
+<parameter_description> the `GtkShortcut` to add
</parameter_description>
</parameter>
</parameters>
@@ -89209,7 +89314,7 @@ on @widget_class.
</description>
<parameters>
<parameter name="widget_class">
-<parameter_description> a #GtkWidgetClass
+<parameter_description> a `GtkWidgetClass`
</parameter_description>
</parameter>
<parameter name="callback">
@@ -89262,7 +89367,7 @@ instance structure.
</description>
<parameters>
<parameter name="widget_class">
-<parameter_description> a #GtkWidgetClass
+<parameter_description> a `GtkWidgetClass`
</parameter_description>
</parameter>
<parameter name="TypeName">
@@ -89279,8 +89384,8 @@ instance structure.
<function name="gtk_widget_class_bind_template_child_full">
<description>
-Automatically assign an object declared in the class template XML to be
-set to a location on a freshly built instance’s private data, or
+Automatically assign an object declared in the class template XML to
+be set to a location on a freshly built instance’s private data, or
alternatively accessible via [method@Gtk.Widget.get_template_child].
The struct can point either into the public instance, then you should
@@ -89324,8 +89429,9 @@ when this class is used in GtkBuilder XML
</parameter_description>
</parameter>
<parameter name="struct_offset">
-<parameter_description> The structure offset into the composite widget’s instance public or private structure
-where the automated child pointer should be set, or 0 to not assign the pointer.
+<parameter_description> The structure offset into the composite widget’s instance
+public or private structure where the automated child pointer should be set,
+or 0 to not assign the pointer.
</parameter_description>
</parameter>
</parameters>
@@ -89347,7 +89453,7 @@ instance structure.
</description>
<parameters>
<parameter name="widget_class">
-<parameter_description> a #GtkWidgetClass
+<parameter_description> a `GtkWidgetClass`
</parameter_description>
</parameter>
<parameter name="TypeName">
@@ -89377,7 +89483,7 @@ private data structure.
</description>
<parameters>
<parameter name="widget_class">
-<parameter_description> a #GtkWidgetClass
+<parameter_description> a `GtkWidgetClass`
</parameter_description>
</parameter>
<parameter name="TypeName">
@@ -89406,7 +89512,7 @@ must be added with G_ADD_PRIVATE()).
</description>
<parameters>
<parameter name="widget_class">
-<parameter_description> a #GtkWidgetClass
+<parameter_description> a `GtkWidgetClass`
</parameter_description>
</parameter>
<parameter name="TypeName">
@@ -89444,8 +89550,10 @@ See also: [method@Gtk.Accessible.get_accessible_role].
<function name="gtk_widget_class_get_activate_signal">
<description>
-Retrieves the signal id for the activation signal set using
-gtk_widget_class_set_activate_signal().
+Retrieves the signal id for the activation signal.
+
+the activation signal is set using
+[method@Gtk.WidgetClass.set_activate_signal].
</description>
@@ -89464,7 +89572,7 @@ specify an activation signal
<description>
Gets the name used by this class for matching in CSS code.
-See gtk_widget_class_set_css_name() for details.
+See [method@Gtk.WidgetClass.set_css_name] for details.
</description>
@@ -89481,9 +89589,9 @@ See gtk_widget_class_set_css_name() for details.
<function name="gtk_widget_class_get_layout_manager_type">
<description>
Retrieves the type of the [class@Gtk.LayoutManager]
-used by the `GtkWidget` class.
+used by widgets of class @widget_class.
-See also: gtk_widget_class_set_layout_manager_type()
+See also: [method@Gtk.WidgetClass.set_layout_manager_type].
</description>
@@ -89516,7 +89624,7 @@ they have is whether they are enabled or not.
</parameter_description>
</parameter>
<parameter name="parameter_type">
-<parameter_description> the parameter type, or %NULL
+<parameter_description> the parameter type
</parameter_description>
</parameter>
<parameter name="activate">
@@ -89566,9 +89674,11 @@ or any parent class.
<function name="gtk_widget_class_query_action">
<description>
-Queries the actions that have been installed for
-a widget class using [method@Gtk.WidgetClass.install_action]
-during class initialization.
+Returns details about the @index_-th action that has been
+installed for @widget_class during class initialization.
+
+See [method@Gtk.WidgetClass.install_action] for details on
+how to install actions.
Note that this function will also return actions defined
by parent classes. You can identify those by looking
@@ -89602,8 +89712,8 @@ at @owner.
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the action was found,
-%FALSE if @index_ is out of range
+<return> %TRUE if the action was found, %FALSE if @index_
+is out of range
</return>
</function>
@@ -89630,11 +89740,12 @@ rendered differently by assistive technologies.
<function name="gtk_widget_class_set_activate_signal">
<description>
-Sets the GtkWidgetClass.activate_signal field with the
-given @signal_id; the signal will be emitted when calling
-gtk_widget_activate().
+Sets the `GtkWidgetClass.activate_signal` field with the
+given @signal_id.
+
+The signal will be emitted when calling [method@Gtk.Widget.activate].
-The @signal_id must have been registered with g_signal_new()
+The @signal_id must have been registered with `g_signal_new()`
or g_signal_newv() before calling this function.
</description>
@@ -89653,9 +89764,10 @@ or g_signal_newv() before calling this function.
<function name="gtk_widget_class_set_activate_signal_from_name">
<description>
-Sets the GtkWidgetClass.activate_signal field with the signal id for
-the given @signal_name; the signal will be emitted when calling
-gtk_widget_activate().
+Sets the `GtkWidgetClass.activate_signal` field with the signal id for
+the given @signal_name.
+
+The signal will be emitted when calling [method@Gtk.Widget.activate].
The @signal_name of @widget_type must have been registered with
g_signal_new() or g_signal_newv() before calling this function.
@@ -89698,8 +89810,8 @@ uses the name "widget".
<function name="gtk_widget_class_set_layout_manager_type">
<description>
-Sets the type to be used for creating layout managers for widgets of
-@widget_class.
+Sets the type to be used for creating layout managers for
+widgets of @widget_class.
The given @type must be a subtype of [class@Gtk.LayoutManager].
@@ -89739,7 +89851,7 @@ Note that any class that installs templates must call
</parameter_description>
</parameter>
<parameter name="template_bytes">
-<parameter_description> A #GBytes holding the #GtkBuilder XML
+<parameter_description> A `GBytes` holding the `GtkBuilder` XML
</parameter_description>
</parameter>
</parameters>
@@ -89776,7 +89888,7 @@ For use in language bindings, this will override the default
this class’s template data.
Note that this must be called from a composite widget classes class
-initializer after calling gtk_widget_class_set_template().
+initializer after calling [method@GtkWidgetClass.set_template].
</description>
<parameters>
@@ -89920,6 +90032,10 @@ In this case, 0 is stored in @out_point.
Computes a matrix suitable to describe a transformation from
@widget's coordinate system into @target's coordinate system.
+The transform can not be computed in certain cases, for example
+when @widget and @target do not share a common ancestor. In that
+case @out_transform gets set to the identity matrix.
+
</description>
<parameters>
@@ -89937,10 +90053,7 @@ store the final transformation
</parameter_description>
</parameter>
</parameters>
-<return> %TRUE if the transform could be computed, %FALSE otherwise.
-The transform can not be computed in certain cases, for example when
-@widget and @target do not share a common ancestor. In that
-case @out_transform gets set to the identity matrix.
+<return> %TRUE if the transform could be computed, %FALSE otherwise
</return>
</function>
@@ -90010,7 +90123,7 @@ of the [property@Gtk.Widget:root] property on the widget.
</parameter_description>
</parameter>
<parameter name="text">
-<parameter_description> text to set on the layout (can be %NULL)
+<parameter_description> text to set on the layout
</parameter_description>
</parameter>
</parameters>
@@ -90147,8 +90260,7 @@ considers @widget to be an ancestor of itself.
</parameter_description>
</parameter>
</parameters>
-<return> the ancestor widget,
-or %NULL if not found
+<return> the ancestor widget
</return>
</function>
@@ -90227,7 +90339,7 @@ realized yet.
</parameter_description>
</parameter>
</parameters>
-<return> the appropriate clipboard object.
+<return> the appropriate clipboard object
</return>
</function>
@@ -90245,7 +90357,7 @@ Returns the list of style classes applied to @widget.
</parameters>
<return> a %NULL-terminated list of
css classes currently applied to @widget. The returned
-list can be freed using g_strfreev().
+list must freed using g_strfreev().
</return>
</function>
@@ -90280,7 +90392,7 @@ See [method@Gtk.Widget.set_cursor] for details.
</parameter>
</parameters>
<return> the cursor
-currently in use or %NULL to use the default.
+currently in use or %NULL if the cursor is inherited
</return>
</function>
@@ -90372,7 +90484,7 @@ Returns the current focus child of @widget.
</parameter>
</parameters>
<return> The current focus
-child of @widget, or %NULL in case the focus child is unset.
+child of @widget
</return>
</function>
@@ -90428,16 +90540,15 @@ See [method@Gtk.Widget.set_font_map].
</parameter_description>
</parameter>
</parameters>
-<return> A `PangoFontMap`, or %NULL
+<return> A `PangoFontMap`
</return>
</function>
<function name="gtk_widget_get_font_options">
<description>
-Returns the `cairo_font_options_t` used for Pango rendering.
+Returns the `cairo_font_options_t` of widget.
-When not set, the defaults font options for the `GdkDisplay`
-will be used.
+Seee [method@Gtk.Widget.set_font_options].
</description>
@@ -90448,7 +90559,7 @@ will be used.
</parameter>
</parameters>
<return> the `cairo_font_options_t`
-or %NULL if not set
+of widget
</return>
</function>
@@ -90485,8 +90596,7 @@ Unrealized widgets do not have a frame clock.
</parameter_description>
</parameter>
</parameters>
-<return> a `GdkFrameClock`,
-or %NULL if widget is unrealized
+<return> a `GdkFrameClock`
</return>
</function>
@@ -90531,9 +90641,9 @@ Returns the current value of the `has-tooltip` property.
<description>
Returns the content height of the widget.
-This function returns the size passed to its
-size-allocate implementation, which is the size you
-should be using in GtkWidgetClass.snapshot().
+This function returns the height passed to its
+size-allocate implementation, which is the height you
+should be using in [vfunc@Gtk.Widget.snapshot].
For pointer events, see [method@Gtk.Widget.contains].
@@ -90625,7 +90735,7 @@ This API is primarily meant for widget implementations.
<function name="gtk_widget_get_layout_manager">
<description>
-Retrieves the layout manager used by @widget
+Retrieves the layout manager used by @widget.
See [method@Gtk.Widget.set_layout_manager].
@@ -90742,7 +90852,7 @@ should not be modified or freed
<function name="gtk_widget_get_native">
<description>
-Returns the `GtkNative` widget that contains @widget.
+Returns the nearest `GtkNative` ancestor of @widget.
This function will return %NULL if the widget is not
contained inside a widget tree with a native ancestor.
@@ -90757,8 +90867,7 @@ contained inside a widget tree with a native ancestor.
</parameter_description>
</parameter>
</parameters>
-<return> the `GtkNative`
-widget of @widget, or %NULL
+<return> the `GtkNative` ancestor of @widget
</return>
</function>
@@ -90850,8 +90959,7 @@ Returns the parent widget of @widget.
</parameter_description>
</parameter>
</parameters>
-<return> the parent widget of @widget,
-or %NULL
+<return> the parent widget of @widget
</return>
</function>
@@ -90879,11 +90987,11 @@ Use [id@gtk_widget_measure] if you want to support baseline alignment.
</parameter_description>
</parameter>
<parameter name="minimum_size">
-<parameter_description> location for storing the minimum size, or %NULL
+<parameter_description> location for storing the minimum size
</parameter_description>
</parameter>
<parameter name="natural_size">
-<parameter_description> location for storing the natural size, or %NULL
+<parameter_description> location for storing the natural size
</parameter_description>
</parameter>
</parameters>
@@ -90926,7 +91034,7 @@ realized yet.
</parameter_description>
</parameter>
</parameters>
-<return> the appropriate clipboard object.
+<return> the appropriate clipboard object
</return>
</function>
@@ -91006,8 +91114,7 @@ inside a widget tree with a root widget.
</parameter_description>
</parameter>
</parameters>
-<return> the root widget of @widget,
-or %NULL
+<return> the root widget of @widget
</return>
</function>
@@ -91063,7 +91170,7 @@ Gets the settings object holding the settings used for this widget.
Note that this function can only be called when the `GtkWidget`
is attached to a toplevel, since the settings object is specific
to a particular `GdkDisplay`. If you want to monitor the widget for
-changes in its settings, connect to notify::display.
+changes in its settings, connect to the `notify::display` signal.
</description>
@@ -91073,7 +91180,7 @@ changes in its settings, connect to notify::display.
</parameter_description>
</parameter>
</parameters>
-<return> the relevant #GtkSettings object
+<return> the relevant `GtkSettings` object
</return>
</function>
@@ -91124,11 +91231,11 @@ this function.
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> return location for width, or %NULL
+<parameter_description> return location for width
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> return location for height, or %NULL
+<parameter_description> return location for height
</parameter_description>
</parameter>
</parameters>
@@ -91174,8 +91281,7 @@ for the lifetime of @widget.
</parameter_description>
</parameter>
</parameters>
-<return> a `GtkStyleContext`. This memory
-is owned by @widget and must not be freed.
+<return> the widgets `GtkStyleContext`
</return>
</function>
@@ -91200,7 +91306,7 @@ bindings which cannot easily make use of the GObject structure offsets.
</parameter_description>
</parameter>
<parameter name="widget_type">
-<parameter_description> The #GType to get a template child for
+<parameter_description> The `GType` to get a template child for
</parameter_description>
</parameter>
<parameter name="name">
@@ -91336,9 +91442,9 @@ See [method@Gtk.Widget.set_visible].
<description>
Returns the content width of the widget.
-This function returns the size passed to its
-size-allocate implementation, which is the size you
-should be using in GtkWidgetClass.snapshot().
+This function returns the width passed to its
+size-allocate implementation, which is the width you
+should be using in [vfunc@Gtk.Widget.snapshot].
For pointer events, see [method@Gtk.Widget.contains].
@@ -91358,9 +91464,9 @@ For pointer events, see [method@Gtk.Widget.contains].
<description>
Causes @widget to have the keyboard focus for the `GtkWindow` it's inside.
-If @widget is not focusable, or its ::grab_focus implementation cannot
-transfer the focus to a descendant of @widget that is focusable, it will
-not take focus and %FALSE will be returned.
+If @widget is not focusable, or its [vfunc@Gtk.Widget.grab_focus]
+implementation cannot transfer the focus to a descendant of @widget
+that is focusable, it will not take focus and %FALSE will be returned.
Calling [method@Gtk.Widget.grab_focus] on an already focused widget
is allowed, should not have an effect, and return %TRUE.
@@ -91557,7 +91663,8 @@ removed from @widget.
</parameter_description>
</parameter>
<parameter name="group">
-<parameter_description> a #GActionGroup, or %NULL
+<parameter_description> a `GActionGroup`, or %NULL to remove
+the previously inserted group for @name
</parameter_description>
</parameter>
</parameters>
@@ -91592,7 +91699,7 @@ just using a widget, you *must* use its own API for adding children.
</parameter_description>
</parameter>
<parameter name="previous_sibling">
-<parameter_description> the new previous sibling of @widget or %NULL
+<parameter_description> the new previous sibling of @widget
</parameter_description>
</parameter>
</parameters>
@@ -91626,7 +91733,7 @@ just using a widget, you *must* use its own API for adding children.
</parameter_description>
</parameter>
<parameter name="next_sibling">
-<parameter_description> the new next sibling of @widget or %NULL
+<parameter_description> the new next sibling of @widget
</parameter_description>
</parameter>
</parameters>
@@ -91754,7 +91861,7 @@ keyboard navigation outside the widget, e.g. by calling
The default [signal@Gtk.Widget::keynav-failed] handler returns
%FALSE for %GTK_DIR_TAB_FORWARD and %GTK_DIR_TAB_BACKWARD.
-For the other values of #GtkDirectionType it returns %TRUE.
+For the other values of `GtkDirectionType` it returns %TRUE.
Whenever the default handler returns %TRUE, it also calls
[method@Gtk.Widget.error_bell] to notify the user of the
@@ -91837,12 +91944,12 @@ is 300, this functions will compute the minimum and natural width of @widget
if it is allocated at a height of 300 pixels.
See [GtkWidget’s geometry management section](class.Widget.html#height-for-width-geometry-management) for
-a more details on implementing #GtkWidgetClass.measure().
+a more details on implementing `GtkWidgetClass.measure()`.
</description>
<parameters>
<parameter name="widget">
-<parameter_description> A #GtkWidget instance
+<parameter_description> A `GtkWidget` instance
</parameter_description>
</parameter>
<parameter name="orientation">
@@ -91858,21 +91965,21 @@ requests can be implemented. If no size is known, -1 can be passed.
</parameter_description>
</parameter>
<parameter name="minimum">
-<parameter_description> location to store the minimum size, or %NULL
+<parameter_description> location to store the minimum size
</parameter_description>
</parameter>
<parameter name="natural">
-<parameter_description> location to store the natural size, or %NULL
+<parameter_description> location to store the natural size
</parameter_description>
</parameter>
<parameter name="minimum_baseline">
<parameter_description> location to store the baseline
-position for the minimum size, or %NULL
+position for the minimum size
</parameter_description>
</parameter>
<parameter name="natural_baseline">
<parameter_description> location to store the baseline
-position for the natural size, or %NULL
+position for the natural size
</parameter_description>
</parameter>
</parameters>
@@ -91881,7 +91988,9 @@ position for the natural size, or %NULL
<function name="gtk_widget_mnemonic_activate">
<description>
-Emits the `GtkWidget`::mnemonic-activate signal.
+Emits the ::mnemonic-activate signal.
+
+See [signal@Gtk.Widget::mnemonic-activate].
</description>
@@ -91972,7 +92081,7 @@ Creates a new widget paintable observing the given widget.
</description>
<parameters>
<parameter name="widget">
-<parameter_description> a `GtkWidget` or %NULL
+<parameter_description> a `GtkWidget`
</parameter_description>
</parameter>
</parameters>
@@ -91991,7 +92100,7 @@ Sets the widget that should be observed.
</parameter_description>
</parameter>
<parameter name="widget">
-<parameter_description> the widget to observe or %NULL
+<parameter_description> the widget to observe
</parameter_description>
</parameter>
</parameters>
@@ -92000,8 +92109,7 @@ Sets the widget that should be observed.
<function name="gtk_widget_pick">
<description>
-Finds the descendant of @widget closest
-to the screen at the point (@x, @y).
+Finds the descendant of @widget closest to the point (@x, @y).
The point must be given in widget coordinates, so (0, 0) is assumed
to be the top left of @widget's content area.
@@ -92037,13 +92145,13 @@ delivering events.
</parameter>
</parameters>
<return> The widget descendant at
-the given coordinate or %NULL if none.
+the given point
</return>
</function>
<function name="gtk_widget_queue_allocate">
<description>
-Flags the widget for a rerun of the GtkWidgetClass::size_allocate
+Flags the widget for a rerun of the [vfunc@Gtk.Widget.size_allocate]
function.
Use this function instead of [method@Gtk.Widget.queue_resize]
@@ -92085,10 +92193,10 @@ See [method@Gtk.Widget.compute_expand].
<function name="gtk_widget_queue_draw">
<description>
-Schedules this widget to be redrawn in paint phase of the
-current or the next frame.
+Schedules this widget to be redrawn in the paint phase
+of the current or the next frame.
-This means @widget's GtkWidgetClass.snapshot()
+This means @widget's [vfunc@Gtk.Widget.snapshot]
implementation will be called.
</description>
@@ -92111,9 +92219,9 @@ size request. For example, when you change the text in a
enough space for the new text.
Note that you cannot call gtk_widget_queue_resize() on a widget
-from inside its implementation of the GtkWidgetClass::size_allocate
+from inside its implementation of the [vfunc@Gtk.Widget.size_allocate]
virtual method. Calls to gtk_widget_queue_resize() from inside
-GtkWidgetClass::size_allocate will be silently ignored.
+[vfunc@Gtk.Widget.size_allocate] will be silently ignored.
This function is only for use in widget implementations.
@@ -92173,7 +92281,7 @@ are destroyed, there is normally no need to call this function.
</parameter_description>
</parameter>
<parameter name="controller">
-<parameter_description> a #GtkEventController
+<parameter_description> a `GtkEventController`
</parameter_description>
</parameter>
</parameters>
@@ -92349,7 +92457,7 @@ with its parent.
<function name="gtk_widget_set_css_classes">
<description>
-Will clear all style classes applied to @widget
+Clear all style classes applied to @widget
and replace them with @classes.
</description>
@@ -92382,8 +92490,7 @@ inherited from the parent widget.
</parameter_description>
</parameter>
<parameter name="cursor">
-<parameter_description> the new cursor or %NULL to use
-the default cursor
+<parameter_description> the new cursor
</parameter_description>
</parameter>
</parameters>
@@ -92411,8 +92518,7 @@ with a %NULL cursor.
</parameter_description>
</parameter>
<parameter name="name">
-<parameter_description> The name of the cursor or %NULL to use
-the default cursor
+<parameter_description> The name of the cursor
</parameter_description>
</parameter>
</parameters>
@@ -92469,8 +92575,6 @@ set by [func@Gtk.Widget.set_default_direction] will be used.
<description>
Set @child as the current focus child of @widget.
-The previous focus child will be unset.
-
This function is only suitable for widget implementations.
If you want a certain widget to get the input focus, call
[method@Gtk.Widget.grab_focus] on it.
@@ -92585,8 +92689,8 @@ will be used.
</parameter_description>
</parameter>
<parameter name="options">
-<parameter_description> a #cairo_font_options_t, or %NULL
-to unset any previously set default font options.
+<parameter_description> a `cairo_font_options_t`
+to unset any previously set default font options
</parameter_description>
</parameter>
</parameters>
@@ -92706,9 +92810,8 @@ for completeness and consistency.
<function name="gtk_widget_set_layout_manager">
<description>
-Sets the layout manager delegate instance that
-provides an implementation for measuring and
-allocating the children of @widget.
+Sets the layout manager delegate instance that provides an
+implementation for measuring and allocating the children of @widget.
</description>
<parameters>
@@ -93253,10 +93356,10 @@ This is a simple form of [method@Gtk.Widget.allocate].
Snapshot the a child of @widget.
When a widget receives a call to the snapshot function,
-it must send synthetic `GtkWidget`Class.snapshot() calls
+it must send synthetic [vfunc@Gtk.Widget.snapshot] calls
to all children. This function provides a convenient way
of doing this. A widget, when it receives a call to its
-`GtkWidget`Class.snapshot() function, calls
+[vfunc@Gtk.Widget.snapshot] function, calls
gtk_widget_snapshot_child() once for each child, passing in
the @snapshot the widget received.
@@ -93276,7 +93379,7 @@ This function does nothing for children that implement `GtkNative`.
</parameter_description>
</parameter>
<parameter name="snapshot">
-<parameter_description> #GtkSnapshot as passed to the widget. In particular, no
+<parameter_description> `GtkSnapshot` as passed to the widget. In particular, no
calls to gtk_snapshot_translate() or other transform calls should
have been made.
</parameter_description>
@@ -93523,8 +93626,7 @@ will display the part before the colon, otherwise after that.
</parameter_description>
</parameter>
<parameter name="layout">
-<parameter_description> a decoration layout, or %NULL to
-unset the layout
+<parameter_description> a decoration layout, or %NULL to unset the layout
</parameter_description>
</parameter>
</parameters>
@@ -93626,7 +93728,7 @@ Gets the `GtkApplication` associated with the window.
</parameter_description>
</parameter>
</parameters>
-<return> a `GtkApplication`, or %NULL
+<return> a `GtkApplication`
</return>
</function>
@@ -93693,11 +93795,11 @@ size has not been explicitly set for that dimension, so the
</parameter_description>
</parameter>
<parameter name="width">
-<parameter_description> location to store the default width, or %NULL
+<parameter_description> location to store the default width
</parameter_description>
</parameter>
<parameter name="height">
-<parameter_description> location to store the default height, or %NULL
+<parameter_description> location to store the default height
</parameter_description>
</parameter>
</parameters>
@@ -93716,8 +93818,7 @@ Returns the default widget for @window.
</parameter_description>
</parameter>
</parameters>
-<return> the default widget, or %NULL
-if there is none.
+<return> the default widget
</return>
</function>
@@ -93770,8 +93871,7 @@ not be %TRUE for the widget.
</parameter_description>
</parameter>
</parameters>
-<return> the currently focused widget,
-or %NULL if there is none.
+<return> the currently focused widget
</return>
</function>
@@ -93802,7 +93902,7 @@ If the window has no group, then the default group is returned.
</description>
<parameters>
<parameter name="window">
-<parameter_description> a `GtkWindow`, or %NULL
+<parameter_description> a `GtkWindow`
</parameter_description>
</parameter>
</parameters>
@@ -93821,7 +93921,7 @@ Since: 4.2
</description>
<parameters>
<parameter name="window">
-<parameter_description> a #GtkWindow
+<parameter_description> a `GtkWindow`
</parameter_description>
</parameter>
</parameters>
@@ -93858,8 +93958,7 @@ Returns the name of the themed icon for the window.
</parameter_description>
</parameter>
</parameters>
-<return> the icon name or %NULL if the window has
-no themed icon
+<return> the icon name
</return>
</function>
@@ -93925,9 +94024,7 @@ Retrieves the title of the window.
</parameter_description>
</parameter>
</parameters>
-<return> the title of the window, or %NULL if none has
-been set explicitly. The returned string is owned by the widget
-and must not be modified or freed.
+<return> the title of the window
</return>
</function>
@@ -93944,7 +94041,7 @@ gtk_window_set_titlebar().
</parameter_description>
</parameter>
</parameters>
-<return> the custom titlebar, or %NULL
+<return> the custom titlebar
</return>
</function>
@@ -93977,8 +94074,7 @@ Fetches the transient parent for this window.
</parameter_description>
</parameter>
</parameters>
-<return> the transient parent for this
-window, or %NULL if no transient parent has been set.
+<return> the transient parent for this window
</return>
</function>
@@ -94518,7 +94614,7 @@ presses Enter in a dialog (for example).
</parameter_description>
</parameter>
<parameter name="default_widget">
-<parameter_description> widget to be the default, or %NULL
+<parameter_description> widget to be the default
to unset the default widget for the toplevel
</parameter_description>
</parameter>
@@ -94651,7 +94747,7 @@ Since: 4.2
</description>
<parameters>
<parameter name="window">
-<parameter_description> a #GtkWindow
+<parameter_description> a `GtkWindow`
</parameter_description>
</parameter>
<parameter name="handle_menubar_accel">
@@ -94707,7 +94803,7 @@ property which is mentioned in the ICCCM.
<function name="gtk_window_set_interactive_debugging">
<description>
-Opens or closes the [interactive debugger](#interactive-debugging).
+Opens or closes the [interactive debugger](running.html#interactive-debugging).
The debugger offers access to the widget hierarchy of the application
and to useful debugging tools.
@@ -94891,7 +94987,7 @@ much as the window manager would have done on X.
</parameter_description>
</parameter>
<parameter name="parent">
-<parameter_description> parent window, or %NULL
+<parameter_description> parent window
</parameter_description>
</parameter>
</parameters>
@@ -94997,7 +95093,7 @@ Undoes the effect of a previous call to freeze_updates()
</description>
<parameters>
<parameter name="model">
-<parameter_description> a #GtkFileSystemModel
+<parameter_description> a `GtkFileSystemModel`
</parameter_description>
</parameter>
</parameters>
diff --git a/gtk/src/gtk_docs_override.xml b/gtk/src/gtk_docs_override.xml
index 864effc1..f601ab20 100644
--- a/gtk/src/gtk_docs_override.xml
+++ b/gtk/src/gtk_docs_override.xml
@@ -9,8 +9,6 @@
<substitute_type_name from="GActionGroup" to="Gio::ActionGroup" />
<substitute_type_name from="GActionMap" to="Gio::ActionMap" />
<substitute_type_name from="GMenuModel" to="Gio::MenuModel" />
-<substitute_type_name from="GType" to="GType" />
-<substitute_type_name from="GError" to="GError" />
<substitute_type_name from="GFile" to="Gio::File" />
<substitute_type_name from="GIcon" to="Gio::Icon" />
<substitute_type_name from="GPermission" to="Gio::Permission" />
@@ -22,6 +20,12 @@
<substitute_type_name from="GMountOperation" to="Gio::MountOperation" />
<substitute_type_name from="GFileError" to="Glib::FileError" />
<substitute_type_name from="GKeyFileError" to="Glib::KeyFileError" />
+<substitute_type_name from="GListModel" to="Gio::ListModel" />
+<substitute_type_name from="GDate" to="Glib::Date" />
+<substitute_type_name from="GDateTime" to="Glib::DateTime" />
+<substitute_type_name from="GFileInfo" to="Gio::FileInfo" />
+<substitute_type_name from="GValue" to="Glib::Value" />
+<substitute_type_name from="GSeekable" to="Gio::Seekable" />
<substitute_type_name from="GtkApplicationInhibitFlags" to="Gtk::Application::InhibitFlags" />
<substitute_type_name from="GtkAssistantPageType" to="Gtk::Assistant::PageType" />
<substitute_type_name from="GtkCalendarDisplayOptions" to="Gtk::Calendar::DisplayOptions" />
@@ -48,6 +52,10 @@
<substitute_type_name from="GtkAccessibleState" to="Gtk::Accessible::State" />
<substitute_type_name from="GtkAccessibleProperty" to="Gtk::Accessible::Property" />
<substitute_type_name from="GtkAccessibleRelation" to="Gtk::Accessible::Relation" />
+<!-- These have no corresponding C++ type. Don't substitute. -->
+<substitute_type_name from="GList" to="GList" />
+<substitute_type_name from="GType" to="GType" />
+<substitute_type_name from="GError" to="GError" />
<substitute_enumerator_name from_prefix="GTK_LICENSE_" to_prefix="Gtk::License::" />
<substitute_enumerator_name from_prefix="GTK_ASSISTANT_PAGE_" to_prefix="Gtk::AssistantPage::Type::" />
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
