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.
*
* 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] =
g_param_spec_object ("logo", NULL, NULL,

View File

@ -89,7 +89,7 @@
* ## GtkExpression in GObject properties
*
* 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:
*
* ```c
@ -103,8 +103,8 @@
* ```
*
* When implementing the `GObjectClass.set_property` and `GObjectClass.get_property`
* virtual functions, you must use [id@gtk_value_get_expression], to retrieve the
* stored `GtkExpression` from the `GValue` container, and [id@gtk_value_set_expression],
* virtual functions, you must use [func@Gtk.value_get_expression], to retrieve the
* stored `GtkExpression` from the `GValue` container, and [func@Gtk.value_set_expression],
* to store the `GtkExpression` into the `GValue`; for instance:
*
* ```c

View File

@ -247,7 +247,7 @@ static gboolean do_setlocale = TRUE;
/**
* 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, "")`.
*
* 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
* 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].
*
* # CSS Nodes
@ -543,7 +543,7 @@ add_arrow_bindings (GtkWidgetClass *widget_class,
GtkDirectionType direction)
{
guint keypad_keysym = keysym - GDK_KEY_Left + GDK_KEY_KP_Left;
gtk_widget_class_add_binding_signal (widget_class, keysym, 0,
"move-focus",
"(i)", direction);

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
* 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
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:
*
* 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.
* Because the preferred widths for each widget depend on the preferred
* widths of their children, this information propagates up the hierarchy,
* 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
* 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
* 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
@ -223,7 +223,7 @@
* to do it.
*
* 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
* so forth.
*
@ -240,7 +240,7 @@
*
* 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
* 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
* appears at the position.
*
@ -405,7 +405,7 @@
* ```
*
* 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
* name as the widget in the template definition, and call
* [method@Gtk.WidgetClass.bind_template_child_full] (or one of its wrapper macros