@gtkx/ffi 0.1.45 → 0.1.46

package/dist/generated/gio/dbus-action-group.d.ts

@@ -2,25 +2,275 @@ import { Ref } from "@gtkx/native";
 import { DBusConnection } from "./dbus-connection.js";
 import * as GLib from "../glib/index.js";
 import * as GObject from "../gobject/index.js";
+/**
+ * `GDBusActionGroup` is an implementation of the [iface@Gio.ActionGroup]
+ * interface.
+ *
+ * `GDBusActionGroup` can be used as a proxy for an action group
+ * that is exported over D-Bus with [method@Gio.DBusConnection.export_action_group].
+ */
 export declare class DBusActionGroup extends GObject.GObject {
     constructor(...args: unknown[]);
     protected createPtr(_args: unknown[]): unknown;
+    /**
+     * Obtains a #GDBusActionGroup for the action group which is exported at
+     * the given `bus_name` and @object_path.
+     *
+     * The thread default main context is taken at the time of this call.
+     * All signals on the menu model (and any linked models) are reported
+     * with respect to this context.  All calls on the returned menu model
+     * (and linked models) must also originate from this same context, with
+     * the thread default main context unchanged.
+     *
+     * This call is non-blocking.  The returned action group may or may not
+     * already be filled in.  The correct thing to do is connect the signals
+     * for the action group to monitor for changes and then to call
+     * g_action_group_list_actions() to get the initial list.
+     * @param connection - A #GDBusConnection
+     * @param busName - the bus name which exports the action
+     * @param objectPath - the object path at which the action group is exported
+     */
     static get(connection: DBusConnection, objectPath: string, busName?: string | null): DBusActionGroup;
+    /**
+     * Emits the [signal@Gio.ActionGroup::action-added] signal on @action_group.
+     *
+     * This function should only be called by [type@Gio.ActionGroup] implementations.
+     * @param actionName - the name of an action in the group
+     */
     actionAdded(actionName: string): void;
+    /**
+     * Emits the [signal@Gio.ActionGroup::action-enabled-changed] signal on @action_group.
+     *
+     * This function should only be called by [type@Gio.ActionGroup] implementations.
+     * @param actionName - the name of an action in the group
+     * @param enabled - whether the action is now enabled
+     */
     actionEnabledChanged(actionName: string, enabled: boolean): void;
+    /**
+     * Emits the [signal@Gio.ActionGroup::action-removed] signal on @action_group.
+     *
+     * This function should only be called by [type@Gio.ActionGroup] implementations.
+     * @param actionName - the name of an action in the group
+     */
     actionRemoved(actionName: string): void;
+    /**
+     * Emits the [signal@Gio.ActionGroup::action-state-changed] signal on @action_group.
+     *
+     * This function should only be called by [type@Gio.ActionGroup] implementations.
+     * @param actionName - the name of an action in the group
+     * @param state - the new state of the named action
+     */
     actionStateChanged(actionName: string, state: GLib.Variant): void;
+    /**
+     * Activate the named action within @action_group.
+     *
+     * If the action is expecting a parameter, then the correct type of
+     * parameter must be given as @parameter.  If the action is expecting no
+     * parameters then `parameter` must be `NULL`.  See
+     * [method@Gio.ActionGroup.get_action_parameter_type].
+     *
+     * If the [type@Gio.ActionGroup] implementation supports asynchronous remote
+     * activation over D-Bus, this call may return before the relevant
+     * D-Bus traffic has been sent, or any replies have been received. In
+     * order to block on such asynchronous activation calls,
+     * [method@Gio.DBusConnection.flush] should be called prior to the code, which
+     * depends on the result of the action activation. Without flushing
+     * the D-Bus connection, there is no guarantee that the action would
+     * have been activated.
+     *
+     * The following code which runs in a remote app instance, shows an
+     * example of a ‘quit’ action being activated on the primary app
+     * instance over D-Bus. Here [method@Gio.DBusConnection.flush] is called
+     * before `exit()`. Without `g_dbus_connection_flush()`, the ‘quit’ action
+     * may fail to be activated on the primary instance.
+     *
+     * ```c
+     * // call ‘quit’ action on primary instance
+     * g_action_group_activate_action (G_ACTION_GROUP (app), "quit", NULL);
+     *
+     * // make sure the action is activated now
+     * g_dbus_connection_flush (…);
+     *
+     * g_debug ("Application has been terminated. Exiting.");
+     *
+     * exit (0);
+     * ```
+     * @param actionName - the name of the action to activate
+     * @param parameter - parameters to the activation
+     */
     activateAction(actionName: string, parameter?: GLib.Variant | null): void;
+    /**
+     * Request for the state of the named action within `action_group` to be
+     * changed to @value.
+     *
+     * The action must be stateful and `value` must be of the correct type.
+     * See [method@Gio.ActionGroup.get_action_state_type].
+     *
+     * This call merely requests a change.  The action may refuse to change
+     * its state or may change its state to something other than @value.
+     * See [method@Gio.ActionGroup.get_action_state_hint].
+     *
+     * If the `value` GVariant is floating, it is consumed.
+     * @param actionName - the name of the action to request the change on
+     * @param value - the new state
+     */
     changeActionState(actionName: string, value: GLib.Variant): void;
+    /**
+     * Checks if the named action within `action_group` is currently enabled.
+     *
+     * An action must be enabled in order to be activated or in order to
+     * have its state changed from outside callers.
+     * @param actionName - the name of the action to query
+     */
     getActionEnabled(actionName: string): boolean;
+    /**
+     * Queries the type of the parameter that must be given when activating
+     * the named action within @action_group.
+     *
+     * When activating the action using [method@Gio.ActionGroup.activate_action],
+     * the [type@GLib.Variant] given to that function must be of the type returned
+     * by this function.
+     *
+     * In the case that this function returns `NULL`, you must not give any
+     * [type@GLib.Variant], but `NULL` instead.
+     *
+     * The parameter type of a particular action will never change but it is
+     * possible for an action to be removed and for a new action to be added
+     * with the same name but a different parameter type.
+     * @param actionName - the name of the action to query
+     */
     getActionParameterType(actionName: string): GLib.VariantType | null;
+    /**
+     * Queries the current state of the named action within @action_group.
+     *
+     * If the action is not stateful then `NULL` will be returned.  If the
+     * action is stateful then the type of the return value is the type
+     * given by [method@Gio.ActionGroup.get_action_state_type].
+     *
+     * The return value (if non-`NULL`) should be freed with
+     * [method@GLib.Variant.unref] when it is no longer required.
+     * @param actionName - the name of the action to query
+     */
     getActionState(actionName: string): GLib.Variant | null;
+    /**
+     * Requests a hint about the valid range of values for the state of the
+     * named action within @action_group.
+     *
+     * If `NULL` is returned it either means that the action is not stateful
+     * or that there is no hint about the valid range of values for the
+     * state of the action.
+     *
+     * If a [type@GLib.Variant] array is returned then each item in the array is a
+     * possible value for the state.  If a [type@GLib.Variant] pair (ie: two-tuple) is
+     * returned then the tuple specifies the inclusive lower and upper bound
+     * of valid values for the state.
+     *
+     * In any case, the information is merely a hint.  It may be possible to
+     * have a state value outside of the hinted range and setting a value
+     * within the range may fail.
+     *
+     * The return value (if non-`NULL`) should be freed with
+     * [method@GLib.Variant.unref] when it is no longer required.
+     * @param actionName - the name of the action to query
+     */
     getActionStateHint(actionName: string): GLib.Variant | null;
+    /**
+     * Queries the type of the state of the named action within
+     * @action_group.
+     *
+     * If the action is stateful then this function returns the
+     * [type@GLib.VariantType] of the state.  All calls to
+     * [method@Gio.ActionGroup.change_action_state] must give a [type@GLib.Variant] of this
+     * type and [method@Gio.ActionGroup.get_action_state] will return a [type@GLib.Variant]
+     * of the same type.
+     *
+     * If the action is not stateful then this function will return `NULL`.
+     * In that case, [method@Gio.ActionGroup.get_action_state] will return `NULL`
+     * and you must not call [method@Gio.ActionGroup.change_action_state].
+     *
+     * The state type of a particular action will never change but it is
+     * possible for an action to be removed and for a new action to be added
+     * with the same name but a different state type.
+     * @param actionName - the name of the action to query
+     */
     getActionStateType(actionName: string): GLib.VariantType | null;
+    /**
+     * Checks if the named action exists within @action_group.
+     * @param actionName - the name of the action to check for
+     */
     hasAction(actionName: string): boolean;
+    /**
+     * Lists the actions contained within @action_group.
+     *
+     * The caller is responsible for freeing the list with [func@GLib.strfreev] when
+     * it is no longer required.
+     */
     listActions(): string[];
+    /**
+     * Queries all aspects of the named action within an @action_group.
+     *
+     * This function acquires the information available from
+     * [method@Gio.ActionGroup.has_action], [method@Gio.ActionGroup.get_action_enabled],
+     * [method@Gio.ActionGroup.get_action_parameter_type],
+     * [method@Gio.ActionGroup.get_action_state_type],
+     * [method@Gio.ActionGroup.get_action_state_hint] and
+     * [method@Gio.ActionGroup.get_action_state] with a single function call.
+     *
+     * This provides two main benefits.
+     *
+     * The first is the improvement in efficiency that comes with not having
+     * to perform repeated lookups of the action in order to discover
+     * different things about it.  The second is that implementing
+     * [type@Gio.ActionGroup] can now be done by only overriding this one virtual
+     * function.
+     *
+     * The interface provides a default implementation of this function that
+     * calls the individual functions, as required, to fetch the
+     * information.  The interface also provides default implementations of
+     * those functions that call this function.  All implementations,
+     * therefore, must override either this function or all of the others.
+     *
+     * If the action exists, `TRUE` is returned and any of the requested
+     * fields (as indicated by having a non-`NULL` reference passed in) are
+     * filled.  If the action doesn’t exist, `FALSE` is returned and the
+     * fields may or may not have been modified.
+     * @param actionName - the name of an action in the group
+     * @param enabled - if the action is presently enabled
+     * @param parameterType - the parameter type, or `NULL` if none needed
+     * @param stateType - the state type, or `NULL` if stateless
+     * @param stateHint - the state hint, or `NULL` if none
+     * @param state - the current state, or `NULL` if stateless
+     */
     queryAction(actionName: string, enabled: Ref<boolean>, parameterType?: Ref<GLib.VariantType> | null, stateType?: Ref<GLib.VariantType> | null, stateHint?: Ref<GLib.Variant> | null, state?: Ref<GLib.Variant> | null): boolean;
+    /**
+     * Activates the remote action.
+     *
+     * This is the same as g_action_group_activate_action() except that it
+     * allows for provision of "platform data" to be sent along with the
+     * activation request.  This typically contains details such as the user
+     * interaction timestamp or startup notification information.
+     *
+     * `platform_data` must be non-%NULL and must have the type
+     * %G_VARIANT_TYPE_VARDICT.  If it is floating, it will be consumed.
+     * @param actionName - the name of the action to activate
+     * @param parameter - the optional parameter to the activation
+     * @param platformData - the platform data to send
+     */
     activateActionFull(actionName: string, platformData: GLib.Variant, parameter?: GLib.Variant | null): void;
+    /**
+     * Changes the state of a remote action.
+     *
+     * This is the same as g_action_group_change_action_state() except that
+     * it allows for provision of "platform data" to be sent along with the
+     * state change request.  This typically contains details such as the
+     * user interaction timestamp or startup notification information.
+     *
+     * `platform_data` must be non-%NULL and must have the type
+     * %G_VARIANT_TYPE_VARDICT.  If it is floating, it will be consumed.
+     * @param actionName - the name of the action to change the state of
+     * @param value - the new requested value for the state
+     * @param platformData - the platform data to send
+     */
     changeActionStateFull(actionName: string, value: GLib.Variant, platformData: GLib.Variant): void;
     connect(signal: "notify", handler: (self: DBusActionGroup, pspec: GObject.ParamSpec) => void, after?: boolean): number;
     connect(signal: string, handler: (...args: any[]) => any, after?: boolean): number;

package/dist/generated/gio/dbus-action-group.js

@@ -2,6 +2,13 @@ import { call } from "@gtkx/native";
 import { getObject } from "@gtkx/ffi";
 import * as GLib from "../glib/index.js";
 import * as GObject from "../gobject/index.js";
+/**
+ * `GDBusActionGroup` is an implementation of the [iface@Gio.ActionGroup]
+ * interface.
+ *
+ * `GDBusActionGroup` can be used as a proxy for an action group
+ * that is exported over D-Bus with [method@Gio.DBusConnection.export_action_group].
+ */
 export class DBusActionGroup extends GObject.GObject {
     constructor(...args) {
         super(...args);
@@ -17,6 +24,24 @@ export class DBusActionGroup extends GObject.GObject {
             { type: { type: "gobject" }, value: null },
         ], { type: "gobject", borrowed: true });
     }
+    /**
+     * Obtains a #GDBusActionGroup for the action group which is exported at
+     * the given `bus_name` and @object_path.
+     *
+     * The thread default main context is taken at the time of this call.
+     * All signals on the menu model (and any linked models) are reported
+     * with respect to this context.  All calls on the returned menu model
+     * (and linked models) must also originate from this same context, with
+     * the thread default main context unchanged.
+     *
+     * This call is non-blocking.  The returned action group may or may not
+     * already be filled in.  The correct thing to do is connect the signals
+     * for the action group to monitor for changes and then to call
+     * g_action_group_list_actions() to get the initial list.
+     * @param connection - A #GDBusConnection
+     * @param busName - the bus name which exports the action
+     * @param objectPath - the object path at which the action group is exported
+     */
     static get(connection, objectPath, busName) {
         const ptr = call("libgio-2.0.so.0", "g_dbus_action_group_get", [
             {
@@ -35,6 +60,12 @@ export class DBusActionGroup extends GObject.GObject {
         ], { type: "gobject", borrowed: true });
         return getObject(ptr, DBusActionGroup);
     }
+    /**
+     * Emits the [signal@Gio.ActionGroup::action-added] signal on @action_group.
+     *
+     * This function should only be called by [type@Gio.ActionGroup] implementations.
+     * @param actionName - the name of an action in the group
+     */
     actionAdded(actionName) {
         call("libgio-2.0.so.0", "g_action_group_action_added", [
             {
@@ -47,6 +78,13 @@ export class DBusActionGroup extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Emits the [signal@Gio.ActionGroup::action-enabled-changed] signal on @action_group.
+     *
+     * This function should only be called by [type@Gio.ActionGroup] implementations.
+     * @param actionName - the name of an action in the group
+     * @param enabled - whether the action is now enabled
+     */
     actionEnabledChanged(actionName, enabled) {
         call("libgio-2.0.so.0", "g_action_group_action_enabled_changed", [
             {
@@ -63,6 +101,12 @@ export class DBusActionGroup extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Emits the [signal@Gio.ActionGroup::action-removed] signal on @action_group.
+     *
+     * This function should only be called by [type@Gio.ActionGroup] implementations.
+     * @param actionName - the name of an action in the group
+     */
     actionRemoved(actionName) {
         call("libgio-2.0.so.0", "g_action_group_action_removed", [
             {
@@ -75,6 +119,13 @@ export class DBusActionGroup extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Emits the [signal@Gio.ActionGroup::action-state-changed] signal on @action_group.
+     *
+     * This function should only be called by [type@Gio.ActionGroup] implementations.
+     * @param actionName - the name of an action in the group
+     * @param state - the new state of the named action
+     */
     actionStateChanged(actionName, state) {
         call("libgio-2.0.so.0", "g_action_group_action_state_changed", [
             {
@@ -96,6 +147,43 @@ export class DBusActionGroup extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Activate the named action within @action_group.
+     *
+     * If the action is expecting a parameter, then the correct type of
+     * parameter must be given as @parameter.  If the action is expecting no
+     * parameters then `parameter` must be `NULL`.  See
+     * [method@Gio.ActionGroup.get_action_parameter_type].
+     *
+     * If the [type@Gio.ActionGroup] implementation supports asynchronous remote
+     * activation over D-Bus, this call may return before the relevant
+     * D-Bus traffic has been sent, or any replies have been received. In
+     * order to block on such asynchronous activation calls,
+     * [method@Gio.DBusConnection.flush] should be called prior to the code, which
+     * depends on the result of the action activation. Without flushing
+     * the D-Bus connection, there is no guarantee that the action would
+     * have been activated.
+     *
+     * The following code which runs in a remote app instance, shows an
+     * example of a ‘quit’ action being activated on the primary app
+     * instance over D-Bus. Here [method@Gio.DBusConnection.flush] is called
+     * before `exit()`. Without `g_dbus_connection_flush()`, the ‘quit’ action
+     * may fail to be activated on the primary instance.
+     *
+     * ```c
+     * // call ‘quit’ action on primary instance
+     * g_action_group_activate_action (G_ACTION_GROUP (app), "quit", NULL);
+     *
+     * // make sure the action is activated now
+     * g_dbus_connection_flush (…);
+     *
+     * g_debug ("Application has been terminated. Exiting.");
+     *
+     * exit (0);
+     * ```
+     * @param actionName - the name of the action to activate
+     * @param parameter - parameters to the activation
+     */
     activateAction(actionName, parameter) {
         call("libgio-2.0.so.0", "g_action_group_activate_action", [
             {
@@ -118,6 +206,21 @@ export class DBusActionGroup extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Request for the state of the named action within `action_group` to be
+     * changed to @value.
+     *
+     * The action must be stateful and `value` must be of the correct type.
+     * See [method@Gio.ActionGroup.get_action_state_type].
+     *
+     * This call merely requests a change.  The action may refuse to change
+     * its state or may change its state to something other than @value.
+     * See [method@Gio.ActionGroup.get_action_state_hint].
+     *
+     * If the `value` GVariant is floating, it is consumed.
+     * @param actionName - the name of the action to request the change on
+     * @param value - the new state
+     */
     changeActionState(actionName, value) {
         call("libgio-2.0.so.0", "g_action_group_change_action_state", [
             {
@@ -139,6 +242,13 @@ export class DBusActionGroup extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Checks if the named action within `action_group` is currently enabled.
+     *
+     * An action must be enabled in order to be activated or in order to
+     * have its state changed from outside callers.
+     * @param actionName - the name of the action to query
+     */
     getActionEnabled(actionName) {
         return call("libgio-2.0.so.0", "g_action_group_get_action_enabled", [
             {
@@ -151,6 +261,22 @@ export class DBusActionGroup extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Queries the type of the parameter that must be given when activating
+     * the named action within @action_group.
+     *
+     * When activating the action using [method@Gio.ActionGroup.activate_action],
+     * the [type@GLib.Variant] given to that function must be of the type returned
+     * by this function.
+     *
+     * In the case that this function returns `NULL`, you must not give any
+     * [type@GLib.Variant], but `NULL` instead.
+     *
+     * The parameter type of a particular action will never change but it is
+     * possible for an action to be removed and for a new action to be added
+     * with the same name but a different parameter type.
+     * @param actionName - the name of the action to query
+     */
     getActionParameterType(actionName) {
         const ptr = call("libgio-2.0.so.0", "g_action_group_get_action_parameter_type", [
             {
@@ -171,6 +297,17 @@ export class DBusActionGroup extends GObject.GObject {
             return null;
         return getObject(ptr, GLib.VariantType);
     }
+    /**
+     * Queries the current state of the named action within @action_group.
+     *
+     * If the action is not stateful then `NULL` will be returned.  If the
+     * action is stateful then the type of the return value is the type
+     * given by [method@Gio.ActionGroup.get_action_state_type].
+     *
+     * The return value (if non-`NULL`) should be freed with
+     * [method@GLib.Variant.unref] when it is no longer required.
+     * @param actionName - the name of the action to query
+     */
     getActionState(actionName) {
         const ptr = call("libgio-2.0.so.0", "g_action_group_get_action_state", [
             {
@@ -191,6 +328,27 @@ export class DBusActionGroup extends GObject.GObject {
             return null;
         return getObject(ptr, GLib.Variant);
     }
+    /**
+     * Requests a hint about the valid range of values for the state of the
+     * named action within @action_group.
+     *
+     * If `NULL` is returned it either means that the action is not stateful
+     * or that there is no hint about the valid range of values for the
+     * state of the action.
+     *
+     * If a [type@GLib.Variant] array is returned then each item in the array is a
+     * possible value for the state.  If a [type@GLib.Variant] pair (ie: two-tuple) is
+     * returned then the tuple specifies the inclusive lower and upper bound
+     * of valid values for the state.
+     *
+     * In any case, the information is merely a hint.  It may be possible to
+     * have a state value outside of the hinted range and setting a value
+     * within the range may fail.
+     *
+     * The return value (if non-`NULL`) should be freed with
+     * [method@GLib.Variant.unref] when it is no longer required.
+     * @param actionName - the name of the action to query
+     */
     getActionStateHint(actionName) {
         const ptr = call("libgio-2.0.so.0", "g_action_group_get_action_state_hint", [
             {
@@ -211,6 +369,25 @@ export class DBusActionGroup extends GObject.GObject {
             return null;
         return getObject(ptr, GLib.Variant);
     }
+    /**
+     * Queries the type of the state of the named action within
+     * @action_group.
+     *
+     * If the action is stateful then this function returns the
+     * [type@GLib.VariantType] of the state.  All calls to
+     * [method@Gio.ActionGroup.change_action_state] must give a [type@GLib.Variant] of this
+     * type and [method@Gio.ActionGroup.get_action_state] will return a [type@GLib.Variant]
+     * of the same type.
+     *
+     * If the action is not stateful then this function will return `NULL`.
+     * In that case, [method@Gio.ActionGroup.get_action_state] will return `NULL`
+     * and you must not call [method@Gio.ActionGroup.change_action_state].
+     *
+     * The state type of a particular action will never change but it is
+     * possible for an action to be removed and for a new action to be added
+     * with the same name but a different state type.
+     * @param actionName - the name of the action to query
+     */
     getActionStateType(actionName) {
         const ptr = call("libgio-2.0.so.0", "g_action_group_get_action_state_type", [
             {
@@ -231,6 +408,10 @@ export class DBusActionGroup extends GObject.GObject {
             return null;
         return getObject(ptr, GLib.VariantType);
     }
+    /**
+     * Checks if the named action exists within @action_group.
+     * @param actionName - the name of the action to check for
+     */
     hasAction(actionName) {
         return call("libgio-2.0.so.0", "g_action_group_has_action", [
             {
@@ -243,6 +424,12 @@ export class DBusActionGroup extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Lists the actions contained within @action_group.
+     *
+     * The caller is responsible for freeing the list with [func@GLib.strfreev] when
+     * it is no longer required.
+     */
     listActions() {
         return call("libgio-2.0.so.0", "g_action_group_list_actions", [
             {
@@ -251,6 +438,41 @@ export class DBusActionGroup extends GObject.GObject {
             },
         ], { type: "array", itemType: { type: "string" } });
     }
+    /**
+     * Queries all aspects of the named action within an @action_group.
+     *
+     * This function acquires the information available from
+     * [method@Gio.ActionGroup.has_action], [method@Gio.ActionGroup.get_action_enabled],
+     * [method@Gio.ActionGroup.get_action_parameter_type],
+     * [method@Gio.ActionGroup.get_action_state_type],
+     * [method@Gio.ActionGroup.get_action_state_hint] and
+     * [method@Gio.ActionGroup.get_action_state] with a single function call.
+     *
+     * This provides two main benefits.
+     *
+     * The first is the improvement in efficiency that comes with not having
+     * to perform repeated lookups of the action in order to discover
+     * different things about it.  The second is that implementing
+     * [type@Gio.ActionGroup] can now be done by only overriding this one virtual
+     * function.
+     *
+     * The interface provides a default implementation of this function that
+     * calls the individual functions, as required, to fetch the
+     * information.  The interface also provides default implementations of
+     * those functions that call this function.  All implementations,
+     * therefore, must override either this function or all of the others.
+     *
+     * If the action exists, `TRUE` is returned and any of the requested
+     * fields (as indicated by having a non-`NULL` reference passed in) are
+     * filled.  If the action doesn’t exist, `FALSE` is returned and the
+     * fields may or may not have been modified.
+     * @param actionName - the name of an action in the group
+     * @param enabled - if the action is presently enabled
+     * @param parameterType - the parameter type, or `NULL` if none needed
+     * @param stateType - the state type, or `NULL` if stateless
+     * @param stateHint - the state hint, or `NULL` if none
+     * @param state - the current state, or `NULL` if stateless
+     */
     queryAction(actionName, enabled, parameterType, stateType, stateHint, state) {
         return call("libgio-2.0.so.0", "g_action_group_query_action", [
             {
@@ -315,6 +537,20 @@ export class DBusActionGroup extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Activates the remote action.
+     *
+     * This is the same as g_action_group_activate_action() except that it
+     * allows for provision of "platform data" to be sent along with the
+     * activation request.  This typically contains details such as the user
+     * interaction timestamp or startup notification information.
+     *
+     * `platform_data` must be non-%NULL and must have the type
+     * %G_VARIANT_TYPE_VARDICT.  If it is floating, it will be consumed.
+     * @param actionName - the name of the action to activate
+     * @param parameter - the optional parameter to the activation
+     * @param platformData - the platform data to send
+     */
     activateActionFull(actionName, platformData, parameter) {
         call("libgio-2.0.so.0", "g_remote_action_group_activate_action_full", [
             {
@@ -346,6 +582,20 @@ export class DBusActionGroup extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Changes the state of a remote action.
+     *
+     * This is the same as g_action_group_change_action_state() except that
+     * it allows for provision of "platform data" to be sent along with the
+     * state change request.  This typically contains details such as the
+     * user interaction timestamp or startup notification information.
+     *
+     * `platform_data` must be non-%NULL and must have the type
+     * %G_VARIANT_TYPE_VARDICT.  If it is floating, it will be consumed.
+     * @param actionName - the name of the action to change the state of
+     * @param value - the new requested value for the state
+     * @param platformData - the platform data to send
+     */
     changeActionStateFull(actionName, value, platformData) {
         call("libgio-2.0.so.0", "g_remote_action_group_change_action_state_full", [
             {

package/dist/generated/gio/dbus-annotation-info.d.ts

@@ -1,16 +1,39 @@
 export interface DBusAnnotationInfoInit {
     refCount?: number;
 }
+/** Information about an annotation. */
 export declare class DBusAnnotationInfo {
     ptr: unknown;
     constructor(init?: DBusAnnotationInfoInit);
     protected createPtr(init: DBusAnnotationInfoInit): unknown;
+    /**
+     * Looks up the value of an annotation.
+     *
+     * The cost of this function is O(n) in number of annotations.
+     * @param annotations - A %NULL-terminated array of annotations or %NULL.
+     * @param name - The name of the annotation to look up.
+     */
     static lookup(name: string, annotations?: DBusAnnotationInfo[] | null): string;
+    /**
+     * If `info` is statically allocated does nothing. Otherwise increases
+     * the reference count.
+     */
     ref(): DBusAnnotationInfo;
+    /**
+     * If `info` is statically allocated, does nothing. Otherwise decreases
+     * the reference count of @info. When its reference count drops to 0,
+     * the memory used is freed.
+     */
     unref(): void;
+    /** The reference count or -1 if statically allocated. */
     get refCount(): number;
     set refCount(value: number);
+    /** The name of the annotation, e.g. "org.freedesktop.DBus.Deprecated". */
     get key(): string;
+    /** The value of the annotation. */
     get value(): string;
+    /**
+     * A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.
+     */
     get annotations(): DBusAnnotationInfo[];
 }