@gtkx/ffi 0.10.5 → 0.11.0

package/dist/generated/gtk/functions.d.ts

@@ -3,14 +3,15 @@ import { AccessibleProperty, AccessibleRelation, AccessibleRole, AccessibleState
 import { Bitset } from "./bitset.js";
 import { BitsetIter } from "./bitset-iter.js";
 import { PaperSize } from "./paper-size.js";
+import { RequestedSize } from "./requested-size.js";
 import { TreePath } from "./tree-path.js";
 import { Accessible } from "./accessible.js";
-import { Expression } from "./expression.js";
 import { Native } from "./native.js";
+import { TreeModel } from "./tree-model.js";
+import { Expression } from "./expression.js";
 import { PageSetup } from "./page-setup.js";
 import { PrintSettings } from "./print-settings.js";
 import { StyleContext } from "./style-context.js";
-import { TreeModel } from "./tree-model.js";
 import { Widget } from "./widget.js";
 import { Window } from "./window.js";
 import * as GObject from "../gobject/index.js";
@@ -29,8 +30,6 @@ export declare const acceleratorGetDefaultModMask: () => Gdk.ModifierType;
 /**
  * Converts an accelerator keyval and modifier mask into a string
  * which can be used to represent the accelerator to the user.
- * @param acceleratorKey - accelerator keyval
- * @param acceleratorMods - accelerator modifier mask
  */
 export declare const acceleratorGetLabel: (acceleratorKey: number, acceleratorMods: Gdk.ModifierType) => string;
 /**
@@ -43,12 +42,8 @@ export declare const acceleratorGetLabel: (acceleratorKey: number, acceleratorMo
  * but handling keycodes. This is only useful for system-level
  * components, applications should use {@link Gtk.accelerator_get_label}
  * instead.
- * @param display - a `GdkDisplay`
- * @param acceleratorKey - accelerator keyval
- * @param keycode - accelerator keycode
- * @param acceleratorMods - accelerator modifier mask
  */
-export declare const acceleratorGetLabelWithKeycode: (acceleratorKey: number, keycode: number, acceleratorMods: Gdk.ModifierType, display?: Gdk.Display) => string;
+export declare const acceleratorGetLabelWithKeycode: (acceleratorKey: number, keycode: number, acceleratorMods: Gdk.ModifierType, display?: Gdk.Display | null) => string;
 /**
  * Converts an accelerator keyval and modifier mask into a string
  * that can be parsed by {@link Gtk.accelerator_parse}.
@@ -58,8 +53,6 @@ export declare const acceleratorGetLabelWithKeycode: (acceleratorKey: number, ke
  *
  * If you need to display accelerators in the user interface,
  * see {@link Gtk.accelerator_get_label}.
- * @param acceleratorKey - accelerator keyval
- * @param acceleratorMods - accelerator modifier mask
  */
 export declare const acceleratorName: (acceleratorKey: number, acceleratorMods: Gdk.ModifierType) => string;
 /**
@@ -69,12 +62,8 @@ export declare const acceleratorName: (acceleratorKey: number, acceleratorMods:
  * This is similar to {@link Gtk.accelerator_name} but handling keycodes.
  * This is only useful for system-level components, applications
  * should use {@link Gtk.accelerator_name} instead.
- * @param display - a `GdkDisplay`
- * @param acceleratorKey - accelerator keyval
- * @param keycode - accelerator keycode
- * @param acceleratorMods - accelerator modifier mask
  */
-export declare const acceleratorNameWithKeycode: (acceleratorKey: number, keycode: number, acceleratorMods: Gdk.ModifierType, display?: Gdk.Display) => string;
+export declare const acceleratorNameWithKeycode: (acceleratorKey: number, keycode: number, acceleratorMods: Gdk.ModifierType, display?: Gdk.Display | null) => string;
 /**
  * Parses a string representing an accelerator.
  *
@@ -99,11 +88,8 @@ export declare const acceleratorNameWithKeycode: (acceleratorKey: number, keycod
  *
  * If the parse operation fails, `accelerator_key` and `accelerator_mods` will
  * be set to 0 (zero).
- * @param accelerator - string representing an accelerator
- * @param acceleratorKey - return location for accelerator keyval
- * @param acceleratorMods - return location for accelerator
  */
-export declare const acceleratorParse: (accelerator: string, acceleratorKey?: Ref<number>, acceleratorMods?: Ref<Gdk.ModifierType>) => boolean;
+export declare const acceleratorParse: (accelerator: string, acceleratorKey?: Ref<number> | null, acceleratorMods?: Ref<Gdk.ModifierType> | null) => boolean;
 /**
  * Parses a string representing an accelerator.
  *
@@ -119,13 +105,8 @@ export declare const acceleratorParse: (accelerator: string, acceleratorKey?: Re
  *
  * If the parse fails, `accelerator_key`, `accelerator_mods` and
  * `accelerator_codes` will be set to 0 (zero).
- * @param accelerator - string representing an accelerator
- * @param display - the `GdkDisplay` to look up `accelerator_codes` in
- * @param acceleratorKey - return location for accelerator keyval
- * @param acceleratorCodes - return location for accelerator keycodes
- * @param acceleratorMods - return location for accelerator
  */
-export declare const acceleratorParseWithKeycode: (accelerator: string, display?: Gdk.Display, acceleratorKey?: Ref<number>, acceleratorCodes?: Ref<number[]>, acceleratorMods?: Ref<Gdk.ModifierType>) => boolean;
+export declare const acceleratorParseWithKeycode: (accelerator: string, display?: Gdk.Display | null, acceleratorKey?: Ref<number> | null, acceleratorCodes?: Ref<number[]> | null, acceleratorMods?: Ref<Gdk.ModifierType> | null) => boolean;
 /**
  * Determines whether a given keyval and modifier mask constitute
  * a valid keyboard accelerator.
@@ -133,8 +114,6 @@ export declare const acceleratorParseWithKeycode: (accelerator: string, display?
  * For example, the `GDK_KEY_a` keyval plus `GDK_CONTROL_MASK` mask is valid,
  * and matches the “Ctrl+a” accelerator. But, you can't, for instance, use
  * the `GDK_KEY_Control_L` keyval as an accelerator.
- * @param keyval - a GDK keyval
- * @param modifiers - modifier mask
  */
 export declare const acceleratorValid: (keyval: number, modifiers: Gdk.ModifierType) => boolean;
 /**
@@ -142,8 +121,6 @@ export declare const acceleratorValid: (keyval: number, modifiers: Gdk.ModifierT
  *
  * This function is mostly meant for language bindings, in conjunction
  * with gtk_accessible_update_property_value().
- * @param property - a `GtkAccessibleProperty`
- * @param value - an uninitialized `GValue`
  */
 export declare const accessiblePropertyInitValue: (property: AccessibleProperty, value: GObject.Value) => void;
 /**
@@ -151,8 +128,6 @@ export declare const accessiblePropertyInitValue: (property: AccessibleProperty,
  *
  * This function is mostly meant for language bindings, in conjunction
  * with gtk_accessible_update_relation_value().
- * @param relation - a `GtkAccessibleRelation`
- * @param value - an uninitialized `GValue`
  */
 export declare const accessibleRelationInitValue: (relation: AccessibleRelation, value: GObject.Value) => void;
 /**
@@ -160,8 +135,6 @@ export declare const accessibleRelationInitValue: (relation: AccessibleRelation,
  *
  * This function is mostly meant for language bindings, in conjunction
  * with gtk_accessible_update_relation_state().
- * @param state - a `GtkAccessibleState`
- * @param value - an uninitialized `GValue`
  */
 export declare const accessibleStateInitValue: (state: AccessibleState, value: GObject.Value) => void;
 /**
@@ -169,35 +142,23 @@ export declare const accessibleStateInitValue: (state: AccessibleState, value: G
  *
  * If `target` is not found, finds the next value after it.
  * If no value >= `target` exists in `set`, this function returns %FALSE.
- * @param iter - a pointer to an uninitialized `GtkBitsetIter`
- * @param set - a `GtkBitset`
- * @param target - target value to start iterating at
- * @param value - Set to the found value in `set`
  */
-export declare const bitsetIterInitAt: (iter: BitsetIter, set: Bitset, target: number, value?: Ref<number>) => boolean;
+export declare const bitsetIterInitAt: (iter: BitsetIter, set: Bitset, target: number, value?: Ref<number> | null) => boolean;
 /**
  * Initializes an iterator for `set` and points it to the first
  * value in `set`.
  *
  * If `set` is empty, %FALSE is returned and `value` is set to %G_MAXUINT.
- * @param iter - a pointer to an uninitialized `GtkBitsetIter`
- * @param set - a `GtkBitset`
- * @param value - Set to the first value in `set`
  */
-export declare const bitsetIterInitFirst: (iter: BitsetIter, set: Bitset, value?: Ref<number>) => boolean;
+export declare const bitsetIterInitFirst: (iter: BitsetIter, set: Bitset, value?: Ref<number> | null) => boolean;
 /**
  * Initializes an iterator for `set` and points it to the last
  * value in `set`.
  *
  * If `set` is empty, %FALSE is returned.
- * @param iter - a pointer to an uninitialized `GtkBitsetIter`
- * @param set - a `GtkBitset`
- * @param value - Set to the last value in `set`
- */
-export declare const bitsetIterInitLast: (iter: BitsetIter, set: Bitset, value?: Ref<number>) => boolean;
-/**
- * Registers an error quark for {@link Gtk.Builder} errors.
  */
+export declare const bitsetIterInitLast: (iter: BitsetIter, set: Bitset, value?: Ref<number> | null) => boolean;
+/** Registers an error quark for {@link Gtk.Builder} errors. */
 export declare const builderErrorQuark: () => number;
 /**
  * Checks that the GTK library in use is compatible with the
@@ -223,22 +184,13 @@ export declare const builderErrorQuark: () => number;
  * linked against an old version of GTK and calling the
  * old version of gtk_check_version(), but still get loaded
  * into an application using a newer version of GTK.
- * @param requiredMajor - the required major version
- * @param requiredMinor - the required minor version
- * @param requiredMicro - the required micro version
  */
 export declare const checkVersion: (requiredMajor: number, requiredMinor: number, requiredMicro: number) => string | null;
-/**
- * Registers an error quark for VFL error parsing.
- */
+/** Registers an error quark for VFL error parsing. */
 export declare const constraintVflParserErrorQuark: () => number;
-/**
- * Registers an error quark for CSS parsing errors.
- */
+/** Registers an error quark for CSS parsing errors. */
 export declare const cssParserErrorQuark: () => number;
-/**
- * Registers an error quark for CSS parsing warnings.
- */
+/** Registers an error quark for CSS parsing warnings. */
 export declare const cssParserWarningQuark: () => number;
 /**
  * Registers an error quark for an operation that requires a dialog if
@@ -270,21 +222,14 @@ export declare const disableSetlocale: () => void;
  * The remaining space will be added to the `minimum_size` member of the
  * `GtkRequestedSize` struct. If all sizes reach their natural size then
  * the remaining space is returned.
- * @param extraSpace - Extra space to redistribute among children after subtracting
- * @param nRequestedSizes - Number of requests to fit into the allocation
- * @param sizes - An array of structs with a client pointer and a minimum/natural size
  */
-export declare const distributeNaturalAllocation: (extraSpace: number, nRequestedSizes: number, sizes: number[]) => number;
+export declare const distributeNaturalAllocation: (extraSpace: number, nRequestedSizes: number, sizes: RequestedSize[]) => number;
 /**
  * Gets a property of the `GtkEditable` delegate for `object`.
  *
  * This is helper function that should be called in the `get_property`
  * function of your `GtkEditable` implementation, before handling your
  * own properties.
- * @param object - a `GObject`
- * @param propId - a property ID
- * @param value - value to set
- * @param pspec - the `GParamSpec` for the property
  */
 export declare const editableDelegateGetProperty: (object: GObject.GObject, propId: number, value: GObject.Value, pspec: GObject.ParamSpec) => boolean;
 /**
@@ -293,10 +238,6 @@ export declare const editableDelegateGetProperty: (object: GObject.GObject, prop
  * This is a helper function that should be called in the `set_property`
  * function of your `GtkEditable` implementation, before handling your
  * own properties.
- * @param object - a `GObject`
- * @param propId - a property ID
- * @param value - value to set
- * @param pspec - the `GParamSpec` for the property
  */
 export declare const editableDelegateSetProperty: (object: GObject.GObject, propId: number, value: GObject.Value, pspec: GObject.ParamSpec) => boolean;
 /**
@@ -315,13 +256,9 @@ export declare const editableDelegateSetProperty: (object: GObject.GObject, prop
  * a delegate), or remember the `first_prop` offset and add it to the
  * values in the {@link Gtk.EditableProperties} enumeration to get the
  * property IDs for these properties.
- * @param objectClass - a `GObjectClass`
- * @param firstProp - property ID to use for the first property
- */
-export declare const editableInstallProperties: (objectClass: number, firstProp: number) => number;
-/**
- * Registers an error quark for `GtkFileChooser` errors.
  */
+export declare const editableInstallProperties: (objectClass: GObject.ObjectClass, firstProp: number) => number;
+/** Registers an error quark for `GtkFileChooser` errors. */
 export declare const fileChooserErrorQuark: () => number;
 /**
  * Returns the binary age as passed to `libtool`.
@@ -424,17 +361,9 @@ export declare const getMinorVersion: () => number;
  *
  * Input values must be in the [0.0, 1.0] range;
  * output values will be in the same range.
- * @param h - Hue
- * @param s - Saturation
- * @param v - Value
- * @param r - Return value for the red component
- * @param g - Return value for the green component
- * @param b - Return value for the blue component
  */
 export declare const hsvToRgb: (h: number, s: number, v: number, r: Ref<number>, g: Ref<number>, b: Ref<number>) => void;
-/**
- * Registers an error quark for {@link Gtk.IconTheme} errors.
- */
+/** Registers an error quark for {@link Gtk.IconTheme} errors. */
 export declare const iconThemeErrorQuark: () => number;
 /**
  * Initializes GTK.
@@ -479,34 +408,22 @@ export declare const initCheck: () => boolean;
  * See {@link Gtk.init}.
  */
 export declare const isInitialized: () => boolean;
-/**
- * Finds the `GtkNative` associated with the surface.
- * @param surface - a `GdkSurface`
- */
+/** Finds the `GtkNative` associated with the surface. */
 export declare const nativeGetForSurface: (surface: Gdk.Surface) => Native | null;
 /**
  * Returns the name of the default paper size, which
  * depends on the current locale.
  */
 export declare const paperSizeGetDefault: () => string;
-/**
- * Creates a list of known paper sizes.
- * @param includeCustom - whether to include custom paper sizes
- */
+/** Creates a list of known paper sizes. */
 export declare const paperSizeGetPaperSizes: (includeCustom: boolean) => PaperSize[];
 /**
  * Creates a new `GParamSpec` instance for a property holding a `GtkExpression`.
  *
  * See `g_param_spec_internal()` for details on the property strings.
- * @param name - canonical name of the property
- * @param nick - a user-readable name for the property
- * @param blurb - a user-readable description of the property
- * @param flags - flags for the property
  */
 export declare const paramSpecExpression: (name: string, nick: string, blurb: string, flags: GObject.ParamFlags) => GObject.ParamSpec;
-/**
- * Registers an error quark for `GtkPrintOperation` if necessary.
- */
+/** Registers an error quark for `GtkPrintOperation` if necessary. */
 export declare const printErrorQuark: () => number;
 /**
  * Runs a page setup dialog, letting the user modify the values from `page_setup`.
@@ -518,25 +435,14 @@ export declare const printErrorQuark: () => number;
  * Note that this function may use a recursive mainloop to show the page
  * setup dialog. See {@link Gtk.print_run_page_setup_dialog_async} if this is
  * a problem.
- * @param parent - transient parent
- * @param pageSetup - an existing `GtkPageSetup`
- * @param settings - a `GtkPrintSettings`
- */
-export declare const printRunPageSetupDialog: (settings: PrintSettings, parent?: Window, pageSetup?: PageSetup) => PageSetup;
-/**
- * Registers an error quark for {@link RecentManager} errors.
  */
+export declare const printRunPageSetupDialog: (settings: PrintSettings, parent?: Window | null, pageSetup?: PageSetup | null) => PageSetup;
+/** Registers an error quark for {@link RecentManager} errors. */
 export declare const recentManagerErrorQuark: () => number;
 /**
  * Renders an activity indicator (such as in `GtkSpinner`).
  * The state %GTK_STATE_FLAG_CHECKED determines whether there is
  * activity going on.
- * @param context - a `GtkStyleContext`
- * @param cr - a `cairo_t`
- * @param x - X origin of the rectangle
- * @param y - Y origin of the rectangle
- * @param width - rectangle width
- * @param height - rectangle height
  */
 export declare const renderActivity: (context: StyleContext, cr: cairo.Context, x: number, y: number, width: number, height: number) => void;
 /**
@@ -545,12 +451,6 @@ export declare const renderActivity: (context: StyleContext, cr: cairo.Context,
  * Typical arrow rendering at 0, 1⁄2 π;, π; and 3⁄2 π:
  *
  * ![](https://docs.gtk.org/gtk4/arrows.png)
- * @param context - a `GtkStyleContext`
- * @param cr - a `cairo_t`
- * @param angle - arrow angle from 0 to 2 * %G_PI, being 0 the arrow pointing to the north
- * @param x - X origin of the render area
- * @param y - Y origin of the render area
- * @param size - square side for render area
  */
 export declare const renderArrow: (context: StyleContext, cr: cairo.Context, angle: number, x: number, y: number, size: number) => void;
 /**
@@ -560,12 +460,6 @@ export declare const renderArrow: (context: StyleContext, cr: cairo.Context, ang
  * `background-image`, `border-width` and `border-radius`:
  *
  * ![](https://docs.gtk.org/gtk4/background.png)
- * @param context - a `GtkStyleContext`
- * @param cr - a `cairo_t`
- * @param x - X origin of the rectangle
- * @param y - Y origin of the rectangle
- * @param width - rectangle width
- * @param height - rectangle height
  */
 export declare const renderBackground: (context: StyleContext, cr: cairo.Context, x: number, y: number, width: number, height: number) => void;
 /**
@@ -578,12 +472,6 @@ export declare const renderBackground: (context: StyleContext, cr: cairo.Context
  * Typical checkmark rendering:
  *
  * ![](https://docs.gtk.org/gtk4/checks.png)
- * @param context - a `GtkStyleContext`
- * @param cr - a `cairo_t`
- * @param x - X origin of the rectangle
- * @param y - Y origin of the rectangle
- * @param width - rectangle width
- * @param height - rectangle height
  */
 export declare const renderCheck: (context: StyleContext, cr: cairo.Context, x: number, y: number, width: number, height: number) => void;
 /**
@@ -594,12 +482,6 @@ export declare const renderCheck: (context: StyleContext, cr: cairo.Context, x:
  * Typical expander rendering:
  *
  * ![](https://docs.gtk.org/gtk4/expanders.png)
- * @param context - a `GtkStyleContext`
- * @param cr - a `cairo_t`
- * @param x - X origin of the rectangle
- * @param y - Y origin of the rectangle
- * @param width - rectangle width
- * @param height - rectangle height
  */
 export declare const renderExpander: (context: StyleContext, cr: cairo.Context, x: number, y: number, width: number, height: number) => void;
 /**
@@ -608,12 +490,6 @@ export declare const renderExpander: (context: StyleContext, cr: cairo.Context,
  * Typical focus rendering:
  *
  * ![](https://docs.gtk.org/gtk4/focus.png)
- * @param context - a `GtkStyleContext`
- * @param cr - a `cairo_t`
- * @param x - X origin of the rectangle
- * @param y - Y origin of the rectangle
- * @param width - rectangle width
- * @param height - rectangle height
  */
 export declare const renderFocus: (context: StyleContext, cr: cairo.Context, x: number, y: number, width: number, height: number) => void;
 /**
@@ -623,12 +499,6 @@ export declare const renderFocus: (context: StyleContext, cr: cairo.Context, x:
  * `border-color`, `border-width`, `border-radius` and junctions:
  *
  * ![](https://docs.gtk.org/gtk4/frames.png)
- * @param context - a `GtkStyleContext`
- * @param cr - a `cairo_t`
- * @param x - X origin of the rectangle
- * @param y - Y origin of the rectangle
- * @param width - rectangle width
- * @param height - rectangle height
  */
 export declare const renderFrame: (context: StyleContext, cr: cairo.Context, x: number, y: number, width: number, height: number) => void;
 /**
@@ -638,12 +508,6 @@ export declare const renderFrame: (context: StyleContext, cr: cairo.Context, x:
  * Handles rendered for the paned and grip classes:
  *
  * ![](https://docs.gtk.org/gtk4/handles.png)
- * @param context - a `GtkStyleContext`
- * @param cr - a `cairo_t`
- * @param x - X origin of the rectangle
- * @param y - Y origin of the rectangle
- * @param width - rectangle width
- * @param height - rectangle height
  */
 export declare const renderHandle: (context: StyleContext, cr: cairo.Context, x: number, y: number, width: number, height: number) => void;
 /**
@@ -652,31 +516,11 @@ export declare const renderHandle: (context: StyleContext, cr: cairo.Context, x:
  * This function will render the icon in `texture` at exactly its size,
  * regardless of scaling factors, which may not be appropriate when
  * drawing on displays with high pixel densities.
- * @param context - a `GtkStyleContext`
- * @param cr - a `cairo_t`
- * @param texture - a `GdkTexture` containing the icon to draw
- * @param x - X position for the `texture`
- * @param y - Y position for the `texture`
  */
 export declare const renderIcon: (context: StyleContext, cr: cairo.Context, texture: Gdk.Texture, x: number, y: number) => void;
-/**
- * Renders `layout` on the coordinates `x`, `y`
- * @param context - a `GtkStyleContext`
- * @param cr - a `cairo_t`
- * @param x - X origin
- * @param y - Y origin
- * @param layout - the `PangoLayout` to render
- */
+/** Renders `layout` on the coordinates `x`, `y` */
 export declare const renderLayout: (context: StyleContext, cr: cairo.Context, x: number, y: number, layout: Pango.Layout) => void;
-/**
- * Renders a line from (x0, y0) to (x1, y1).
- * @param context - a `GtkStyleContext`
- * @param cr - a `cairo_t`
- * @param x0 - X coordinate for the origin of the line
- * @param y0 - Y coordinate for the origin of the line
- * @param x1 - X coordinate for the end of the line
- * @param y1 - Y coordinate for the end of the line
- */
+/** Renders a line from (x0, y0) to (x1, y1). */
 export declare const renderLine: (context: StyleContext, cr: cairo.Context, x0: number, y0: number, x1: number, y1: number) => void;
 /**
  * Renders an option mark (as in a radio button), the %GTK_STATE_FLAG_CHECKED
@@ -686,12 +530,6 @@ export declare const renderLine: (context: StyleContext, cr: cairo.Context, x0:
  * Typical option mark rendering:
  *
  * ![](https://docs.gtk.org/gtk4/options.png)
- * @param context - a `GtkStyleContext`
- * @param cr - a `cairo_t`
- * @param x - X origin of the rectangle
- * @param y - Y origin of the rectangle
- * @param width - rectangle width
- * @param height - rectangle height
  */
 export declare const renderOption: (context: StyleContext, cr: cairo.Context, x: number, y: number, width: number, height: number) => void;
 /**
@@ -699,27 +537,15 @@ export declare const renderOption: (context: StyleContext, cr: cairo.Context, x:
  *
  * Input values must be in the [0.0, 1.0] range;
  * output values will be in the same range.
- * @param r - Red
- * @param g - Green
- * @param b - Blue
- * @param h - Return value for the hue component
- * @param s - Return value for the saturation component
- * @param v - Return value for the value component
  */
 export declare const rgbToHsv: (r: number, g: number, b: number, h: Ref<number>, s: Ref<number>, v: Ref<number>) => void;
-/**
- * Sets the GTK debug flags.
- * @param flags - the debug flags to set
- */
+/** Sets the GTK debug flags. */
 export declare const setDebugFlags: (flags: DebugFlags) => void;
 /**
  * This function launches the default application for showing
  * a given uri, or shows an error dialog if that fails.
- * @param parent - parent window
- * @param uri - the uri to show
- * @param timestamp - timestamp from the event that triggered this call, or %GDK_CURRENT_TIME
  */
-export declare const showUri: (uri: string, timestamp: number, parent?: Window) => void;
+export declare const showUri: (uri: string, timestamp: number, parent?: Window | null) => void;
 /**
  * This function launches the default application for showing
  * a given uri.
@@ -728,62 +554,29 @@ export declare const showUri: (uri: string, timestamp: number, parent?: Window)
  *
  * This is the recommended call to be used as it passes information
  * necessary for sandbox helpers to parent their dialogs properly.
- * @param parent - parent window
- * @param uri - the uri to show
- * @param timestamp - timestamp from the event that triggered this call, or %GDK_CURRENT_TIME
- * @param cancellable - a `GCancellable` to cancel the launch
- * @param callback - a callback to call when the action is complete
- * @param userData - data to pass to `callback`
  */
-export declare const showUriFull: (uri: string, timestamp: number, parent?: Window, cancellable?: Gio.Cancellable, callback?: (source: unknown, result: unknown) => void) => void;
+export declare const showUriFull: (uri: string, timestamp: number, parent?: Window | null, cancellable?: Gio.Cancellable | null, callback?: (source_object: GObject.GObject | null, res: Gio.AsyncResult) => void | null) => void;
 /**
  * Finishes the gtk_show_uri() call and returns the result
  * of the operation.
- * @param parent - the `GtkWindow` passed to gtk_show_uri()
- * @param result - `GAsyncResult` that was passed to `callback`
  */
 export declare const showUriFullFinish: (parent: Window, result: Gio.AsyncResult) => boolean;
-/**
- * Prints an assertion message for gtk_test_accessible_assert_role().
- * @param domain - a domain
- * @param file - a file name
- * @param line - the line in `file`
- * @param func - a function name in `file`
- * @param expr - the expression being tested
- * @param accessible - a `GtkAccessible`
- * @param expectedRole - the expected `GtkAccessibleRole`
- * @param actualRole - the actual `GtkAccessibleRole`
- */
+/** Prints an assertion message for gtk_test_accessible_assert_role(). */
 export declare const testAccessibleAssertionMessageRole: (domain: string, file: string, line: number, func: string, expr: string, accessible: Accessible, expectedRole: AccessibleRole, actualRole: AccessibleRole) => void;
-/**
- * Checks whether the `GtkAccessible` has `property` set.
- * @param accessible - a `GtkAccessible`
- * @param property - a `GtkAccessibleProperty`
- */
+/** Checks whether the `GtkAccessible` has `property` set. */
 export declare const testAccessibleHasProperty: (accessible: Accessible, property: AccessibleProperty) => boolean;
-/**
- * Checks whether the `GtkAccessible` has `relation` set.
- * @param accessible - a `GtkAccessible`
- * @param relation - a `GtkAccessibleRelation`
- */
+/** Checks whether the `GtkAccessible` has `relation` set. */
 export declare const testAccessibleHasRelation: (accessible: Accessible, relation: AccessibleRelation) => boolean;
 /**
  * Checks whether the `GtkAccessible:accessible-role` of the accessible
  * is `role`.
- * @param accessible - a `GtkAccessible`
- * @param role - a `GtkAccessibleRole`
  */
 export declare const testAccessibleHasRole: (accessible: Accessible, role: AccessibleRole) => boolean;
-/**
- * Checks whether the `GtkAccessible` has `state` set.
- * @param accessible - a `GtkAccessible`
- * @param state - a `GtkAccessibleState`
- */
+/** Checks whether the `GtkAccessible` has `state` set. */
 export declare const testAccessibleHasState: (accessible: Accessible, state: AccessibleState) => boolean;
 /**
  * Return the type ids that have been registered after
  * calling gtk_test_register_all_types().
- * @param nTypes - location to store number of types
  */
 export declare const testListAllTypes: (nTypes: Ref<number>) => number[];
 /**
@@ -802,65 +595,45 @@ export declare const testRegisterAllTypes: () => void;
  * This function is intended to be used for syncing with actions that
  * depend on `widget` relayouting or on interaction with the display
  * server.
- * @param widget - the widget to wait for
  */
 export declare const testWidgetWaitForDraw: (widget: Widget) => void;
-/**
- * Creates a content provider for dragging `path` from `tree_model`.
- * @param treeModel - a `GtkTreeModel`
- * @param path - a row in `tree_model`
- */
+/** Creates a content provider for dragging `path` from `tree_model`. */
 export declare const treeCreateRowDragContent: (treeModel: TreeModel, path: TreePath) => Gdk.ContentProvider;
 /**
  * Obtains a `tree_model` and `path` from value of target type
  * %GTK_TYPE_TREE_ROW_DATA.
  *
  * The returned path must be freed with gtk_tree_path_free().
- * @param value - a `GValue`
- * @param treeModel - a `GtkTreeModel`
- * @param path - row in `tree_model`
  */
-export declare const treeGetRowDragData: (value: GObject.Value, treeModel?: Ref<TreeModel>, path?: Ref<TreePath>) => boolean;
+export declare const treeGetRowDragData: (value: GObject.Value, treeModel?: Ref<TreeModel> | null, path?: Ref<TreePath> | null) => boolean;
 /**
  * Lets a set of row reference created by
  * gtk_tree_row_reference_new_proxy() know that the
  * model emitted the ::row-deleted signal.
- * @param proxy - a `GObject`
- * @param path - the path position that was deleted
  */
 export declare const treeRowReferenceDeleted: (proxy: GObject.GObject, path: TreePath) => void;
 /**
  * Lets a set of row reference created by
  * gtk_tree_row_reference_new_proxy() know that the
  * model emitted the ::row-inserted signal.
- * @param proxy - a `GObject`
- * @param path - the row position that was inserted
  */
 export declare const treeRowReferenceInserted: (proxy: GObject.GObject, path: TreePath) => void;
 /**
  * Retrieves the `GtkExpression` stored inside the given `value`, and acquires
  * a reference to it.
- * @param value - a `GValue` initialized with type `GTK_TYPE_EXPRESSION`
  */
 export declare const valueDupExpression: (value: GObject.Value) => Expression | null;
-/**
- * Retrieves the `GtkExpression` stored inside the given `value`.
- * @param value - a `GValue` initialized with type `GTK_TYPE_EXPRESSION`
- */
+/** Retrieves the `GtkExpression` stored inside the given `value`. */
 export declare const valueGetExpression: (value: GObject.Value) => Expression | null;
 /**
  * Stores the given `GtkExpression` inside `value`.
  *
  * The `GValue` will acquire a reference to the `expression`.
- * @param value - a `GValue` initialized with type `GTK_TYPE_EXPRESSION`
- * @param expression - a `GtkExpression`
  */
 export declare const valueSetExpression: (value: GObject.Value, expression: Expression) => void;
 /**
  * Stores the given `GtkExpression` inside `value`.
  *
  * This function transfers the ownership of the `expression` to the `GValue`.
- * @param value - a `GValue` initialized with type `GTK_TYPE_EXPRESSION`
- * @param expression - a `GtkExpression`
  */
-export declare const valueTakeExpression: (value: GObject.Value, expression?: Expression) => void;
+export declare const valueTakeExpression: (value: GObject.Value, expression?: Expression | null) => void;