@gtkx/ffi 0.1.45 → 0.1.47

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

@@ -1,21 +1,264 @@
 import { Ref } from "@gtkx/native";
 import * as GLib from "../glib/index.js";
+/**
+ * `GActionGroup` represents a group of actions.
+ *
+ * Actions can be used to expose functionality in a structured way, either
+ * from one part of a program to another, or to the outside world. Action
+ * groups are often used together with a [type@Gio.MenuModel] that provides additional
+ * representation data for displaying the actions to the user, e.g. in a menu.
+ *
+ * The main way to interact with the actions in a `GActionGroup` is to
+ * activate them with [method@Gio.ActionGroup.activate_action]. Activating an
+ * action may require a [type@GLib.Variant] parameter. The required type of the
+ * parameter can be inquired with [method@Gio.ActionGroup.get_action_parameter_type].
+ * Actions may be disabled, see [method@Gio.ActionGroup.get_action_enabled].
+ * Activating a disabled action has no effect.
+ *
+ * Actions may optionally have a state in the form of a [type@GLib.Variant]. The current
+ * state of an action can be inquired with [method@Gio.ActionGroup.get_action_state].
+ * Activating a stateful action may change its state, but it is also possible to
+ * set the state by calling [method@Gio.ActionGroup.change_action_state].
+ *
+ * As typical example, consider a text editing application which has an
+ * option to change the current font to ‘bold’. A good way to represent
+ * this would be a stateful action, with a boolean state. Activating the
+ * action would toggle the state.
+ *
+ * Each action in the group has a unique name (which is a string).  All
+ * method calls, except [method@Gio.ActionGroup.list_actions] take the name of
+ * an action as an argument.
+ *
+ * The `GActionGroup` API is meant to be the ‘public’ API to the action
+ * group. The calls here are exactly the interaction that ‘external
+ * forces’ (eg: UI, incoming D-Bus messages, etc.) are supposed to have
+ * with actions. ‘Internal’ APIs (ie: ones meant only to be accessed by
+ * the action group implementation) are found on subclasses. This is
+ * why you will find – for example – [method@Gio.ActionGroup.get_action_enabled]
+ * but not an equivalent `set_action_enabled()` method.
+ *
+ * Signals are emitted on the action group in response to state changes
+ * on individual actions.
+ *
+ * Implementations of `GActionGroup` should provide implementations for
+ * the virtual functions [method@Gio.ActionGroup.list_actions] and
+ * [method@Gio.ActionGroup.query_action]. The other virtual functions should
+ * not be implemented — their ‘wrappers’ are actually implemented with
+ * calls to [method@Gio.ActionGroup.query_action].
+ */
 export declare class ActionGroup {
     ptr: unknown;
     protected constructor(ptr: unknown);
     static fromPtr(ptr: unknown): ActionGroup;
+    /**
+     * 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;
 }

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

@@ -1,6 +1,52 @@
 import { call } from "@gtkx/native";
 import { getObject } from "@gtkx/ffi";
 import * as GLib from "../glib/index.js";
+/**
+ * `GActionGroup` represents a group of actions.
+ *
+ * Actions can be used to expose functionality in a structured way, either
+ * from one part of a program to another, or to the outside world. Action
+ * groups are often used together with a [type@Gio.MenuModel] that provides additional
+ * representation data for displaying the actions to the user, e.g. in a menu.
+ *
+ * The main way to interact with the actions in a `GActionGroup` is to
+ * activate them with [method@Gio.ActionGroup.activate_action]. Activating an
+ * action may require a [type@GLib.Variant] parameter. The required type of the
+ * parameter can be inquired with [method@Gio.ActionGroup.get_action_parameter_type].
+ * Actions may be disabled, see [method@Gio.ActionGroup.get_action_enabled].
+ * Activating a disabled action has no effect.
+ *
+ * Actions may optionally have a state in the form of a [type@GLib.Variant]. The current
+ * state of an action can be inquired with [method@Gio.ActionGroup.get_action_state].
+ * Activating a stateful action may change its state, but it is also possible to
+ * set the state by calling [method@Gio.ActionGroup.change_action_state].
+ *
+ * As typical example, consider a text editing application which has an
+ * option to change the current font to ‘bold’. A good way to represent
+ * this would be a stateful action, with a boolean state. Activating the
+ * action would toggle the state.
+ *
+ * Each action in the group has a unique name (which is a string).  All
+ * method calls, except [method@Gio.ActionGroup.list_actions] take the name of
+ * an action as an argument.
+ *
+ * The `GActionGroup` API is meant to be the ‘public’ API to the action
+ * group. The calls here are exactly the interaction that ‘external
+ * forces’ (eg: UI, incoming D-Bus messages, etc.) are supposed to have
+ * with actions. ‘Internal’ APIs (ie: ones meant only to be accessed by
+ * the action group implementation) are found on subclasses. This is
+ * why you will find – for example – [method@Gio.ActionGroup.get_action_enabled]
+ * but not an equivalent `set_action_enabled()` method.
+ *
+ * Signals are emitted on the action group in response to state changes
+ * on individual actions.
+ *
+ * Implementations of `GActionGroup` should provide implementations for
+ * the virtual functions [method@Gio.ActionGroup.list_actions] and
+ * [method@Gio.ActionGroup.query_action]. The other virtual functions should
+ * not be implemented — their ‘wrappers’ are actually implemented with
+ * calls to [method@Gio.ActionGroup.query_action].
+ */
 export class ActionGroup {
     ptr;
     constructor(ptr) {
@@ -9,6 +55,12 @@ export class ActionGroup {
     static fromPtr(ptr) {
         return new ActionGroup(ptr);
     }
+    /**
+     * 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", [
             {
@@ -21,6 +73,13 @@ export class ActionGroup {
             },
         ], { 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", [
             {
@@ -37,6 +96,12 @@ export class ActionGroup {
             },
         ], { 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", [
             {
@@ -49,6 +114,13 @@ export class ActionGroup {
             },
         ], { 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", [
             {
@@ -70,6 +142,43 @@ export class ActionGroup {
             },
         ], { 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", [
             {
@@ -92,6 +201,21 @@ export class ActionGroup {
             },
         ], { 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", [
             {
@@ -113,6 +237,13 @@ export class ActionGroup {
             },
         ], { 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", [
             {
@@ -125,6 +256,22 @@ export class ActionGroup {
             },
         ], { 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", [
             {
@@ -145,6 +292,17 @@ export class ActionGroup {
             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", [
             {
@@ -165,6 +323,27 @@ export class ActionGroup {
             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", [
             {
@@ -185,6 +364,25 @@ export class ActionGroup {
             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", [
             {
@@ -205,6 +403,10 @@ export class ActionGroup {
             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", [
             {
@@ -217,6 +419,12 @@ export class ActionGroup {
             },
         ], { 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", [
             {
@@ -225,6 +433,41 @@ export class ActionGroup {
             },
         ], { 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", [
             {