@gtkx/ffi 0.9.1 → 0.9.3

package/dist/generated/adw/toolbar-view.js

@@ -1,12 +1,12 @@
 import { call } from "../../batch.js";
-import { getObject } from "../../native/object.js";
+import { getNativeObject } from "../../native/object.js";
 import { isInstantiating, setInstantiating } from "../../native/base.js";
 import { registerNativeClass } from "../../registry.js";
 import * as Gtk from "../gtk/index.js";
 /**
  * A widget containing a page, as well as top and/or bottom bars.
  *
- *
+ * ![toolbar-view](https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1-latest/toolbar-view.png)
  *
  * `AdwToolbarView` has a single content widget and one or multiple top and
  * bottom bars, shown at the top and bottom sides respectively.
@@ -27,72 +27,57 @@ import * as Gtk from "../gtk/index.js";
  *
  * The following kinds of top and bottom bars are supported:
  *
- * - [class@HeaderBar]
- * - [class@TabBar]
- * - [class@ViewSwitcherBar]
- * - [class@Gtk.ActionBar]
- * - [class@Gtk.HeaderBar]
- * - [class@Gtk.PopoverMenuBar]
- * - [class@Gtk.SearchBar]
- * - Any [class@Gtk.Box] or a similar widget with the
+ * - {@link HeaderBar}
+ * - {@link TabBar}
+ * - {@link ViewSwitcherBar}
+ * - {@link Gtk.ActionBar}
+ * - {@link Gtk.HeaderBar}
+ * - {@link Gtk.PopoverMenuBar}
+ * - {@link Gtk.SearchBar}
+ * - Any {@link Gtk.Box} or a similar widget with the
  * `.toolbar` style class
  *
  * By default, top and bottom bars are flat and scrolling content has a subtle
  * undershoot shadow, same as when using the
  * `.undershoot-top` and
  * `.undershoot-bottom` style
- * classes. This works well in most cases, e.g. with [class@StatusPage] or
- * [class@PreferencesPage], where the background at the top and bottom parts of
+ * classes. This works well in most cases, e.g. with {@link StatusPage} or
+ * {@link PreferencesPage}, where the background at the top and bottom parts of
  * the page is uniform. Additionally, windows with sidebars should always use
  * this style.
  *
- * [property@ToolbarView:top-bar-style] and
- * [property@ToolbarView:bottom-bar-style] properties can be used add an opaque
+ * {@link ToolbarView.top-bar-style} and
+ * {@link ToolbarView.bottom-bar-style} properties can be used add an opaque
  * background and a persistent shadow to top and bottom bars, this can be useful
  * for content such as utility panes,
- * where some elements are adjacent to the top/bottom bars, or [class@TabView],
+ * where some elements are adjacent to the top/bottom bars, or {@link TabView},
  * where each page can have a different background.
  *
- * <picture style="min-width: 33%; display: inline-block;">
- *
- *
- * </picture>
- * <picture style="min-width: 33%; display: inline-block;">
- *
- *
- * </picture>
- * <picture style="min-width: 33%; display: inline-block;">
- *
- *
- * </picture>
+ * ![toolbar-view-flat-1](https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1-latest/toolbar-view-flat-1.png)
+ * ![toolbar-view-flat-2](https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1-latest/toolbar-view-flat-2.png)
+ * ![toolbar-view-raised](https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1-latest/toolbar-view-raised.png)
  *
  * `AdwToolbarView` ensures the top and bottom bars have consistent backdrop
  * styles and vertical spacing. For comparison:
  *
- * <picture style="min-width: 40%; display: inline-block;">
- *
- *
- * </picture>
- * <picture style="min-width: 40%; display: inline-block;">
- *
- *
- * </picture>
+ * ![toolbar-view-spacing](https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1-latest/toolbar-view-spacing.png)
+ * ![toolbar-view-spacing-box](https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1-latest/toolbar-view-spacing-box.png)
  *
  * Any top and bottom bars can also be dragged to move the window, equivalent
- * to putting them into a [class@Gtk.WindowHandle].
+ * to putting them into a {@link Gtk.WindowHandle}.
  *
  * Content is typically place between top and bottom bars, but can also extend
  * behind them. This is controlled with the
- * [property@ToolbarView:extend-content-to-top-edge] and
- * [property@ToolbarView:extend-content-to-bottom-edge] properties.
+ * {@link ToolbarView.extend-content-to-top-edge} and
+ * {@link ToolbarView.extend-content-to-bottom-edge} properties.
  *
  * Top and bottom bars can be hidden and revealed with an animation using the
- * [property@ToolbarView:reveal-top-bars] and
- * [property@ToolbarView:reveal-bottom-bars] properties.
+ * {@link ToolbarView.reveal-top-bars} and
+ * {@link ToolbarView.reveal-bottom-bars} properties.
  *
  * ## `AdwToolbarView` as `GtkBuildable`
  *
- * The `AdwToolbarView` implementation of the [iface@Gtk.Buildable] interface
+ * The `AdwToolbarView` implementation of the {@link Gtk.Buildable} interface
  * supports adding a top bar by specifying “top” as the “type” attribute of a
  * `<child>` element, or adding a bottom bar by specifying “bottom”.
  *
@@ -123,7 +108,7 @@ export class ToolbarView extends Gtk.Widget {
         }
     }
     /**
-     * Adds a bottom bar to @self.
+     * Adds a bottom bar to `self`.
      * @param widget - a widget
      */
     addBottomBar(widget) {
@@ -139,7 +124,7 @@ export class ToolbarView extends Gtk.Widget {
         ], { type: "undefined" });
     }
     /**
-     * Adds a top bar to @self.
+     * Adds a top bar to `self`.
      * @param widget - a widget
      */
     addTopBar(widget) {
@@ -155,12 +140,12 @@ export class ToolbarView extends Gtk.Widget {
         ], { type: "undefined" });
     }
     /**
-     * Gets the current bottom bar height for @self.
+     * Gets the current bottom bar height for `self`.
      *
      * Bottom bar height does change depending on
-     * [property@ToolbarView:reveal-bottom-bars], including during the transition.
+     * {@link ToolbarView.reveal-bottom-bars}, including during the transition.
      *
-     * See [method@ToolbarView.get_top_bar_height].
+     * See {@link ToolbarView.get_top_bar_height}.
      */
     getBottomBarHeight() {
         return call("libadwaita-1.so.0", "adw_toolbar_view_get_bottom_bar_height", [
@@ -171,7 +156,7 @@ export class ToolbarView extends Gtk.Widget {
         ], { type: "int", size: 32, unsigned: false });
     }
     /**
-     * Gets appearance of the bottom bars for @self.
+     * Gets appearance of the bottom bars for `self`.
      */
     getBottomBarStyle() {
         return call("libadwaita-1.so.0", "adw_toolbar_view_get_bottom_bar_style", [
@@ -182,7 +167,7 @@ export class ToolbarView extends Gtk.Widget {
         ], { type: "int", size: 32, unsigned: false });
     }
     /**
-     * Gets the content widget for @self.
+     * Gets the content widget for `self`.
      */
     getContent() {
         const ptr = call("libadwaita-1.so.0", "adw_toolbar_view_get_content", [
@@ -193,7 +178,7 @@ export class ToolbarView extends Gtk.Widget {
         ], { type: "gobject", borrowed: true });
         if (ptr === null)
             return null;
-        return getObject(ptr);
+        return getNativeObject(ptr);
     }
     /**
      * Gets whether the content widget can extend behind bottom bars.
@@ -218,7 +203,7 @@ export class ToolbarView extends Gtk.Widget {
         ], { type: "boolean" });
     }
     /**
-     * Gets whether bottom bars are revealed for @self.
+     * Gets whether bottom bars are revealed for `self`.
      */
     getRevealBottomBars() {
         return call("libadwaita-1.so.0", "adw_toolbar_view_get_reveal_bottom_bars", [
@@ -229,7 +214,7 @@ export class ToolbarView extends Gtk.Widget {
         ], { type: "boolean" });
     }
     /**
-     * Gets whether top bars are revealed for @self.
+     * Gets whether top bars are revealed for `self`.
      */
     getRevealTopBars() {
         return call("libadwaita-1.so.0", "adw_toolbar_view_get_reveal_top_bars", [
@@ -240,12 +225,12 @@ export class ToolbarView extends Gtk.Widget {
         ], { type: "boolean" });
     }
     /**
-     * Gets the current top bar height for @self.
+     * Gets the current top bar height for `self`.
      *
      * Top bar height does change depending on
-     * [property@ToolbarView:reveal-top-bars], including during the transition.
+     * {@link ToolbarView.reveal-top-bars}, including during the transition.
      *
-     * See [method@ToolbarView.get_bottom_bar_height].
+     * See {@link ToolbarView.get_bottom_bar_height}.
      */
     getTopBarHeight() {
         return call("libadwaita-1.so.0", "adw_toolbar_view_get_top_bar_height", [
@@ -256,7 +241,7 @@ export class ToolbarView extends Gtk.Widget {
         ], { type: "int", size: 32, unsigned: false });
     }
     /**
-     * Gets appearance of the top bars for @self.
+     * Gets appearance of the top bars for `self`.
      */
     getTopBarStyle() {
         return call("libadwaita-1.so.0", "adw_toolbar_view_get_top_bar_style", [
@@ -267,7 +252,7 @@ export class ToolbarView extends Gtk.Widget {
         ], { type: "int", size: 32, unsigned: false });
     }
     /**
-     * Removes a child from @self.
+     * Removes a child from `self`.
      * @param widget - the child to be removed
      */
     remove(widget) {
@@ -283,30 +268,30 @@ export class ToolbarView extends Gtk.Widget {
         ], { type: "undefined" });
     }
     /**
-     * Sets appearance of the bottom bars for @self.
+     * Sets appearance of the bottom bars for `self`.
      *
      * If set to `ADW_TOOLBAR_FLAT`, bottom bars are flat and scrolling content has
      * a subtle undershoot shadow when touching them, same as the
      * `.undershoot-bottom`
-     * style class. This works well for simple content, e.g. [class@StatusPage] or
-     * [class@PreferencesPage], where the background at the bottom of the page is
+     * style class. This works well for simple content, e.g. {@link StatusPage} or
+     * {@link PreferencesPage}, where the background at the bottom of the page is
      * uniform. Additionally, windows with sidebars should always use this style.
      *
      * Undershoot shadow is only present if a bottom bar is actually present and
      * visible. It is also never present if
-     * [property@ToolbarView:extend-content-to-bottom-edge] is set to `TRUE`.
+     * {@link ToolbarView.extend-content-to-bottom-edge} is set to `TRUE`.
      *
      * If set to `ADW_TOOLBAR_RAISED`, bottom bars have an opaque background and a
      * persistent shadow, this is suitable for content such as
      * utility panes,
      * where some elements are directly adjacent to the bottom bars, or
-     * [class@TabView], where each page can have a different background.
+     * {@link TabView}, where each page can have a different background.
      *
      * `ADW_TOOLBAR_RAISED_BORDER` is similar to `ADW_TOOLBAR_RAISED`, but the
      * shadow is replaced with a more subtle border. This can be useful for
      * applications like image viewers.
      *
-     * See also [method@ToolbarView.set_top_bar_style].
+     * See also {@link ToolbarView.set_top_bar_style}.
      * @param style - bottom bar style
      */
     setBottomBarStyle(style) {
@@ -322,7 +307,7 @@ export class ToolbarView extends Gtk.Widget {
         ], { type: "undefined" });
     }
     /**
-     * Sets the content widget for @self.
+     * Sets the content widget for `self`.
      * @param content - the content widget
      */
     setContent(content) {
@@ -341,10 +326,10 @@ export class ToolbarView extends Gtk.Widget {
     /**
      * Sets whether the content widget can extend behind bottom bars.
      *
-     * This can be used in combination with [property@ToolbarView:reveal-bottom-bars]
+     * This can be used in combination with {@link ToolbarView.reveal-bottom-bars}
      * to show and hide toolbars in fullscreen.
      *
-     * See [method@ToolbarView.set_extend_content_to_top_edge].
+     * See {@link ToolbarView.set_extend_content_to_top_edge}.
      * @param extend - whether content extends behind bottom bars
      */
     setExtendContentToBottomEdge(extend) {
@@ -362,10 +347,10 @@ export class ToolbarView extends Gtk.Widget {
     /**
      * Sets whether the content widget can extend behind top bars.
      *
-     * This can be used in combination with [property@ToolbarView:reveal-top-bars]
+     * This can be used in combination with {@link ToolbarView.reveal-top-bars}
      * to show and hide toolbars in fullscreen.
      *
-     * See [method@ToolbarView.set_extend_content_to_bottom_edge].
+     * See {@link ToolbarView.set_extend_content_to_bottom_edge}.
      * @param extend - whether content extends behind top bars
      */
     setExtendContentToTopEdge(extend) {
@@ -381,15 +366,15 @@ export class ToolbarView extends Gtk.Widget {
         ], { type: "undefined" });
     }
     /**
-     * Sets whether bottom bars are revealed for @self.
+     * Sets whether bottom bars are revealed for `self`.
      *
      * The transition will be animated.
      *
      * This can be used in combination with
-     * [property@ToolbarView:extend-content-to-bottom-edge] to show and hide
+     * {@link ToolbarView.extend-content-to-bottom-edge} to show and hide
      * toolbars in fullscreen.
      *
-     * See [method@ToolbarView.set_reveal_top_bars].
+     * See {@link ToolbarView.set_reveal_top_bars}.
      * @param reveal - whether to reveal bottom bars
      */
     setRevealBottomBars(reveal) {
@@ -405,15 +390,15 @@ export class ToolbarView extends Gtk.Widget {
         ], { type: "undefined" });
     }
     /**
-     * Sets whether top bars are revealed for @self.
+     * Sets whether top bars are revealed for `self`.
      *
      * The transition will be animated.
      *
      * This can be used in combination with
-     * [property@ToolbarView:extend-content-to-top-edge] to show and hide toolbars
+     * {@link ToolbarView.extend-content-to-top-edge} to show and hide toolbars
      * in fullscreen.
      *
-     * See [method@ToolbarView.set_reveal_bottom_bars].
+     * See {@link ToolbarView.set_reveal_bottom_bars}.
      * @param reveal - whether to reveal top bars
      */
     setRevealTopBars(reveal) {
@@ -429,30 +414,30 @@ export class ToolbarView extends Gtk.Widget {
         ], { type: "undefined" });
     }
     /**
-     * Sets appearance of the top bars for @self.
+     * Sets appearance of the top bars for `self`.
      *
      * If set to `ADW_TOOLBAR_FLAT`, top bars are flat and scrolling content has a
      * subtle undershoot shadow when touching them, same as the
      * `.undershoot-top`
-     * style class. This works well for simple content, e.g. [class@StatusPage] or
-     * [class@PreferencesPage], where the background at the top of the page is
+     * style class. This works well for simple content, e.g. {@link StatusPage} or
+     * {@link PreferencesPage}, where the background at the top of the page is
      * uniform. Additionally, windows with sidebars should always use this style.
      *
      * Undershoot shadow is only present if a top bar is actually present and
      * visible. It is also never present if
-     * [property@ToolbarView:extend-content-to-top-edge] is set to `TRUE`.
+     * {@link ToolbarView.extend-content-to-top-edge} is set to `TRUE`.
      *
      * If set to `ADW_TOOLBAR_RAISED`, top bars have an opaque background and a
      * persistent shadow, this is suitable for content such as
      * utility panes,
      * where some elements are directly adjacent to the top bars, or
-     * [class@TabView], where each page can have a different background.
+     * {@link TabView}, where each page can have a different background.
      *
      * `ADW_TOOLBAR_RAISED_BORDER` is similar to `ADW_TOOLBAR_RAISED`, but the
      * shadow is replaced with a more subtle border. This can be useful for
      * applications like image viewers.
      *
-     * See also [method@ToolbarView.set_bottom_bar_style].
+     * See also {@link ToolbarView.set_bottom_bar_style}.
      * @param style - top bar style
      */
     setTopBarStyle(style) {
@@ -472,7 +457,7 @@ export class ToolbarView extends Gtk.Widget {
         const argTypes = [selfType];
         const returnType = undefined;
         const wrappedHandler = (...args) => {
-            const self = getObject(args[0]);
+            const self = getNativeObject(args[0]);
             return handler(self, ...args.slice(1));
         };
         return call("libadwaita-1.so.0", "g_signal_connect_closure", [

package/dist/generated/adw/view-stack-page.d.ts

@@ -2,7 +2,7 @@ import { Ref } from "@gtkx/native";
 import * as Atspi from "../atspi/index.js";
 import * as GObject from "../gobject/index.js";
 import * as Gtk from "../gtk/index.js";
-/** An auxiliary class used by [class@ViewStack]. */
+/** An auxiliary class used by {@link ViewStack}. */
 export declare class ViewStackPage extends GObject.GObject {
     static readonly glibTypeName: string;
     static readonly objectType: "gobject";
@@ -38,17 +38,17 @@ export declare class ViewStackPage extends GObject.GObject {
     /**
      * Gets whether `self` is visible in its `AdwViewStack`.
      *
-     * This is independent from the [property@Gtk.Widget:visible]
+     * This is independent from the {@link Gtk.Widget.visible}
      * property of its widget.
      */
     getVisible(): boolean;
     /**
      * Sets the badge number for this page.
      *
-     * [class@ViewSwitcher] can display it as a badge next to the page icon. It is
+     * {@link ViewSwitcher} can display it as a badge next to the page icon. It is
      * commonly used to display a number of unread items within the page.
      *
-     * It can be used together with [property@ViewStack{age}:needs-attention].
+     * It can be used together with {@link ViewStack{age}.needs-attention}.
      * @param badgeNumber - the new value to set
      */
     setBadgeNumber(badgeNumber: number): void;
@@ -65,7 +65,7 @@ export declare class ViewStackPage extends GObject.GObject {
     /**
      * Sets whether the page requires the user attention.
      *
-     * [class@ViewSwitcher] will display it as a dot next to the page icon.
+     * {@link ViewSwitcher} will display it as a dot next to the page icon.
      * @param needsAttention - the new value to set
      */
     setNeedsAttention(needsAttention: boolean): void;
@@ -82,8 +82,8 @@ export declare class ViewStackPage extends GObject.GObject {
     /**
      * Sets whether `page` is visible in its `AdwViewStack`.
      *
-     * This is independent from the [property@Gtk.Widget:visible] property of
-     * [property@ViewStackPage:child].
+     * This is independent from the {@link Gtk.Widget.visible} property of
+     * {@link ViewStackPage.child}.
      * @param visible - whether `self` is visible
      */
     setVisible(visible: boolean): void;

package/dist/generated/adw/view-stack-page.js

@@ -1,9 +1,9 @@
 import { call } from "../../batch.js";
-import { getObject } from "../../native/object.js";
+import { getNativeObject } from "../../native/object.js";
 import { isInstantiating, setInstantiating } from "../../native/base.js";
 import { registerNativeClass } from "../../registry.js";
 import * as GObject from "../gobject/index.js";
-/** An auxiliary class used by [class@ViewStack]. */
+/** An auxiliary class used by {@link ViewStack}. */
 export class ViewStackPage extends GObject.GObject {
     static glibTypeName = "AdwViewStackPage";
     static objectType = "gobject";
@@ -45,7 +45,7 @@ export class ViewStackPage extends GObject.GObject {
                 value: this.id,
             },
         ], { type: "gobject", borrowed: true });
-        return getObject(ptr);
+        return getNativeObject(ptr);
     }
     /**
      * Gets the icon name of the page.
@@ -105,7 +105,7 @@ export class ViewStackPage extends GObject.GObject {
     /**
      * Gets whether `self` is visible in its `AdwViewStack`.
      *
-     * This is independent from the [property@Gtk.Widget:visible]
+     * This is independent from the {@link Gtk.Widget.visible}
      * property of its widget.
      */
     getVisible() {
@@ -119,10 +119,10 @@ export class ViewStackPage extends GObject.GObject {
     /**
      * Sets the badge number for this page.
      *
-     * [class@ViewSwitcher] can display it as a badge next to the page icon. It is
+     * {@link ViewSwitcher} can display it as a badge next to the page icon. It is
      * commonly used to display a number of unread items within the page.
      *
-     * It can be used together with [property@ViewStack{age}:needs-attention].
+     * It can be used together with {@link ViewStack{age}.needs-attention}.
      * @param badgeNumber - the new value to set
      */
     setBadgeNumber(badgeNumber) {
@@ -174,7 +174,7 @@ export class ViewStackPage extends GObject.GObject {
     /**
      * Sets whether the page requires the user attention.
      *
-     * [class@ViewSwitcher] will display it as a dot next to the page icon.
+     * {@link ViewSwitcher} will display it as a dot next to the page icon.
      * @param needsAttention - the new value to set
      */
     setNeedsAttention(needsAttention) {
@@ -225,8 +225,8 @@ export class ViewStackPage extends GObject.GObject {
     /**
      * Sets whether `page` is visible in its `AdwViewStack`.
      *
-     * This is independent from the [property@Gtk.Widget:visible] property of
-     * [property@ViewStackPage:child].
+     * This is independent from the {@link Gtk.Widget.visible} property of
+     * {@link ViewStackPage.child}.
      * @param visible - whether `self` is visible
      */
     setVisible(visible) {
@@ -284,7 +284,7 @@ export class ViewStackPage extends GObject.GObject {
         ], { type: "gobject", borrowed: true });
         if (ptr === null)
             return null;
-        return getObject(ptr);
+        return getNativeObject(ptr);
     }
     /**
      * Retrieves the accessible role of an accessible object.
@@ -307,7 +307,7 @@ export class ViewStackPage extends GObject.GObject {
                 value: this.id,
             },
         ], { type: "gobject", borrowed: true });
-        return getObject(ptr);
+        return getNativeObject(ptr);
     }
     /**
      * Queries the coordinates and dimensions of this accessible
@@ -368,7 +368,7 @@ export class ViewStackPage extends GObject.GObject {
         ], { type: "gobject", borrowed: true });
         if (ptr === null)
             return null;
-        return getObject(ptr);
+        return getNativeObject(ptr);
     }
     /**
      * Retrieves the next accessible sibling of an accessible object
@@ -382,7 +382,7 @@ export class ViewStackPage extends GObject.GObject {
         ], { type: "gobject", borrowed: true });
         if (ptr === null)
             return null;
-        return getObject(ptr);
+        return getNativeObject(ptr);
     }
     /**
      * Queries a platform state, such as focus.
@@ -557,7 +557,8 @@ export class ViewStackPage extends GObject.GObject {
                     itemType: {
                         type: "boxed",
                         innerType: "GValue",
-                        lib: "libadwaita-1.so.0",
+                        lib: "libgobject-2.0.so.0",
+                        getTypeFn: "g_value_get_type",
                     },
                 },
                 value: values,
@@ -598,7 +599,8 @@ export class ViewStackPage extends GObject.GObject {
                     itemType: {
                         type: "boxed",
                         innerType: "GValue",
-                        lib: "libadwaita-1.so.0",
+                        lib: "libgobject-2.0.so.0",
+                        getTypeFn: "g_value_get_type",
                     },
                 },
                 value: values,
@@ -639,7 +641,8 @@ export class ViewStackPage extends GObject.GObject {
                     itemType: {
                         type: "boxed",
                         innerType: "GValue",
-                        lib: "libadwaita-1.so.0",
+                        lib: "libgobject-2.0.so.0",
+                        getTypeFn: "g_value_get_type",
                     },
                 },
                 value: values,
@@ -651,7 +654,7 @@ export class ViewStackPage extends GObject.GObject {
         const argTypes = [selfType];
         const returnType = undefined;
         const wrappedHandler = (...args) => {
-            const self = getObject(args[0]);
+            const self = getNativeObject(args[0]);
             return handler(self, ...args.slice(1));
         };
         return call("libadwaita-1.so.0", "g_signal_connect_closure", [

package/dist/generated/adw/view-stack-pages.d.ts

@@ -2,31 +2,31 @@ import { ViewStackPage } from "./view-stack-page.js";
 import * as GObject from "../gobject/index.js";
 import * as Gtk from "../gtk/index.js";
 /**
- * An auxiliary class used by [class@ViewStack].
+ * An auxiliary class used by {@link ViewStack}.
  *
- * See [property@ViewStack:pages].
+ * See {@link ViewStack.pages}.
  */
 export declare class ViewStackPages extends GObject.GObject {
     static readonly glibTypeName: string;
     static readonly objectType: "gobject";
     constructor();
     /**
-     * Gets the [class@ViewStackPage] for the visible child of a view stack
+     * Gets the {@link ViewStackPage} for the visible child of a view stack
      *
-     * Gets the [class@ViewStackPage] for the visible child of the associated stack.
+     * Gets the {@link ViewStackPage} for the visible child of the associated stack.
      *
      * Returns `NULL` if there's no selected page.
      */
     getSelectedPage(): ViewStackPage | null;
     /**
-     * Sets the visible child in the associated [class@ViewStack].
+     * Sets the visible child in the associated {@link ViewStack}.
      *
-     * See [property@ViewStack:visible-child].
+     * See {@link ViewStack.visible-child}.
      * @param page - a stack page within the associated stack
      */
     setSelectedPage(page: ViewStackPage): void;
     /**
-     * Gets the type of the items in @list.
+     * Gets the type of the items in `list`.
      *
      * All items returned from g_list_model_get_item() are of the type
      * returned by this function, or a subtype, or if the type is an
@@ -37,7 +37,7 @@ export declare class ViewStackPages extends GObject.GObject {
      */
     getItemType(): number;
     /**
-     * Gets the number of items in @list.
+     * Gets the number of items in `list`.
      *
      * Depending on the model implementation, calling this function may be
      * less efficient than iterating the list with increasing values for
@@ -45,9 +45,9 @@ export declare class ViewStackPages extends GObject.GObject {
      */
     getNItems(): number;
     /**
-     * Get the item at @position.
+     * Get the item at `position`.
      *
-     * If `position` is greater than the number of items in @list, %NULL is
+     * If `position` is greater than the number of items in `list`, %NULL is
      * returned.
      *
      * %NULL is never returned for an index that is smaller than the length
@@ -61,7 +61,7 @@ export declare class ViewStackPages extends GObject.GObject {
      */
     getObject(position: number): GObject.GObject | null;
     /**
-     * Emits the #GListModel::items-changed signal on @list.
+     * Emits the #GListModel::items-changed signal on `list`.
      *
      * This function should only be called by classes implementing
      * #GListModel. It has to be called after the internal representation
@@ -90,17 +90,17 @@ export declare class ViewStackPages extends GObject.GObject {
      * Gets the set containing all currently selected items in the model.
      *
      * This function may be slow, so if you are only interested in single item,
-     * consider using [method@Gtk.SelectionModel.is_selected] or if you are only
-     * interested in a few, consider [method@Gtk.SelectionModel.get_selection_in_range].
+     * consider using {@link Gtk.SelectionModel.is_selected} or if you are only
+     * interested in a few, consider {@link Gtk.SelectionModel.get_selection_in_range}.
      */
     getSelection(): Gtk.Bitset;
     /**
      * Gets the set of selected items in a range.
      *
      * This function is an optimization for
-     * [method@Gtk.SelectionModel.get_selection] when you are only
+     * {@link Gtk.SelectionModel.get_selection} when you are only
      * interested in part of the model's selected state. A common use
-     * case is in response to the [signal@Gtk.SelectionModel::selection-changed]
+     * case is in response to the {@link Gtk.SelectionModel.:selection-changed}
      * signal.
      * @param position - start of the queried range
      * @param nItems - number of items in the queried range
@@ -132,7 +132,7 @@ export declare class ViewStackPages extends GObject.GObject {
      * Helper function for implementations of `GtkSelectionModel`.
      *
      * Call this when the selection changes to emit the
-     * [signal@Gtk.SelectionModel::selection-changed] signal.
+     * {@link Gtk.SelectionModel.:selection-changed} signal.
      * @param position - the first changed item
      * @param nItems - the number of changed items
      */
@@ -145,7 +145,8 @@ export declare class ViewStackPages extends GObject.GObject {
      * you should try the simpler versions, as implementations are more
      * likely to implement support for those.
      *
-     * Requests that the selection state of all positions set in `mask` be updated to the respective value in the `selected` bitmask.
+     * Requests that the selection state of all positions set in `mask`
+     * be updated to the respective value in the `selected` bitmask.
      *
      * In pseudocode, it would look something like this:
      *