@gtkx/ffi 0.1.45 → 0.1.47

package/dist/generated/gio/dbus-message.js

@@ -3,10 +3,28 @@ import { NativeError, getObject } from "@gtkx/ffi";
 import { UnixFDList } from "./unix-fdlist.js";
 import * as GLib from "../glib/index.js";
 import * as GObject from "../gobject/index.js";
+/**
+ * A type for representing D-Bus messages that can be sent or received
+ * on a [class@Gio.DBusConnection].
+ */
 export class DBusMessage extends GObject.GObject {
+    /**
+     * Creates a new empty #GDBusMessage.
+     */
     constructor(...args) {
         super(...args);
     }
+    /**
+     * Creates a new #GDBusMessage from the data stored at @blob. The byte
+     * order that the message was in can be retrieved using
+     * g_dbus_message_get_byte_order().
+     *
+     * If the `blob` cannot be parsed, contains invalid fields, or contains invalid
+     * headers, %G_IO_ERROR_INVALID_ARGUMENT will be returned.
+     * @param blob - A blob representing a binary D-Bus message.
+     * @param blobLen - The length of @blob.
+     * @param capabilities - A #GDBusCapabilityFlags describing what protocol features are supported.
+     */
     static messageNewFromBlob(blob, blobLen, capabilities) {
         const ptr = call("libgio-2.0.so.0", "g_dbus_message_new_from_blob", [
             {
@@ -27,6 +45,13 @@ export class DBusMessage extends GObject.GObject {
         ], { type: "gobject", borrowed: false });
         return getObject(ptr, DBusMessage);
     }
+    /**
+     * Creates a new #GDBusMessage for a method call.
+     * @param name - A valid D-Bus name or %NULL.
+     * @param path - A valid object path.
+     * @param interface_ - A valid D-Bus interface name or %NULL.
+     * @param method - A valid method name.
+     */
     static messageNewMethodCall(path, method, name, interface_) {
         const ptr = call("libgio-2.0.so.0", "g_dbus_message_new_method_call", [
             {
@@ -50,6 +75,12 @@ export class DBusMessage extends GObject.GObject {
         ], { type: "gobject", borrowed: false });
         return getObject(ptr, DBusMessage);
     }
+    /**
+     * Creates a new #GDBusMessage for a signal emission.
+     * @param path - A valid object path.
+     * @param interface_ - A valid D-Bus interface name.
+     * @param signal - A valid signal name.
+     */
     static messageNewSignal(path, interface_, signal) {
         const ptr = call("libgio-2.0.so.0", "g_dbus_message_new_signal", [
             {
@@ -73,6 +104,12 @@ export class DBusMessage extends GObject.GObject {
             borrowed: false,
         });
     }
+    /**
+     * Utility function to calculate how many bytes are needed to
+     * completely deserialize the D-Bus message stored at @blob.
+     * @param blob - A blob representing a binary D-Bus message.
+     * @param blobLen - The length of `blob` (must be at least 16).
+     */
     static bytesNeeded(blob, blobLen) {
         const error = { value: null };
         const result = call("libgio-2.0.so.0", "g_dbus_message_bytes_needed", [
@@ -104,6 +141,14 @@ export class DBusMessage extends GObject.GObject {
         }
         return result;
     }
+    /**
+     * Copies @message. The copy is a deep copy and the returned
+     * #GDBusMessage is completely identical except that it is guaranteed
+     * to not be locked.
+     *
+     * This operation can fail if e.g. `message` contains file descriptors
+     * and the per-process or system-wide open files limit is reached.
+     */
     copy() {
         const error = { value: null };
         const ptr = call("libgio-2.0.so.0", "g_dbus_message_copy", [
@@ -128,6 +173,12 @@ export class DBusMessage extends GObject.GObject {
         }
         return getObject(ptr, DBusMessage);
     }
+    /**
+     * Convenience to get the first item in the body of @message.
+     *
+     * See [method@Gio.DBusMessage.get_arg0_path] for returning object-path-typed
+     * arg0 values.
+     */
     getArg0() {
         return call("libgio-2.0.so.0", "g_dbus_message_get_arg0", [
             {
@@ -136,6 +187,11 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Convenience to get the first item in the body of @message.
+     *
+     * See [method@Gio.DBusMessage.get_arg0] for returning string-typed arg0 values.
+     */
     getArg0Path() {
         return call("libgio-2.0.so.0", "g_dbus_message_get_arg0_path", [
             {
@@ -144,6 +200,9 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets the body of a message.
+     */
     getBody() {
         const ptr = call("libgio-2.0.so.0", "g_dbus_message_get_body", [
             {
@@ -160,6 +219,9 @@ export class DBusMessage extends GObject.GObject {
             return null;
         return getObject(ptr, GLib.Variant);
     }
+    /**
+     * Gets the byte order of @message.
+     */
     getByteOrder() {
         return call("libgio-2.0.so.0", "g_dbus_message_get_byte_order", [
             {
@@ -168,6 +230,9 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field.
+     */
     getDestination() {
         return call("libgio-2.0.so.0", "g_dbus_message_get_destination", [
             {
@@ -176,6 +241,9 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field.
+     */
     getErrorName() {
         return call("libgio-2.0.so.0", "g_dbus_message_get_error_name", [
             {
@@ -184,6 +252,9 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets the flags for @message.
+     */
     getFlags() {
         return call("libgio-2.0.so.0", "g_dbus_message_get_flags", [
             {
@@ -192,6 +263,13 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Gets a header field on @message.
+     *
+     * The caller is responsible for checking the type of the returned #GVariant
+     * matches what is expected.
+     * @param headerField - A 8-bit unsigned integer (typically a value from the #GDBusMessageHeaderField enumeration)
+     */
     getHeader(headerField) {
         const ptr = call("libgio-2.0.so.0", "g_dbus_message_get_header", [
             {
@@ -212,6 +290,9 @@ export class DBusMessage extends GObject.GObject {
             return null;
         return getObject(ptr, GLib.Variant);
     }
+    /**
+     * Gets an array of all header fields on `message` that are set.
+     */
     getHeaderFields() {
         return call("libgio-2.0.so.0", "g_dbus_message_get_header_fields", [
             {
@@ -220,6 +301,9 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "array", itemType: { type: "int", size: 8, unsigned: true } });
     }
+    /**
+     * Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field.
+     */
     getInterface() {
         return call("libgio-2.0.so.0", "g_dbus_message_get_interface", [
             {
@@ -228,6 +312,11 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Checks whether `message` is locked. To monitor changes to this
+     * value, connect to the #GObject::notify signal to listen for changes
+     * on the #GDBusMessage:locked property.
+     */
     getLocked() {
         return call("libgio-2.0.so.0", "g_dbus_message_get_locked", [
             {
@@ -236,6 +325,9 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field.
+     */
     getMember() {
         return call("libgio-2.0.so.0", "g_dbus_message_get_member", [
             {
@@ -244,6 +336,9 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets the type of @message.
+     */
     getMessageType() {
         return call("libgio-2.0.so.0", "g_dbus_message_get_message_type", [
             {
@@ -252,6 +347,9 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field.
+     */
     getNumUnixFds() {
         return call("libgio-2.0.so.0", "g_dbus_message_get_num_unix_fds", [
             {
@@ -260,6 +358,9 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: true });
     }
+    /**
+     * Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field.
+     */
     getPath() {
         return call("libgio-2.0.so.0", "g_dbus_message_get_path", [
             {
@@ -268,6 +369,9 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field.
+     */
     getReplySerial() {
         return call("libgio-2.0.so.0", "g_dbus_message_get_reply_serial", [
             {
@@ -276,6 +380,9 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: true });
     }
+    /**
+     * Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field.
+     */
     getSender() {
         return call("libgio-2.0.so.0", "g_dbus_message_get_sender", [
             {
@@ -284,6 +391,9 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets the serial for @message.
+     */
     getSerial() {
         return call("libgio-2.0.so.0", "g_dbus_message_get_serial", [
             {
@@ -292,6 +402,11 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: true });
     }
+    /**
+     * Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field.
+     *
+     * This will always be non-%NULL, but may be an empty string.
+     */
     getSignature() {
         return call("libgio-2.0.so.0", "g_dbus_message_get_signature", [
             {
@@ -300,6 +415,17 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets the UNIX file descriptors associated with @message, if any.
+     *
+     * This method is only available on UNIX.
+     *
+     * 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 (list, 5, ...)`.
+     */
     getUnixFdList() {
         const ptr = call("libgio-2.0.so.0", "g_dbus_message_get_unix_fd_list", [
             {
@@ -311,6 +437,9 @@ export class DBusMessage extends GObject.GObject {
             return null;
         return getObject(ptr, UnixFDList);
     }
+    /**
+     * If `message` is locked, does nothing. Otherwise locks the message.
+     */
     lock() {
         call("libgio-2.0.so.0", "g_dbus_message_lock", [
             {
@@ -319,6 +448,11 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Creates a new #GDBusMessage that is an error reply to @method_call_message.
+     * @param errorName - A valid D-Bus error name.
+     * @param errorMessage - The D-Bus error message.
+     */
     newMethodErrorLiteral(errorName, errorMessage) {
         const ptr = call("libgio-2.0.so.0", "g_dbus_message_new_method_error_literal", [
             {
@@ -336,6 +470,9 @@ export class DBusMessage extends GObject.GObject {
         ], { type: "gobject", borrowed: true });
         return getObject(ptr, DBusMessage);
     }
+    /**
+     * Creates a new #GDBusMessage that is a reply to @method_call_message.
+     */
     newMethodReply() {
         const ptr = call("libgio-2.0.so.0", "g_dbus_message_new_method_reply", [
             {
@@ -345,6 +482,41 @@ export class DBusMessage extends GObject.GObject {
         ], { type: "gobject", borrowed: true });
         return getObject(ptr, DBusMessage);
     }
+    /**
+     * Produces a human-readable multi-line description of @message.
+     *
+     * The contents of the description has no ABI guarantees, the contents
+     * and formatting is subject to change at any time. Typical output
+     * looks something like this:
+     * ```
+     * Flags:   none
+     * Version: 0
+     * Serial:  4
+     * Headers:
+     * path -> objectpath '/org/gtk/GDBus/TestObject'
+     * interface -> 'org.gtk.GDBus.TestInterface'
+     * member -> 'GimmeStdout'
+     * destination -> ':1.146'
+     * Body: ()
+     * UNIX File Descriptors:
+     * (none)
+     * ```
+     * or
+     * ```
+     * Flags:   no-reply-expected
+     * Version: 0
+     * Serial:  477
+     * Headers:
+     * reply-serial -> uint32 4
+     * destination -> ':1.159'
+     * sender -> ':1.146'
+     * num-unix-fds -> uint32 1
+     * Body: ()
+     * UNIX File Descriptors:
+     * fd 12: dev=0:10,mode=020620,ino=5,uid=500,gid=5,rdev=136:2,size=0,atime=1273085037,mtime=1273085851,ctime=1272982635
+     * ```
+     * @param indent - Indentation level.
+     */
     print(indent) {
         return call("libgio-2.0.so.0", "g_dbus_message_print", [
             {
@@ -357,6 +529,14 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "string" });
     }
+    /**
+     * Sets the body @message. As a side-effect the
+     * %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field is set to the
+     * type string of `body` (or cleared if `body` is %NULL).
+     *
+     * If `body` is floating, `message` assumes ownership of @body.
+     * @param body - Either %NULL or a #GVariant that is a tuple.
+     */
     setBody(body) {
         call("libgio-2.0.so.0", "g_dbus_message_set_body", [
             {
@@ -374,6 +554,10 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the byte order of @message.
+     * @param byteOrder - The byte order.
+     */
     setByteOrder(byteOrder) {
         call("libgio-2.0.so.0", "g_dbus_message_set_byte_order", [
             {
@@ -386,6 +570,10 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field.
+     * @param value - The value to set.
+     */
     setDestination(value) {
         call("libgio-2.0.so.0", "g_dbus_message_set_destination", [
             {
@@ -399,6 +587,10 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field.
+     * @param value - The value to set.
+     */
     setErrorName(value) {
         call("libgio-2.0.so.0", "g_dbus_message_set_error_name", [
             {
@@ -411,6 +603,10 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the flags to set on @message.
+     * @param flags - Flags for `message` that are set (typically values from the #GDBusMessageFlags
+     */
     setFlags(flags) {
         call("libgio-2.0.so.0", "g_dbus_message_set_flags", [
             {
@@ -423,6 +619,13 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets a header field on @message.
+     *
+     * If `value` is floating, `message` assumes ownership of @value.
+     * @param headerField - A 8-bit unsigned integer (typically a value from the #GDBusMessageHeaderField enumeration)
+     * @param value - A #GVariant to set the header field or %NULL to clear the header field.
+     */
     setHeader(headerField, value) {
         call("libgio-2.0.so.0", "g_dbus_message_set_header", [
             {
@@ -445,6 +648,10 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field.
+     * @param value - The value to set.
+     */
     setInterface(value) {
         call("libgio-2.0.so.0", "g_dbus_message_set_interface", [
             {
@@ -458,6 +665,10 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field.
+     * @param value - The value to set.
+     */
     setMember(value) {
         call("libgio-2.0.so.0", "g_dbus_message_set_member", [
             {
@@ -471,6 +682,10 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets `message` to be of @type.
+     * @param type - A 8-bit unsigned integer (typically a value from the #GDBusMessageType enumeration).
+     */
     setMessageType(type) {
         call("libgio-2.0.so.0", "g_dbus_message_set_message_type", [
             {
@@ -483,6 +698,10 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field.
+     * @param value - The value to set.
+     */
     setNumUnixFds(value) {
         call("libgio-2.0.so.0", "g_dbus_message_set_num_unix_fds", [
             {
@@ -495,6 +714,10 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field.
+     * @param value - The value to set.
+     */
     setPath(value) {
         call("libgio-2.0.so.0", "g_dbus_message_set_path", [
             {
@@ -508,6 +731,10 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field.
+     * @param value - The value to set.
+     */
     setReplySerial(value) {
         call("libgio-2.0.so.0", "g_dbus_message_set_reply_serial", [
             {
@@ -520,6 +747,10 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field.
+     * @param value - The value to set.
+     */
     setSender(value) {
         call("libgio-2.0.so.0", "g_dbus_message_set_sender", [
             {
@@ -533,6 +764,13 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the serial for @message.
+     *
+     * The D-Bus specification
+     * does not allow the `serial` to be zero.
+     * @param serial - A #guint32, which must not be zero.
+     */
     setSerial(serial) {
         call("libgio-2.0.so.0", "g_dbus_message_set_serial", [
             {
@@ -545,6 +783,10 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field.
+     * @param value - The value to set.
+     */
     setSignature(value) {
         call("libgio-2.0.so.0", "g_dbus_message_set_signature", [
             {
@@ -558,6 +800,20 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the UNIX file descriptors associated with @message. As a
+     * side-effect the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header
+     * field is set to the number of fds in `fd_list` (or cleared if
+     * `fd_list` is %NULL).
+     *
+     * This method is only available on UNIX.
+     *
+     * 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 by a value of type
+     * %G_VARIANT_TYPE_HANDLE in the body of the message.
+     * @param fdList - A #GUnixFDList or %NULL.
+     */
     setUnixFdList(fdList) {
         call("libgio-2.0.so.0", "g_dbus_message_set_unix_fd_list", [
             {
@@ -571,6 +827,12 @@ export class DBusMessage extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Serializes `message` to a blob. The byte order returned by
+     * g_dbus_message_get_byte_order() will be used.
+     * @param outSize - Return location for size of generated blob.
+     * @param capabilities - A #GDBusCapabilityFlags describing what protocol features are supported.
+     */
     toBlob(outSize, capabilities) {
         const error = { value: null };
         const result = call("libgio-2.0.so.0", "g_dbus_message_to_blob", [
@@ -606,6 +868,15 @@ export class DBusMessage extends GObject.GObject {
         }
         return result;
     }
+    /**
+     * If `message` is not of type %G_DBUS_MESSAGE_TYPE_ERROR does
+     * nothing and returns %FALSE.
+     *
+     * Otherwise this method encodes the error in `message` as a #GError
+     * using g_dbus_error_set_dbus_error() using the information in the
+     * %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field of `message` as
+     * well as the first string item in @message's body.
+     */
     toGerror() {
         const error = { value: null };
         const result = call("libgio-2.0.so.0", "g_dbus_message_to_gerror", [

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

@@ -3,16 +3,37 @@ import { DBusArgInfo } from "./dbus-arg-info.js";
 export interface DBusMethodInfoInit {
     refCount?: number;
 }
+/** Information about a method on a D-Bus interface. */
 export declare class DBusMethodInfo {
     ptr: unknown;
     constructor(init?: DBusMethodInfoInit);
     protected createPtr(init: DBusMethodInfoInit): unknown;
+    /**
+     * If `info` is statically allocated does nothing. Otherwise increases
+     * the reference count.
+     */
     ref(): DBusMethodInfo;
+    /**
+     * 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 D-Bus method, e.g. @RequestName. */
     get name(): string;
+    /**
+     * A pointer to a %NULL-terminated array of pointers to #GDBusArgInfo structures or %NULL if there are no in arguments.
+     */
     get inArgs(): DBusArgInfo[];
+    /**
+     * A pointer to a %NULL-terminated array of pointers to #GDBusArgInfo structures or %NULL if there are no out arguments.
+     */
     get outArgs(): DBusArgInfo[];
+    /**
+     * A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.
+     */
     get annotations(): DBusAnnotationInfo[];
 }

package/dist/generated/gio/dbus-method-info.js

@@ -1,5 +1,6 @@
 import { alloc, call, read, write } from "@gtkx/native";
 import { getObject } from "@gtkx/ffi";
+/** Information about a method on a D-Bus interface. */
 export class DBusMethodInfo {
     ptr;
     constructor(init = {}) {
@@ -11,6 +12,10 @@ export class DBusMethodInfo {
             write(ptr, { type: "int", size: 32, unsigned: false }, 0, init.refCount);
         return ptr;
     }
+    /**
+     * If `info` is statically allocated does nothing. Otherwise increases
+     * the reference count.
+     */
     ref() {
         const ptr = call("libgio-2.0.so.0", "g_dbus_method_info_ref", [
             {
@@ -25,6 +30,11 @@ export class DBusMethodInfo {
         });
         return getObject(ptr, DBusMethodInfo);
     }
+    /**
+     * 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() {
         call("libgio-2.0.so.0", "g_dbus_method_info_unref", [
             {
@@ -33,15 +43,20 @@ export class DBusMethodInfo {
             },
         ], { type: "undefined" });
     }
+    /** The reference count or -1 if statically allocated. */
     get refCount() {
         return read(this.ptr, { type: "int", size: 32, unsigned: false }, 0);
     }
     set refCount(value) {
         write(this.ptr, { type: "int", size: 32, unsigned: false }, 0, value);
     }
+    /** The name of the D-Bus method, e.g. @RequestName. */
     get name() {
         return read(this.ptr, { type: "string" }, 8);
     }
+    /**
+     * A pointer to a %NULL-terminated array of pointers to #GDBusArgInfo structures or %NULL if there are no in arguments.
+     */
     get inArgs() {
         return read(this.ptr, {
             type: "array",
@@ -52,6 +67,9 @@ export class DBusMethodInfo {
             },
         }, 16);
     }
+    /**
+     * A pointer to a %NULL-terminated array of pointers to #GDBusArgInfo structures or %NULL if there are no out arguments.
+     */
     get outArgs() {
         return read(this.ptr, {
             type: "array",
@@ -62,6 +80,9 @@ export class DBusMethodInfo {
             },
         }, 24);
     }
+    /**
+     * A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.
+     */
     get annotations() {
         return read(this.ptr, {
             type: "array",