@gtkx/ffi 0.1.45 → 0.1.46

package/dist/generated/gio/dbus-connection.d.ts

@@ -13,59 +13,1007 @@ import { UnixFDList } from "./unix-fdlist.js";
 import * as GLib from "../glib/index.js";
 import * as GObject from "../gobject/index.js";
 export declare class DBusConnection extends GObject.GObject {
+    /**
+     * Finishes an operation started with g_dbus_connection_new().
+     * @param res - a #GAsyncResult obtained from the #GAsyncReadyCallback
+     */
     constructor(res: AsyncResult);
     constructor(...args: unknown[]);
+    /**
+     * Finishes an operation started with g_dbus_connection_new_for_address().
+     * @param res - a #GAsyncResult obtained from the #GAsyncReadyCallback passed
+     */
     static connectionNewForAddressFinish(res: AsyncResult): DBusConnection;
+    /**
+     * Synchronously connects and sets up a D-Bus client connection for
+     * exchanging D-Bus messages with an endpoint specified by `address` which must be in the
+     * D-Bus address format.
+     *
+     * This constructor can only be used to initiate client-side
+     * connections - use g_dbus_connection_new_sync() if you need to act
+     * as the server. In particular, `flags` cannot contain the
+     * %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER,
+     * %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS or
+     * %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_REQUIRE_SAME_USER flags.
+     *
+     * This is a synchronous failable constructor. See
+     * g_dbus_connection_new_for_address() for the asynchronous version.
+     *
+     * If `observer` is not %NULL it may be used to control the
+     * authentication process.
+     * @param address - a D-Bus address
+     * @param flags - flags describing how to make the connection
+     * @param observer - a #GDBusAuthObserver or %NULL
+     * @param cancellable - a #GCancellable or %NULL
+     */
     static connectionNewForAddressSync(address: string, flags: DBusConnectionFlags, observer?: DBusAuthObserver | null, cancellable?: Cancellable | null): DBusConnection;
+    /**
+     * Synchronously sets up a D-Bus connection for exchanging D-Bus messages
+     * with the end represented by @stream.
+     *
+     * If `stream` is a #GSocketConnection, then the corresponding #GSocket
+     * will be put into non-blocking mode.
+     *
+     * The D-Bus connection will interact with `stream` from a worker thread.
+     * As a result, the caller should not interact with `stream` after this
+     * method has been called, except by calling g_object_unref() on it.
+     *
+     * If `observer` is not %NULL it may be used to control the
+     * authentication process.
+     *
+     * This is a synchronous failable constructor. See
+     * g_dbus_connection_new() for the asynchronous version.
+     * @param stream - a #GIOStream
+     * @param guid - the GUID to use if authenticating as a server or %NULL
+     * @param flags - flags describing how to make the connection
+     * @param observer - a #GDBusAuthObserver or %NULL
+     * @param cancellable - a #GCancellable or %NULL
+     */
     static connectionNewSync(stream: IOStream, flags: DBusConnectionFlags, guid?: string | null, observer?: DBusAuthObserver | null, cancellable?: Cancellable | null): DBusConnection;
     protected createPtr(args: unknown[]): unknown;
+    /**
+     * Asynchronously sets up a D-Bus connection for exchanging D-Bus messages
+     * with the end represented by @stream.
+     *
+     * If `stream` is a #GSocketConnection, then the corresponding #GSocket
+     * will be put into non-blocking mode.
+     *
+     * The D-Bus connection will interact with `stream` from a worker thread.
+     * As a result, the caller should not interact with `stream` after this
+     * method has been called, except by calling g_object_unref() on it.
+     *
+     * If `observer` is not %NULL it may be used to control the
+     * authentication process.
+     *
+     * When the operation is finished, `callback` will be invoked. You can
+     * then call g_dbus_connection_new_finish() to get the result of the
+     * operation.
+     *
+     * This is an asynchronous failable constructor. See
+     * g_dbus_connection_new_sync() for the synchronous
+     * version.
+     * @param stream - a #GIOStream
+     * @param guid - the GUID to use if authenticating as a server or %NULL
+     * @param flags - flags describing how to make the connection
+     * @param observer - a #GDBusAuthObserver or %NULL
+     * @param cancellable - a #GCancellable or %NULL
+     * @param callback - a #GAsyncReadyCallback to call when the request is satisfied
+     * @param userData - the data to pass to @callback
+     */
     static _new(stream: IOStream, flags: DBusConnectionFlags, guid?: string | null, observer?: DBusAuthObserver | null, cancellable?: Cancellable | null, callback?: (...args: unknown[]) => unknown | null, userData?: number | null): void;
+    /**
+     * Asynchronously connects and sets up a D-Bus client connection for
+     * exchanging D-Bus messages with an endpoint specified by `address` which must be in the
+     * D-Bus address format.
+     *
+     * This constructor can only be used to initiate client-side
+     * connections - use g_dbus_connection_new() if you need to act as the
+     * server. In particular, `flags` cannot contain the
+     * %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER,
+     * %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS or
+     * %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_REQUIRE_SAME_USER flags.
+     *
+     * When the operation is finished, `callback` will be invoked. You can
+     * then call g_dbus_connection_new_for_address_finish() to get the result of
+     * the operation.
+     *
+     * If `observer` is not %NULL it may be used to control the
+     * authentication process.
+     *
+     * This is an asynchronous failable constructor. See
+     * g_dbus_connection_new_for_address_sync() for the synchronous
+     * version.
+     * @param address - a D-Bus address
+     * @param flags - flags describing how to make the connection
+     * @param observer - a #GDBusAuthObserver or %NULL
+     * @param cancellable - a #GCancellable or %NULL
+     * @param callback - a #GAsyncReadyCallback to call when the request is satisfied
+     * @param userData - the data to pass to @callback
+     */
     static newForAddress(address: string, flags: DBusConnectionFlags, observer?: DBusAuthObserver | null, cancellable?: Cancellable | null, callback?: (...args: unknown[]) => unknown | null, userData?: number | null): void;
+    /**
+     * Adds a message filter. Filters are handlers that are run on all
+     * incoming and outgoing messages, prior to standard dispatch. Filters
+     * are run in the order that they were added.  The same handler can be
+     * added as a filter more than once, in which case it will be run more
+     * than once.  Filters added during a filter callback won't be run on
+     * the message being processed. Filter functions are allowed to modify
+     * and even drop messages.
+     *
+     * Note that filters are run in a dedicated message handling thread so
+     * they can't block and, generally, can't do anything but signal a
+     * worker thread. Also note that filters are rarely needed - use API
+     * such as g_dbus_connection_send_message_with_reply(),
+     * g_dbus_connection_signal_subscribe() or g_dbus_connection_call() instead.
+     *
+     * If a filter consumes an incoming message the message is not
+     * dispatched anywhere else - not even the standard dispatch machinery
+     * (that API such as g_dbus_connection_signal_subscribe() and
+     * g_dbus_connection_send_message_with_reply() relies on) will see the
+     * message. Similarly, if a filter consumes an outgoing message, the
+     * message will not be sent to the other peer.
+     *
+     * If `user_data_free_func` is non-%NULL, it will be called (in the
+     * thread-default main context of the thread you are calling this
+     * method from) at some point after `user_data` is no longer
+     * needed. (It is not guaranteed to be called synchronously when the
+     * filter is removed, and may be called after `connection` has been
+     * destroyed.)
+     * @param filterFunction - a filter function
+     * @param userData - user data to pass to @filter_function
+     * @param userDataFreeFunc - function to free `user_data` with when filter
+     */
     addFilter(filterFunction: (...args: unknown[]) => unknown, userDataFreeFunc: () => void, userData?: number | null): number;
+    /**
+     * Asynchronously invokes the `method_name` method on the
+     * `interface_name` D-Bus interface on the remote object at
+     * `object_path` owned by @bus_name.
+     *
+     * If `connection` is closed then the operation will fail with
+     * %G_IO_ERROR_CLOSED. If `cancellable` is canceled, the operation will
+     * fail with %G_IO_ERROR_CANCELLED. If `parameters` contains a value
+     * not compatible with the D-Bus protocol, the operation fails with
+     * %G_IO_ERROR_INVALID_ARGUMENT.
+     *
+     * If `reply_type` is non-%NULL then the reply will be checked for having this type and an
+     * error will be raised if it does not match.  Said another way, if you give a `reply_type` then any non-%NULL return value will be of this type. Unless it’s
+     * %G_VARIANT_TYPE_UNIT, the `reply_type` will be a tuple containing one or more
+     * values.
+     *
+     * If the `parameters` #GVariant is floating, it is consumed. This allows
+     * convenient 'inline' use of g_variant_new(), e.g.:
+     * |[<!-- language="C" -->
+     * g_dbus_connection_call (connection,
+     * "org.freedesktop.StringThings",
+     * "/org/freedesktop/StringThings",
+     * "org.freedesktop.StringThings",
+     * "TwoStrings",
+     * g_variant_new ("(ss)",
+     * "Thing One",
+     * "Thing Two"),
+     * NULL,
+     * G_DBUS_CALL_FLAGS_NONE,
+     * -1,
+     * NULL,
+     * (GAsyncReadyCallback) two_strings_done,
+     * NULL);
+     * ]|
+     *
+     * This is an asynchronous method. When the operation is finished,
+     * `callback` will be invoked in the thread-default main context
+     * (see [method@GLib.MainContext.push_thread_default])
+     * of the thread you are calling this method from. You can then call
+     * g_dbus_connection_call_finish() to get the result of the operation.
+     * See g_dbus_connection_call_sync() for the synchronous version of this
+     * function.
+     *
+     * If `callback` is %NULL then the D-Bus method call message will be sent with
+     * the %G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED flag set.
+     * @param busName - a unique or well-known bus name or %NULL if
+     * @param objectPath - path of remote object
+     * @param interfaceName - D-Bus interface to invoke method on
+     * @param methodName - the name of the method to invoke
+     * @param parameters - a #GVariant tuple with parameters for the method
+     * @param replyType - the expected type of the reply (which will be a
+     * @param flags - flags from the #GDBusCallFlags enumeration
+     * @param timeoutMsec - the timeout in milliseconds, -1 to use the default
+     * @param cancellable - a #GCancellable or %NULL
+     * @param callback - a #GAsyncReadyCallback to call when the request
+     * @param userData - the data to pass to @callback
+     */
     call(objectPath: string, interfaceName: string, methodName: string, flags: DBusCallFlags, timeoutMsec: number, busName?: string | null, parameters?: GLib.Variant | null, replyType?: GLib.VariantType | null, cancellable?: Cancellable | null, callback?: (...args: unknown[]) => unknown | null, userData?: number | null): void;
+    /**
+     * Finishes an operation started with g_dbus_connection_call().
+     * @param res - a #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_call()
+     */
     callFinish(res: AsyncResult): GLib.Variant;
+    /**
+     * Synchronously invokes the `method_name` method on the
+     * `interface_name` D-Bus interface on the remote object at
+     * `object_path` owned by @bus_name.
+     *
+     * If `connection` is closed then the operation will fail with
+     * %G_IO_ERROR_CLOSED. If `cancellable` is canceled, the
+     * operation will fail with %G_IO_ERROR_CANCELLED. If `parameters` contains a value not compatible with the D-Bus protocol, the operation
+     * fails with %G_IO_ERROR_INVALID_ARGUMENT.
+     *
+     * If `reply_type` is non-%NULL then the reply will be checked for having
+     * this type and an error will be raised if it does not match.  Said
+     * another way, if you give a `reply_type` then any non-%NULL return
+     * value will be of this type.
+     *
+     * If the `parameters` #GVariant is floating, it is consumed.
+     * This allows convenient 'inline' use of g_variant_new(), e.g.:
+     * |[<!-- language="C" -->
+     * g_dbus_connection_call_sync (connection,
+     * "org.freedesktop.StringThings",
+     * "/org/freedesktop/StringThings",
+     * "org.freedesktop.StringThings",
+     * "TwoStrings",
+     * g_variant_new ("(ss)",
+     * "Thing One",
+     * "Thing Two"),
+     * NULL,
+     * G_DBUS_CALL_FLAGS_NONE,
+     * -1,
+     * NULL,
+     * &error);
+     * ]|
+     *
+     * The calling thread is blocked until a reply is received. See
+     * g_dbus_connection_call() for the asynchronous version of
+     * this method.
+     * @param busName - a unique or well-known bus name or %NULL if
+     * @param objectPath - path of remote object
+     * @param interfaceName - D-Bus interface to invoke method on
+     * @param methodName - the name of the method to invoke
+     * @param parameters - a #GVariant tuple with parameters for the method
+     * @param replyType - the expected type of the reply, or %NULL
+     * @param flags - flags from the #GDBusCallFlags enumeration
+     * @param timeoutMsec - the timeout in milliseconds, -1 to use the default
+     * @param cancellable - a #GCancellable or %NULL
+     */
     callSync(objectPath: string, interfaceName: string, methodName: string, flags: DBusCallFlags, timeoutMsec: number, busName?: string | null, parameters?: GLib.Variant | null, replyType?: GLib.VariantType | null, cancellable?: Cancellable | null): GLib.Variant;
+    /**
+     * Like g_dbus_connection_call() but also takes a #GUnixFDList object.
+     *
+     * The file descriptors normally correspond to %G_VARIANT_TYPE_HANDLE
+     * values in the body of the message. For example, if a message contains
+     * two file descriptors, `fd_list` would have length 2, and
+     * `g_variant_new_handle (0)` and `g_variant_new_handle (1)` would appear
+     * somewhere in the body of the message (not necessarily in that order!)
+     * to represent the file descriptors at indexes 0 and 1 respectively.
+     *
+     * When designing D-Bus APIs that are intended to be interoperable,
+     * please note that non-GDBus implementations of D-Bus can usually only
+     * access file descriptors if they are referenced in this way by a
+     * value of type %G_VARIANT_TYPE_HANDLE in the body of the message.
+     *
+     * This method is only available on UNIX.
+     * @param busName - a unique or well-known bus name or %NULL if
+     * @param objectPath - path of remote object
+     * @param interfaceName - D-Bus interface to invoke method on
+     * @param methodName - the name of the method to invoke
+     * @param parameters - a #GVariant tuple with parameters for the method
+     * @param replyType - the expected type of the reply, or %NULL
+     * @param flags - flags from the #GDBusCallFlags enumeration
+     * @param timeoutMsec - the timeout in milliseconds, -1 to use the default
+     * @param fdList - a #GUnixFDList or %NULL
+     * @param cancellable - a #GCancellable or %NULL
+     * @param callback - a #GAsyncReadyCallback to call when the request is
+     * @param userData - The data to pass to @callback.
+     */
     callWithUnixFdList(objectPath: string, interfaceName: string, methodName: string, flags: DBusCallFlags, timeoutMsec: number, busName?: string | null, parameters?: GLib.Variant | null, replyType?: GLib.VariantType | null, fdList?: UnixFDList | null, cancellable?: Cancellable | null, callback?: (...args: unknown[]) => unknown | null, userData?: number | null): void;
+    /**
+     * Finishes an operation started with g_dbus_connection_call_with_unix_fd_list().
+     *
+     * The file descriptors normally correspond to %G_VARIANT_TYPE_HANDLE
+     * values in the body of the message. For example,
+     * if g_variant_get_handle() returns 5, that is intended to be a reference
+     * to the file descriptor that can be accessed by
+     * `g_unix_fd_list_get (*out_fd_list, 5, ...)`.
+     *
+     * When designing D-Bus APIs that are intended to be interoperable,
+     * please note that non-GDBus implementations of D-Bus can usually only
+     * access file descriptors if they are referenced in this way by a
+     * value of type %G_VARIANT_TYPE_HANDLE in the body of the message.
+     * @param outFdList - return location for a #GUnixFDList or %NULL
+     * @param res - a #GAsyncResult obtained from the #GAsyncReadyCallback passed to
+     */
     callWithUnixFdListFinish(res: AsyncResult, outFdList?: Ref<UnixFDList> | null): GLib.Variant;
+    /**
+     * Like g_dbus_connection_call_sync() but also takes and returns #GUnixFDList objects.
+     * See g_dbus_connection_call_with_unix_fd_list() and
+     * g_dbus_connection_call_with_unix_fd_list_finish() for more details.
+     *
+     * This method is only available on UNIX.
+     * @param busName - a unique or well-known bus name or %NULL
+     * @param objectPath - path of remote object
+     * @param interfaceName - D-Bus interface to invoke method on
+     * @param methodName - the name of the method to invoke
+     * @param parameters - a #GVariant tuple with parameters for
+     * @param replyType - the expected type of the reply, or %NULL
+     * @param flags - flags from the #GDBusCallFlags enumeration
+     * @param timeoutMsec - the timeout in milliseconds, -1 to use the default
+     * @param fdList - a #GUnixFDList or %NULL
+     * @param outFdList - return location for a #GUnixFDList or %NULL
+     * @param cancellable - a #GCancellable or %NULL
+     */
     callWithUnixFdListSync(objectPath: string, interfaceName: string, methodName: string, flags: DBusCallFlags, timeoutMsec: number, busName?: string | null, parameters?: GLib.Variant | null, replyType?: GLib.VariantType | null, fdList?: UnixFDList | null, outFdList?: Ref<UnixFDList> | null, cancellable?: Cancellable | null): GLib.Variant;
+    /**
+     * Closes @connection. Note that this never causes the process to
+     * exit (this might only happen if the other end of a shared message
+     * bus connection disconnects, see #GDBusConnection:exit-on-close).
+     *
+     * Once the connection is closed, operations such as sending a message
+     * will return with the error %G_IO_ERROR_CLOSED. Closing a connection
+     * will not automatically flush the connection so queued messages may
+     * be lost. Use g_dbus_connection_flush() if you need such guarantees.
+     *
+     * If `connection` is already closed, this method fails with
+     * %G_IO_ERROR_CLOSED.
+     *
+     * When `connection` has been closed, the #GDBusConnection::closed
+     * signal is emitted in the thread-default main context
+     * (see [method@GLib.MainContext.push_thread_default])
+     * of the thread that `connection` was constructed in.
+     *
+     * This is an asynchronous method. When the operation is finished,
+     * `callback` will be invoked in the thread-default main context
+     * (see [method@GLib.MainContext.push_thread_default])
+     * of the thread you are calling this method from. You can
+     * then call g_dbus_connection_close_finish() to get the result of the
+     * operation. See g_dbus_connection_close_sync() for the synchronous
+     * version.
+     * @param cancellable - a #GCancellable or %NULL
+     * @param callback - a #GAsyncReadyCallback to call when the request is
+     * @param userData - The data to pass to @callback
+     */
     close(cancellable?: Cancellable | null, callback?: (...args: unknown[]) => unknown | null, userData?: number | null): void;
+    /**
+     * Finishes an operation started with g_dbus_connection_close().
+     * @param res - a #GAsyncResult obtained from the #GAsyncReadyCallback passed
+     */
     closeFinish(res: AsyncResult): boolean;
+    /**
+     * Synchronously closes @connection. The calling thread is blocked
+     * until this is done. See g_dbus_connection_close() for the
+     * asynchronous version of this method and more details about what it
+     * does.
+     * @param cancellable - a #GCancellable or %NULL
+     */
     closeSync(cancellable?: Cancellable | null): boolean;
+    /**
+     * Emits a signal.
+     *
+     * If the parameters GVariant is floating, it is consumed.
+     *
+     * This can only fail if `parameters` is not compatible with the D-Bus protocol
+     * (%G_IO_ERROR_INVALID_ARGUMENT), or if `connection` has been closed
+     * (%G_IO_ERROR_CLOSED).
+     * @param destinationBusName - the unique bus name for the destination
+     * @param objectPath - path of remote object
+     * @param interfaceName - D-Bus interface to emit a signal on
+     * @param signalName - the name of the signal to emit
+     * @param parameters - a #GVariant tuple with parameters for the signal
+     */
     emitSignal(objectPath: string, interfaceName: string, signalName: string, destinationBusName?: string | null, parameters?: GLib.Variant | null): boolean;
+    /**
+     * Exports `action_group` on `connection` at @object_path.
+     *
+     * The implemented D-Bus API should be considered private.  It is
+     * subject to change in the future.
+     *
+     * A given object path can only have one action group exported on it.
+     * If this constraint is violated, the export will fail and 0 will be
+     * returned (with `error` set accordingly).
+     *
+     * You can unexport the action group using
+     * [method@Gio.DBusConnection.unexport_action_group] with the return value of
+     * this function.
+     *
+     * The thread default main context is taken at the time of this call.
+     * All incoming action activations and state change requests are
+     * reported from this context.  Any changes on the action group that
+     * cause it to emit signals must also come from this same context.
+     * Since incoming action activations and state change requests are
+     * rather likely to cause changes on the action group, this effectively
+     * limits a given action group to being exported from only one main
+     * context.
+     * @param objectPath - a D-Bus object path
+     * @param actionGroup - an action group
+     */
     exportActionGroup(objectPath: string, actionGroup: ActionGroup): number;
+    /**
+     * Exports `menu` on `connection` at @object_path.
+     *
+     * The implemented D-Bus API should be considered private.
+     * It is subject to change in the future.
+     *
+     * An object path can only have one menu model exported on it. If this
+     * constraint is violated, the export will fail and 0 will be
+     * returned (with `error` set accordingly).
+     *
+     * Exporting menus with sections containing more than
+     * %G_MENU_EXPORTER_MAX_SECTION_SIZE items is not supported and results in
+     * undefined behavior.
+     *
+     * You can unexport the menu model using
+     * g_dbus_connection_unexport_menu_model() with the return value of
+     * this function.
+     * @param objectPath - a D-Bus object path
+     * @param menu - a #GMenuModel
+     */
     exportMenuModel(objectPath: string, menu: MenuModel): number;
+    /**
+     * Asynchronously flushes @connection, that is, writes all queued
+     * outgoing messages to the transport and then flushes the transport
+     * (using g_output_stream_flush_async()). This is useful in programs
+     * that want to emit a D-Bus signal and then exit immediately. Without
+     * flushing the connection, there is no guarantee that the message has
+     * been sent to the networking buffers in the OS kernel.
+     *
+     * This is an asynchronous method. When the operation is finished,
+     * `callback` will be invoked in the thread-default main context
+     * (see [method@GLib.MainContext.push_thread_default])
+     * of the thread you are calling this method from. You can
+     * then call g_dbus_connection_flush_finish() to get the result of the
+     * operation. See g_dbus_connection_flush_sync() for the synchronous
+     * version.
+     * @param cancellable - a #GCancellable or %NULL
+     * @param callback - a #GAsyncReadyCallback to call when the
+     * @param userData - The data to pass to @callback
+     */
     flush(cancellable?: Cancellable | null, callback?: (...args: unknown[]) => unknown | null, userData?: number | null): void;
+    /**
+     * Finishes an operation started with g_dbus_connection_flush().
+     * @param res - a #GAsyncResult obtained from the #GAsyncReadyCallback passed
+     */
     flushFinish(res: AsyncResult): boolean;
+    /**
+     * Synchronously flushes @connection. The calling thread is blocked
+     * until this is done. See g_dbus_connection_flush() for the
+     * asynchronous version of this method and more details about what it
+     * does.
+     * @param cancellable - a #GCancellable or %NULL
+     */
     flushSync(cancellable?: Cancellable | null): boolean;
+    /**
+     * Gets the capabilities negotiated with the remote peer
+     */
     getCapabilities(): DBusCapabilityFlags;
+    /**
+     * Gets whether the process is terminated when `connection` is
+     * closed by the remote peer. See
+     * #GDBusConnection:exit-on-close for more details.
+     */
     getExitOnClose(): boolean;
+    /**
+     * Gets the flags used to construct this connection
+     */
     getFlags(): DBusConnectionFlags;
+    /**
+     * The GUID of the peer performing the role of server when
+     * authenticating. See #GDBusConnection:guid for more details.
+     */
     getGuid(): string;
+    /**
+     * Retrieves the last serial number assigned to a #GDBusMessage on
+     * the current thread. This includes messages sent via both low-level
+     * API such as g_dbus_connection_send_message() as well as
+     * high-level API such as g_dbus_connection_emit_signal(),
+     * g_dbus_connection_call() or g_dbus_proxy_call().
+     */
     getLastSerial(): number;
+    /**
+     * Gets the credentials of the authenticated peer. This will always
+     * return %NULL unless `connection` acted as a server
+     * (e.g. %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER was passed)
+     * when set up and the client passed credentials as part of the
+     * authentication process.
+     *
+     * In a message bus setup, the message bus is always the server and
+     * each application is a client. So this method will always return
+     * %NULL for message bus clients.
+     */
     getPeerCredentials(): Credentials | null;
+    /**
+     * Gets the underlying stream used for IO.
+     *
+     * While the #GDBusConnection is active, it will interact with this
+     * stream from a worker thread, so it is not safe to interact with
+     * the stream directly.
+     */
     getStream(): IOStream;
+    /**
+     * Gets the unique name of `connection` as assigned by the message
+     * bus. This can also be used to figure out if `connection` is a
+     * message bus connection.
+     */
     getUniqueName(): string | null;
+    /**
+     * Gets whether `connection` is closed.
+     */
     isClosed(): boolean;
+    /**
+     * Registers callbacks for exported objects at `object_path` with the
+     * D-Bus interface that is described in @interface_info.
+     *
+     * Calls to functions in `vtable` (and @user_data_free_func) will happen
+     * in the thread-default main context
+     * (see [method@GLib.MainContext.push_thread_default])
+     * of the thread you are calling this method from.
+     *
+     * Note that all #GVariant values passed to functions in `vtable` will match
+     * the signature given in `interface_info` - if a remote caller passes
+     * incorrect values, the `org.freedesktop.DBus.Error.InvalidArgs`
+     * is returned to the remote caller.
+     *
+     * Additionally, if the remote caller attempts to invoke methods or
+     * access properties not mentioned in `interface_info` the
+     * `org.freedesktop.DBus.Error.UnknownMethod` resp.
+     * `org.freedesktop.DBus.Error.InvalidArgs` errors
+     * are returned to the caller.
+     *
+     * It is considered a programming error if the
+     * #GDBusInterfaceGetPropertyFunc function in `vtable` returns a
+     * #GVariant of incorrect type.
+     *
+     * If an existing callback is already registered at `object_path` and
+     * @interface_name, then `error` is set to %G_IO_ERROR_EXISTS.
+     *
+     * GDBus automatically implements the standard D-Bus interfaces
+     * org.freedesktop.DBus.Properties, org.freedesktop.DBus.Introspectable
+     * and org.freedesktop.Peer, so you don't have to implement those for the
+     * objects you export. You can implement org.freedesktop.DBus.Properties
+     * yourself, e.g. to handle getting and setting of properties asynchronously.
+     *
+     * Note that the reference count on `interface_info` will be
+     * incremented by 1 (unless allocated statically, e.g. if the
+     * reference count is -1, see g_dbus_interface_info_ref()) for as long
+     * as the object is exported. Also note that `vtable` will be copied.
+     *
+     * See this [server][class@Gio.DBusConnection#an-example-d-bus-server]
+     * for an example of how to use this method.
+     * @param objectPath - the object path to register at
+     * @param interfaceInfo - introspection data for the interface
+     * @param vtable - a #GDBusInterfaceVTable to call into or %NULL
+     * @param userData - data to pass to functions in @vtable
+     * @param userDataFreeFunc - function to call when the object path is unregistered
+     */
     registerObject(objectPath: string, interfaceInfo: DBusInterfaceInfo, userDataFreeFunc: () => void, vtable?: number | null, userData?: number | null): number;
+    /**
+     * Version of g_dbus_connection_register_object() using closures instead of a
+     * #GDBusInterfaceVTable for easier binding in other languages.
+     *
+     * Note that the reference counting semantics of the function wrapped by
+     * `method_call_closure` are the same as those of
+     * [callback@Gio.DBusInterfaceMethodCallFunc]: ownership of a reference to the
+     * [class@Gio.DBusMethodInvocation] is transferred to the function.
+     * @param objectPath - The object path to register at.
+     * @param interfaceInfo - Introspection data for the interface.
+     * @param methodCallClosure - #GClosure for handling incoming method calls.
+     * @param getPropertyClosure - #GClosure for getting a property.
+     * @param setPropertyClosure - #GClosure for setting a property.
+     */
     registerObjectWithClosures(objectPath: string, interfaceInfo: DBusInterfaceInfo, methodCallClosure?: GObject.Closure | null, getPropertyClosure?: GObject.Closure | null, setPropertyClosure?: GObject.Closure | null): number;
+    /**
+     * Version of [method@Gio.DBusConnection.register_object] using closures instead
+     * of a [type@Gio.DBusInterfaceVTable] for easier binding in other languages.
+     *
+     * In contrast to [method@Gio.DBusConnection.register_object] and
+     * [method@Gio.DBusConnection.register_object_with_closures], the reference
+     * counting semantics of the function wrapped by `method_call_closure` are *not*
+     * the same as those of [callback@Gio.DBusInterfaceMethodCallFunc]. Ownership of
+     * a reference to the [class@Gio.DBusMethodInvocation] is *not* transferred to
+     * the function. Bindings must ensure that they add a reference to the
+     * [class@Gio.DBusMethodInvocation] before calling any
+     * `g_dbus_method_invocation_return_*()` methods on it. This should be automatic
+     * as a result of the introspection annotations on those methods.
+     * @param objectPath - The object path to register at.
+     * @param interfaceInfo - Introspection data for the interface.
+     * @param methodCallClosure - [type@GObject.Closure] for handling incoming method calls.
+     * @param getPropertyClosure - [type@GObject.Closure] for getting a property.
+     * @param setPropertyClosure - [type@GObject.Closure] for setting a property.
+     */
     registerObjectWithClosures2(objectPath: string, interfaceInfo: DBusInterfaceInfo, methodCallClosure?: GObject.Closure | null, getPropertyClosure?: GObject.Closure | null, setPropertyClosure?: GObject.Closure | null): number;
+    /**
+     * Registers a whole subtree of dynamic objects.
+     *
+     * The `enumerate` and `introspection` functions in `vtable` are used to
+     * convey, to remote callers, what nodes exist in the subtree rooted
+     * by @object_path.
+     *
+     * When handling remote calls into any node in the subtree, first the
+     * `enumerate` function is used to check if the node exists. If the node exists
+     * or the %G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES flag is set
+     * the `introspection` function is used to check if the node supports the
+     * requested method. If so, the `dispatch` function is used to determine
+     * where to dispatch the call. The collected #GDBusInterfaceVTable and
+     * #gpointer will be used to call into the interface vtable for processing
+     * the request.
+     *
+     * All calls into user-provided code will be invoked in the thread-default
+     * main context (see [method@GLib.MainContext.push_thread_default])
+     * of the thread you are calling this method from.
+     *
+     * If an existing subtree is already registered at `object_path` or
+     * then `error` is set to %G_IO_ERROR_EXISTS.
+     *
+     * Note that it is valid to register regular objects (using
+     * g_dbus_connection_register_object()) in a subtree registered with
+     * g_dbus_connection_register_subtree() - if so, the subtree handler
+     * is tried as the last resort. One way to think about a subtree
+     * handler is to consider it a fallback handler for object paths not
+     * registered via g_dbus_connection_register_object() or other bindings.
+     *
+     * Note that `vtable` will be copied so you cannot change it after
+     * registration.
+     *
+     * See this [server][class@Gio.DBusConnection#an-example-for-exporting-a-subtree]
+     * for an example of how to use this method.
+     * @param objectPath - the object path to register the subtree at
+     * @param vtable - a #GDBusSubtreeVTable to enumerate, introspect and
+     * @param flags - flags used to fine tune the behavior of the subtree
+     * @param userData - data to pass to functions in @vtable
+     * @param userDataFreeFunc - function to call when the subtree is unregistered
+     */
     registerSubtree(objectPath: string, vtable: number, flags: DBusSubtreeFlags, userDataFreeFunc: () => void, userData?: number | null): number;
+    /**
+     * Removes a filter.
+     *
+     * Note that since filters run in a different thread, there is a race
+     * condition where it is possible that the filter will be running even
+     * after calling g_dbus_connection_remove_filter(), so you cannot just
+     * free data that the filter might be using. Instead, you should pass
+     * a #GDestroyNotify to g_dbus_connection_add_filter(), which will be
+     * called when it is guaranteed that the data is no longer needed.
+     * @param filterId - an identifier obtained from g_dbus_connection_add_filter()
+     */
     removeFilter(filterId: number): void;
+    /**
+     * Asynchronously sends `message` to the peer represented by @connection.
+     *
+     * Unless `flags` contain the
+     * %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number
+     * will be assigned by `connection` and set on `message` via
+     * g_dbus_message_set_serial(). If `out_serial` is not %NULL, then the
+     * serial number used will be written to this location prior to
+     * submitting the message to the underlying transport. While it has a `volatile`
+     * qualifier, this is a historical artifact and the argument passed to it should
+     * not be `volatile`.
+     *
+     * If `connection` is closed then the operation will fail with
+     * %G_IO_ERROR_CLOSED. If `message` is not well-formed,
+     * the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
+     *
+     * See this [server][class@Gio.DBusConnection#an-example-d-bus-server]
+     * and [client][class@Gio.DBusConnection#an-example-for-file-descriptor-passing]
+     * for an example of how to use this low-level API to send and receive
+     * UNIX file descriptors.
+     *
+     * Note that `message` must be unlocked, unless `flags` contain the
+     * %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.
+     * @param message - a #GDBusMessage
+     * @param flags - flags affecting how the message is sent
+     * @param outSerial - return location for serial number assigned
+     */
     sendMessage(message: DBusMessage, flags: DBusSendMessageFlags, outSerial?: Ref<number> | null): boolean;
+    /**
+     * Asynchronously sends `message` to the peer represented by @connection.
+     *
+     * Unless `flags` contain the
+     * %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number
+     * will be assigned by `connection` and set on `message` via
+     * g_dbus_message_set_serial(). If `out_serial` is not %NULL, then the
+     * serial number used will be written to this location prior to
+     * submitting the message to the underlying transport. While it has a `volatile`
+     * qualifier, this is a historical artifact and the argument passed to it should
+     * not be `volatile`.
+     *
+     * If `connection` is closed then the operation will fail with
+     * %G_IO_ERROR_CLOSED. If `cancellable` is canceled, the operation will
+     * fail with %G_IO_ERROR_CANCELLED. If `message` is not well-formed,
+     * the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
+     *
+     * This is an asynchronous method. When the operation is finished, `callback` will be invoked in the thread-default main context
+     * (see [method@GLib.MainContext.push_thread_default])
+     * of the thread you are calling this method from. You can then call
+     * g_dbus_connection_send_message_with_reply_finish() to get the result of the operation.
+     * See g_dbus_connection_send_message_with_reply_sync() for the synchronous version.
+     *
+     * Note that `message` must be unlocked, unless `flags` contain the
+     * %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.
+     *
+     * See this [server][class@Gio.DBusConnection#an-example-d-bus-server]
+     * and [client][class@Gio.DBusConnection#an-example-for-file-descriptor-passing]
+     * for an example of how to use this low-level API to send and receive
+     * UNIX file descriptors.
+     * @param message - a #GDBusMessage
+     * @param flags - flags affecting how the message is sent
+     * @param timeoutMsec - the timeout in milliseconds, -1 to use the default
+     * @param outSerial - return location for serial number assigned
+     * @param cancellable - a #GCancellable or %NULL
+     * @param callback - a #GAsyncReadyCallback to call when the request
+     * @param userData - The data to pass to @callback
+     */
     sendMessageWithReply(message: DBusMessage, flags: DBusSendMessageFlags, timeoutMsec: number, outSerial?: Ref<number> | null, cancellable?: Cancellable | null, callback?: (...args: unknown[]) => unknown | null, userData?: number | null): void;
+    /**
+     * Finishes an operation started with g_dbus_connection_send_message_with_reply().
+     *
+     * Note that `error` is only set if a local in-process error
+     * occurred. That is to say that the returned #GDBusMessage object may
+     * be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use
+     * g_dbus_message_to_gerror() to transcode this to a #GError.
+     *
+     * See this [server][class@Gio.DBusConnection#an-example-d-bus-server]
+     * and [client][class@Gio.DBusConnection#an-example-for-file-descriptor-passing]
+     * for an example of how to use this low-level API to send and receive
+     * UNIX file descriptors.
+     * @param res - a #GAsyncResult obtained from the #GAsyncReadyCallback passed to
+     */
     sendMessageWithReplyFinish(res: AsyncResult): DBusMessage;
+    /**
+     * Synchronously sends `message` to the peer represented by `connection` and blocks the calling thread until a reply is received or the
+     * timeout is reached. See g_dbus_connection_send_message_with_reply()
+     * for the asynchronous version of this method.
+     *
+     * Unless `flags` contain the
+     * %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number
+     * will be assigned by `connection` and set on `message` via
+     * g_dbus_message_set_serial(). If `out_serial` is not %NULL, then the
+     * serial number used will be written to this location prior to
+     * submitting the message to the underlying transport. While it has a `volatile`
+     * qualifier, this is a historical artifact and the argument passed to it should
+     * not be `volatile`.
+     *
+     * If `connection` is closed then the operation will fail with
+     * %G_IO_ERROR_CLOSED. If `cancellable` is canceled, the operation will
+     * fail with %G_IO_ERROR_CANCELLED. If `message` is not well-formed,
+     * the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
+     *
+     * Note that `error` is only set if a local in-process error
+     * occurred. That is to say that the returned #GDBusMessage object may
+     * be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use
+     * g_dbus_message_to_gerror() to transcode this to a #GError.
+     *
+     * See this [server][class@Gio.DBusConnection#an-example-d-bus-server]
+     * and [client][class@Gio.DBusConnection#an-example-for-file-descriptor-passing]
+     * for an example of how to use this low-level API to send and receive
+     * UNIX file descriptors.
+     *
+     * Note that `message` must be unlocked, unless `flags` contain the
+     * %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.
+     * @param message - a #GDBusMessage
+     * @param flags - flags affecting how the message is sent.
+     * @param timeoutMsec - the timeout in milliseconds, -1 to use the default
+     * @param outSerial - return location for serial number
+     * @param cancellable - a #GCancellable or %NULL
+     */
     sendMessageWithReplySync(message: DBusMessage, flags: DBusSendMessageFlags, timeoutMsec: number, outSerial?: Ref<number> | null, cancellable?: Cancellable | null): DBusMessage;
+    /**
+     * Sets whether the process should be terminated when `connection` is
+     * closed by the remote peer. See #GDBusConnection:exit-on-close for
+     * more details.
+     *
+     * Note that this function should be used with care. Most modern UNIX
+     * desktops tie the notion of a user session with the session bus, and expect
+     * all of a user's applications to quit when their bus connection goes away.
+     * If you are setting `exit_on_close` to %FALSE for the shared session
+     * bus connection, you should make sure that your application exits
+     * when the user session ends.
+     * @param exitOnClose - whether the process should be terminated
+     */
     setExitOnClose(exitOnClose: boolean): void;
+    /**
+     * Subscribes to signals on `connection` and invokes `callback` whenever
+     * the signal is received. Note that `callback` will be invoked in the
+     * thread-default main context (see [method@GLib.MainContext.push_thread_default])
+     * of the thread you are calling this method from.
+     *
+     * If `connection` is not a message bus connection, `sender` must be
+     * %NULL.
+     *
+     * If `sender` is a well-known name note that `callback` is invoked with
+     * the unique name for the owner of @sender, not the well-known name
+     * as one would expect. This is because the message bus rewrites the
+     * name. As such, to avoid certain race conditions, users should be
+     * tracking the name owner of the well-known name and use that when
+     * processing the received signal.
+     *
+     * If one of %G_DBUS_SIGNAL_FLAGS_MATCH_ARG0_NAMESPACE or
+     * %G_DBUS_SIGNAL_FLAGS_MATCH_ARG0_PATH are given, `arg0` is
+     * interpreted as part of a namespace or path.  The first argument
+     * of a signal is matched against that part as specified by D-Bus.
+     *
+     * If `user_data_free_func` is non-%NULL, it will be called (in the
+     * thread-default main context of the thread you are calling this
+     * method from) at some point after `user_data` is no longer
+     * needed. (It is not guaranteed to be called synchronously when the
+     * signal is unsubscribed from, and may be called after `connection` has been destroyed.)
+     *
+     * As `callback` is potentially invoked in a different thread from where it’s
+     * emitted, it’s possible for this to happen after
+     * g_dbus_connection_signal_unsubscribe() has been called in another thread.
+     * Due to this, `user_data` should have a strong reference which is freed with
+     * @user_data_free_func, rather than pointing to data whose lifecycle is tied
+     * to the signal subscription. For example, if a #GObject is used to store the
+     * subscription ID from g_dbus_connection_signal_subscribe(), a strong reference
+     * to that #GObject must be passed to @user_data, and g_object_unref() passed to
+     * @user_data_free_func. You are responsible for breaking the resulting
+     * reference count cycle by explicitly unsubscribing from the signal when
+     * dropping the last external reference to the #GObject. Alternatively, a weak
+     * reference may be used.
+     *
+     * It is guaranteed that if you unsubscribe from a signal using
+     * g_dbus_connection_signal_unsubscribe() from the same thread which made the
+     * corresponding g_dbus_connection_signal_subscribe() call, `callback` will not
+     * be invoked after g_dbus_connection_signal_unsubscribe() returns.
+     *
+     * The returned subscription identifier is an opaque value which is guaranteed
+     * to never be zero.
+     *
+     * This function can never fail.
+     * @param sender - sender name to match on (unique or well-known name)
+     * @param interfaceName - D-Bus interface name to match on or %NULL to
+     * @param member - D-Bus signal name to match on or %NULL to match on
+     * @param objectPath - object path to match on or %NULL to match on
+     * @param arg0 - contents of first string argument to match on or %NULL
+     * @param flags - #GDBusSignalFlags describing how arg0 is used in subscribing to the
+     * @param callback - callback to invoke when there is a signal matching the requested data
+     * @param userData - user data to pass to @callback
+     * @param userDataFreeFunc - function to free `user_data` with when
+     */
     signalSubscribe(flags: DBusSignalFlags, callback: (...args: unknown[]) => unknown, sender?: string | null, interfaceName?: string | null, member?: string | null, objectPath?: string | null, arg0?: string | null, userData?: number | null, userDataFreeFunc?: () => void | null): number;
+    /**
+     * Unsubscribes from signals.
+     *
+     * Note that there may still be D-Bus traffic to process (relating to this
+     * signal subscription) in the current thread-default #GMainContext after this
+     * function has returned. You should continue to iterate the #GMainContext
+     * until the #GDestroyNotify function passed to
+     * g_dbus_connection_signal_subscribe() is called, in order to avoid memory
+     * leaks through callbacks queued on the #GMainContext after it’s stopped being
+     * iterated.
+     * Alternatively, any idle source with a priority lower than %G_PRIORITY_DEFAULT
+     * that was scheduled after unsubscription, also indicates that all resources
+     * of this subscription are released.
+     * @param subscriptionId - a subscription id obtained from
+     */
     signalUnsubscribe(subscriptionId: number): void;
+    /**
+     * If `connection` was created with
+     * %G_DBUS_CONNECTION_FLAGS_DELAY_MESSAGE_PROCESSING, this method
+     * starts processing messages. Does nothing on if `connection` wasn't
+     * created with this flag or if the method has already been called.
+     */
     startMessageProcessing(): void;
+    /**
+     * Reverses the effect of a previous call to
+     * [method@Gio.DBusConnection.export_action_group].
+     *
+     * It is an error to call this function with an ID that wasn’t returned from
+     * [method@Gio.DBusConnection.export_action_group] or to call it with the same
+     * ID more than once.
+     * @param exportId - the ID from [method@Gio.DBusConnection.export_action_group]
+     */
     unexportActionGroup(exportId: number): void;
+    /**
+     * Reverses the effect of a previous call to
+     * g_dbus_connection_export_menu_model().
+     *
+     * It is an error to call this function with an ID that wasn't returned
+     * from g_dbus_connection_export_menu_model() or to call it with the
+     * same ID more than once.
+     * @param exportId - the ID from g_dbus_connection_export_menu_model()
+     */
     unexportMenuModel(exportId: number): void;
+    /**
+     * Unregisters an object.
+     * @param registrationId - a registration id obtained from
+     */
     unregisterObject(registrationId: number): boolean;
+    /**
+     * Unregisters a subtree.
+     * @param registrationId - a subtree registration id obtained from
+     */
     unregisterSubtree(registrationId: number): boolean;
+    /**
+     * Starts asynchronous initialization of the object implementing the
+     * interface. This must be done before any real use of the object after
+     * initial construction. If the object also implements #GInitable you can
+     * optionally call g_initable_init() instead.
+     *
+     * This method is intended for language bindings. If writing in C,
+     * g_async_initable_new_async() should typically be used instead.
+     *
+     * When the initialization is finished, `callback` will be called. You can
+     * then call g_async_initable_init_finish() to get the result of the
+     * initialization.
+     *
+     * Implementations may also support cancellation. If `cancellable` is not
+     * %NULL, then initialization can be cancelled by triggering the cancellable
+     * object from another thread. If the operation was cancelled, the error
+     * %G_IO_ERROR_CANCELLED will be returned. If `cancellable` is not %NULL, and
+     * the object doesn't support cancellable initialization, the error
+     * %G_IO_ERROR_NOT_SUPPORTED will be returned.
+     *
+     * As with #GInitable, if the object is not initialized, or initialization
+     * returns with an error, then all operations on the object except
+     * g_object_ref() and g_object_unref() are considered to be invalid, and
+     * have undefined behaviour. They will often fail with g_critical() or
+     * g_warning(), but this must not be relied on.
+     *
+     * Callers should not assume that a class which implements #GAsyncInitable can
+     * be initialized multiple times; for more information, see g_initable_init().
+     * If a class explicitly supports being initialized multiple times,
+     * implementation requires yielding all subsequent calls to init_async() on the
+     * results of the first call.
+     *
+     * For classes that also support the #GInitable interface, the default
+     * implementation of this method will run the g_initable_init() function
+     * in a thread, so if you want to support asynchronous initialization via
+     * threads, just implement the #GAsyncInitable interface without overriding
+     * any interface methods.
+     * @param ioPriority - the I/O priority of the operation
+     * @param cancellable - optional #GCancellable object, %NULL to ignore.
+     * @param callback - a #GAsyncReadyCallback to call when the request is satisfied
+     * @param userData - the data to pass to callback function
+     */
     initAsync(ioPriority: number, cancellable?: Cancellable | null, callback?: (...args: unknown[]) => unknown | null, userData?: number | null): void;
+    /**
+     * Finishes asynchronous initialization and returns the result.
+     * See g_async_initable_init_async().
+     * @param res - a #GAsyncResult.
+     */
     initFinish(res: AsyncResult): boolean;
+    /**
+     * Finishes the async construction for the various g_async_initable_new
+     * calls, returning the created object or %NULL on error.
+     * @param res - the #GAsyncResult from the callback
+     */
     newFinish(res: AsyncResult): GObject.GObject;
+    /**
+     * Initializes the object implementing the interface.
+     *
+     * This method is intended for language bindings. If writing in C,
+     * g_initable_new() should typically be used instead.
+     *
+     * The object must be initialized before any real use after initial
+     * construction, either with this function or g_async_initable_init_async().
+     *
+     * Implementations may also support cancellation. If `cancellable` is not %NULL,
+     * then initialization can be cancelled by triggering the cancellable object
+     * from another thread. If the operation was cancelled, the error
+     * %G_IO_ERROR_CANCELLED will be returned. If `cancellable` is not %NULL and
+     * the object doesn't support cancellable initialization the error
+     * %G_IO_ERROR_NOT_SUPPORTED will be returned.
+     *
+     * If the object is not initialized, or initialization returns with an
+     * error, then all operations on the object except g_object_ref() and
+     * g_object_unref() are considered to be invalid, and have undefined
+     * behaviour. See the [description][iface@Gio.Initable#description] for more details.
+     *
+     * Callers should not assume that a class which implements #GInitable can be
+     * initialized multiple times, unless the class explicitly documents itself as
+     * supporting this. Generally, a class’ implementation of init() can assume
+     * (and assert) that it will only be called once. Previously, this documentation
+     * recommended all #GInitable implementations should be idempotent; that
+     * recommendation was relaxed in GLib 2.54.
+     *
+     * If a class explicitly supports being initialized multiple times, it is
+     * recommended that the method is idempotent: multiple calls with the same
+     * arguments should return the same results. Only the first call initializes
+     * the object; further calls return the result of the first call.
+     *
+     * One reason why a class might need to support idempotent initialization is if
+     * it is designed to be used via the singleton pattern, with a
+     * #GObjectClass.constructor that sometimes returns an existing instance.
+     * In this pattern, a caller would expect to be able to call g_initable_init()
+     * on the result of g_object_new(), regardless of whether it is in fact a new
+     * instance.
+     * @param cancellable - optional #GCancellable object, %NULL to ignore.
+     */
     init(cancellable?: Cancellable | null): boolean;
     connect(signal: "closed", handler: (self: DBusConnection, remotePeerVanished: boolean, error: GLib.GError) => void, after?: boolean): number;
     connect(signal: "notify", handler: (self: DBusConnection, pspec: GObject.ParamSpec) => void, after?: boolean): number;