docs: Use code for class names in links

So that they fit with the documentation guidelines, and with the links
generated by gi-docgen.
This commit is contained in:
Emmanuele Bassi
2024-01-15 14:43:53 +00:00
parent 3f9f5c1420
commit b5c07063c3
10 changed files with 46 additions and 38 deletions

View File

@@ -65,22 +65,23 @@
* in sync with the property value — its state is the property value.
*
* For example, it might be useful to create a [iface@Gio.Action] corresponding
* to the `visible-child-name` property of a [GtkStack](https://docs.gtk.org/gtk4/class.Stack.html) so that the
* current page can be switched from a menu. The active radio indication in the
* menu is then directly determined from the active page of the
* `GtkStack`.
* to the `visible-child-name` property of a [`GtkStack`](https://docs.gtk.org/gtk4/class.Stack.html)
* so that the current page can be switched from a menu. The active radio
* indication in the menu is then directly determined from the active page of
* the `GtkStack`.
*
* An anti-example would be binding the `active-id` property on a
* [GtkComboBox](https://docs.gtk.org/gtk4/class.ComboBox.html). This is because the state of the combo box itself is
* probably uninteresting and is actually being used to control
* something else.
* [`GtkComboBox`](https://docs.gtk.org/gtk4/class.ComboBox.html). This is
* because the state of the combo box itself is probably uninteresting and is
* actually being used to control something else.
*
* Another anti-example would be to bind to the `visible-child-name`
* property of a [GtkStack](https://docs.gtk.org/gtk4/class.Stack.html) if this value is actually stored in
* [class@Gio.Settings]. In that case, the real source of the value is
* [class@Gio.Settings]. If you want a [iface@Gio.Action] to control a setting
* stored in [class@Gio.Settings], see [method@Gio.Settings.create_action]
* instead, and possibly combine its use with [method@Gio.Settings.bind].
* property of a [`GtkStack`](https://docs.gtk.org/gtk4/class.Stack.html) if
* this value is actually stored in [class@Gio.Settings]. In that case, the
* real source of the value is* [class@Gio.Settings]. If you want
* a [iface@Gio.Action] to control a setting stored in [class@Gio.Settings],
* see [method@Gio.Settings.create_action] instead, and possibly combine its
* use with [method@Gio.Settings.bind].
*
* Since: 2.38
**/