docs: Stop using C symbols as links

They are much harder for the bindings to figure out the type back from it and usually just break
This commit is contained in:
Bilal Elmoussaoui 2023-08-20 10:59:49 +02:00
parent f2578fcfb9
commit 5516ff6a02
6 changed files with 13 additions and 13 deletions

View File

@ -566,7 +566,7 @@ gtk_about_dialog_class_init (GtkAboutDialogClass *klass)
* A logo for the about box. * A logo for the about box.
* *
* If it is `NULL`, the default window icon set with * If it is `NULL`, the default window icon set with
* [id@gtk_window_set_default_icon_name] will be used. * [func@Gtk.Window.set_default_icon_name] will be used.
*/ */
props[PROP_LOGO] = props[PROP_LOGO] =
g_param_spec_object ("logo", NULL, NULL, g_param_spec_object ("logo", NULL, NULL,

View File

@ -89,7 +89,7 @@
* ## GtkExpression in GObject properties * ## GtkExpression in GObject properties
* *
* In order to use a `GtkExpression` as a `GObject` property, you must use the * In order to use a `GtkExpression` as a `GObject` property, you must use the
* [id@gtk_param_spec_expression] when creating a `GParamSpec` to install in the * [func@Gtk.param_spec_expression] when creating a `GParamSpec` to install in the
* `GObject` class being defined; for instance: * `GObject` class being defined; for instance:
* *
* ```c * ```c
@ -103,8 +103,8 @@
* ``` * ```
* *
* When implementing the `GObjectClass.set_property` and `GObjectClass.get_property` * When implementing the `GObjectClass.set_property` and `GObjectClass.get_property`
* virtual functions, you must use [id@gtk_value_get_expression], to retrieve the * virtual functions, you must use [func@Gtk.value_get_expression], to retrieve the
* stored `GtkExpression` from the `GValue` container, and [id@gtk_value_set_expression], * stored `GtkExpression` from the `GValue` container, and [func@Gtk.value_set_expression],
* to store the `GtkExpression` into the `GValue`; for instance: * to store the `GtkExpression` into the `GValue`; for instance:
* *
* ```c * ```c

View File

@ -247,7 +247,7 @@ static gboolean do_setlocale = TRUE;
/** /**
* gtk_disable_setlocale: * gtk_disable_setlocale:
* *
* Prevents [id@gtk_init] and [id@gtk_init_check] from automatically calling * Prevents [func@Gtk.init] and [func@Gtk.init_check] from automatically calling
* `setlocale (LC_ALL, "")`. * `setlocale (LC_ALL, "")`.
* *
* You would want to use this function if you wanted to set the locale for * You would want to use this function if you wanted to set the locale for

View File

@ -128,7 +128,7 @@
* *
* Menu items will also show accelerators, which are usually associated * Menu items will also show accelerators, which are usually associated
* with actions via [method@Gtk.Application.set_accels_for_action], * with actions via [method@Gtk.Application.set_accels_for_action],
* [id@gtk_widget_class_add_binding_action] or * [method@WidgetClass.add_binding_action] or
* [method@Gtk.ShortcutController.add_shortcut]. * [method@Gtk.ShortcutController.add_shortcut].
* *
* # CSS Nodes * # CSS Nodes

View File

@ -608,7 +608,7 @@ gtk_widget_get_request_mode (GtkWidget *widget)
* the required height for the natural width is generally smaller than the * the required height for the natural width is generally smaller than the
* required height for the minimum width. * required height for the minimum width.
* *
* Use [id@gtk_widget_measure] if you want to support baseline alignment. * Use [method@Gtk.Widget.measure] if you want to support baseline alignment.
*/ */
void void
gtk_widget_get_preferred_size (GtkWidget *widget, gtk_widget_get_preferred_size (GtkWidget *widget,

View File

@ -126,13 +126,13 @@
* For example, when queried in the normal %GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH mode: * For example, when queried in the normal %GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH mode:
* *
* First, the default minimum and natural width for each widget * First, the default minimum and natural width for each widget
* in the interface will be computed using [id@gtk_widget_measure] with an * in the interface will be computed using [method@Gtk.Widget.measure] with an
* orientation of %GTK_ORIENTATION_HORIZONTAL and a for_size of -1. * orientation of %GTK_ORIENTATION_HORIZONTAL and a for_size of -1.
* Because the preferred widths for each widget depend on the preferred * Because the preferred widths for each widget depend on the preferred
* widths of their children, this information propagates up the hierarchy, * widths of their children, this information propagates up the hierarchy,
* and finally a minimum and natural width is determined for the entire * and finally a minimum and natural width is determined for the entire
* toplevel. Next, the toplevel will use the minimum width to query for the * toplevel. Next, the toplevel will use the minimum width to query for the
* minimum height contextual to that width using [id@gtk_widget_measure] with an * minimum height contextual to that width using [method@Gtk.Widget.measure] with an
* orientation of %GTK_ORIENTATION_VERTICAL and a for_size of the just computed * orientation of %GTK_ORIENTATION_VERTICAL and a for_size of the just computed
* width. This will also be a highly recursive operation. The minimum height * width. This will also be a highly recursive operation. The minimum height
* for the minimum width is normally used to set the minimum size constraint * for the minimum width is normally used to set the minimum size constraint
@ -223,7 +223,7 @@
* to do it. * to do it.
* *
* Of course if you are getting the size request for another widget, such * Of course if you are getting the size request for another widget, such
* as a child widget, you must use [id@gtk_widget_measure]; otherwise, you * as a child widget, you must use [method@Gtk.Widget.measure]; otherwise, you
* would not properly consider widget margins, [class@Gtk.SizeGroup], and * would not properly consider widget margins, [class@Gtk.SizeGroup], and
* so forth. * so forth.
* *
@ -240,7 +240,7 @@
* *
* If a widget ends up baseline aligned it will be allocated all the space in * If a widget ends up baseline aligned it will be allocated all the space in
* the parent as if it was %GTK_ALIGN_FILL, but the selected baseline can be * the parent as if it was %GTK_ALIGN_FILL, but the selected baseline can be
* found via [id@gtk_widget_get_baseline]. If the baseline has a * found via [method@Gtk.Widget.get_baseline]. If the baseline has a
* value other than -1 you need to align the widget such that the baseline * value other than -1 you need to align the widget such that the baseline
* appears at the position. * appears at the position.
* *
@ -405,7 +405,7 @@
* ``` * ```
* *
* You can access widgets defined in the template using the * You can access widgets defined in the template using the
* [id@gtk_widget_get_template_child] function, but you will typically declare * [method@Gtk.Widget.get_template_child] function, but you will typically declare
* a pointer in the instance private data structure of your type using the same * a pointer in the instance private data structure of your type using the same
* name as the widget in the template definition, and call * name as the widget in the template definition, and call
* [method@Gtk.WidgetClass.bind_template_child_full] (or one of its wrapper macros * [method@Gtk.WidgetClass.bind_template_child_full] (or one of its wrapper macros