@gtkx/ffi 0.1.44 → 0.1.46

package/dist/generated/gio/file-info.js

@@ -3,7 +3,48 @@ import { getObject } from "@gtkx/ffi";
 import { Icon } from "./icon.js";
 import * as GLib from "../glib/index.js";
 import * as GObject from "../gobject/index.js";
+/**
+ * Stores information about a file system object referenced by a [iface@Gio.File].
+ *
+ * Functionality for manipulating basic metadata for files. `GFileInfo`
+ * implements methods for getting information that all files should
+ * contain, and allows for manipulation of extended attributes.
+ *
+ * See the file attributes document for more
+ * information on how GIO handles file attributes.
+ *
+ * To obtain a `GFileInfo` for a [iface@Gio.File], use
+ * [method@Gio.File.query_info] (or its async variant). To obtain a `GFileInfo`
+ * for a file input or output stream, use [method@Gio.FileInputStream.query_info]
+ * or [method@Gio.FileOutputStream.query_info] (or their async variants).
+ *
+ * To change the actual attributes of a file, you should then set the
+ * attribute in the `GFileInfo` and call [method@Gio.File.set_attributes_from_info]
+ * or [method@Gio.File.set_attributes_async] on a `GFile`.
+ *
+ * However, not all attributes can be changed in the file. For instance,
+ * the actual size of a file cannot be changed via [method@Gio.FileInfo.set_size].
+ * You may call [method@Gio.File.query_settable_attributes] and
+ * [method@Gio.File.query_writable_namespaces] to discover the settable attributes
+ * of a particular file at runtime.
+ *
+ * The direct accessors, such as [method@Gio.FileInfo.get_name], are slightly more
+ * optimized than the generic attribute accessors, such as
+ * [method@Gio.FileInfo.get_attribute_byte_string].This optimization will matter
+ * only if calling the API in a tight loop.
+ *
+ * It is an error to call these accessors without specifying their required file
+ * attributes when creating the `GFileInfo`. Use
+ * [method@Gio.FileInfo.has_attribute] or [method@Gio.FileInfo.list_attributes]
+ * to check what attributes are specified for a `GFileInfo`.
+ *
+ * [struct@Gio.FileAttributeMatcher] allows for searching through a `GFileInfo`
+ * for attributes.
+ */
 export class FileInfo extends GObject.GObject {
+    /**
+     * Creates a new file info structure.
+     */
     constructor(...args) {
         super(...args);
     }
@@ -13,6 +54,9 @@ export class FileInfo extends GObject.GObject {
             borrowed: false,
         });
     }
+    /**
+     * Clears the status information from @info.
+     */
     clearStatus() {
         call("libgio-2.0.so.0", "g_file_info_clear_status", [
             {
@@ -21,6 +65,11 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * First clears all of the GFileAttribute of
+     * @dest_info, and then copies all of the file attributes from `src_info` to @dest_info.
+     * @param destInfo - destination to copy attributes to.
+     */
     copyInto(destInfo) {
         call("libgio-2.0.so.0", "g_file_info_copy_into", [
             {
@@ -33,6 +82,9 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Duplicates a file info structure.
+     */
     dup() {
         const ptr = call("libgio-2.0.so.0", "g_file_info_dup", [
             {
@@ -42,6 +94,18 @@ export class FileInfo extends GObject.GObject {
         ], { type: "gobject", borrowed: true });
         return getObject(ptr, FileInfo);
     }
+    /**
+     * Gets the access time of the current `info` and returns it as a
+     * #GDateTime.
+     *
+     * It is an error to call this if the #GFileInfo does not contain
+     * %G_FILE_ATTRIBUTE_TIME_ACCESS. If %G_FILE_ATTRIBUTE_TIME_ACCESS_USEC is
+     * provided, the resulting #GDateTime will additionally have microsecond
+     * precision.
+     *
+     * If nanosecond precision is needed, %G_FILE_ATTRIBUTE_TIME_ACCESS_NSEC must
+     * be queried separately using g_file_info_get_attribute_uint32().
+     */
     getAccessDateTime() {
         const ptr = call("libgio-2.0.so.0", "g_file_info_get_access_date_time", [
             {
@@ -58,6 +122,27 @@ export class FileInfo extends GObject.GObject {
             return null;
         return getObject(ptr, GLib.DateTime);
     }
+    /**
+     * Gets the value of an attribute, formatted as a human readable string.
+     *
+     * This escapes things as needed to make the string valid UTF-8 and readable by
+     * humans. It’s not meant to be a machine readable or reversible escaping
+     * format.
+     *
+     * To format file name attributes of type
+     * [enum@Gio.FileAttributeType.BYTE_STRING] for output as UTF-8, use
+     * [func@GLib.filename_to_utf8] instead:
+     * ```c
+     * const char *trash_orig_path_byte_string;
+     * g_autofree char *trash_orig_path_utf8 = NULL;
+     *
+     * trash_orig_path_byte_string = g_file_info_get_attribute_byte_string (info, G_FILE_ATTRIBUTE_TRASH_ORIG_PATH);
+     * trash_orig_path_utf8 = g_filename_to_utf8 (trash_orig_path_byte_string, -1, NULL, NULL, NULL);
+     * if (trash_orig_path_utf8 != NULL)
+     * g_message ("Some larger UTF-8 string with filename embedded as %s", trash_orig_path_utf8);
+     * ```
+     * @param attribute - a file attribute key.
+     */
     getAttributeAsString(attribute) {
         return call("libgio-2.0.so.0", "g_file_info_get_attribute_as_string", [
             {
@@ -70,6 +155,11 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "string" });
     }
+    /**
+     * Gets the value of a boolean attribute. If the attribute does not
+     * contain a boolean value, %FALSE will be returned.
+     * @param attribute - a file attribute key.
+     */
     getAttributeBoolean(attribute) {
         return call("libgio-2.0.so.0", "g_file_info_get_attribute_boolean", [
             {
@@ -82,6 +172,11 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Gets the value of a byte string attribute. If the attribute does
+     * not contain a byte string, %NULL will be returned.
+     * @param attribute - a file attribute key.
+     */
     getAttributeByteString(attribute) {
         return call("libgio-2.0.so.0", "g_file_info_get_attribute_byte_string", [
             {
@@ -94,6 +189,13 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets the attribute type, value and status for an attribute key.
+     * @param attribute - a file attribute key
+     * @param type - return location for the attribute type, or %NULL
+     * @param valuePp - return location for the
+     * @param status - return location for the attribute status, or %NULL
+     */
     getAttributeData(attribute, type, valuePp, status) {
         return call("libgio-2.0.so.0", "g_file_info_get_attribute_data", [
             {
@@ -130,6 +232,15 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Gets the value of a byte string attribute as a file path.
+     *
+     * If the attribute does not contain a byte string, `NULL` will be returned.
+     *
+     * This function is meant to be used by language bindings that have specific
+     * handling for Unix paths.
+     * @param attribute - a file attribute key.
+     */
     getAttributeFilePath(attribute) {
         return call("libgio-2.0.so.0", "g_file_info_get_attribute_file_path", [
             {
@@ -142,6 +253,12 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets a signed 32-bit integer contained within the attribute. If the
+     * attribute does not contain a signed 32-bit integer, or is invalid,
+     * 0 will be returned.
+     * @param attribute - a file attribute key.
+     */
     getAttributeInt32(attribute) {
         return call("libgio-2.0.so.0", "g_file_info_get_attribute_int32", [
             {
@@ -154,6 +271,12 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Gets a signed 64-bit integer contained within the attribute. If the
+     * attribute does not contain a signed 64-bit integer, or is invalid,
+     * 0 will be returned.
+     * @param attribute - a file attribute key.
+     */
     getAttributeInt64(attribute) {
         return call("libgio-2.0.so.0", "g_file_info_get_attribute_int64", [
             {
@@ -166,6 +289,11 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "int", size: 64, unsigned: false });
     }
+    /**
+     * Gets the value of a #GObject attribute. If the attribute does
+     * not contain a #GObject, %NULL will be returned.
+     * @param attribute - a file attribute key.
+     */
     getAttributeObject(attribute) {
         const ptr = call("libgio-2.0.so.0", "g_file_info_get_attribute_object", [
             {
@@ -181,6 +309,10 @@ export class FileInfo extends GObject.GObject {
             return null;
         return getObject(ptr, GObject.GObject);
     }
+    /**
+     * Gets the attribute status for an attribute key.
+     * @param attribute - a file attribute key
+     */
     getAttributeStatus(attribute) {
         return call("libgio-2.0.so.0", "g_file_info_get_attribute_status", [
             {
@@ -193,6 +325,11 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Gets the value of a string attribute. If the attribute does
+     * not contain a string, %NULL will be returned.
+     * @param attribute - a file attribute key.
+     */
     getAttributeString(attribute) {
         return call("libgio-2.0.so.0", "g_file_info_get_attribute_string", [
             {
@@ -205,6 +342,11 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets the value of a stringv attribute. If the attribute does
+     * not contain a stringv, %NULL will be returned.
+     * @param attribute - a file attribute key.
+     */
     getAttributeStringv(attribute) {
         return call("libgio-2.0.so.0", "g_file_info_get_attribute_stringv", [
             {
@@ -217,6 +359,10 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "array", itemType: { type: "string" } });
     }
+    /**
+     * Gets the attribute type for an attribute key.
+     * @param attribute - a file attribute key.
+     */
     getAttributeType(attribute) {
         return call("libgio-2.0.so.0", "g_file_info_get_attribute_type", [
             {
@@ -229,6 +375,12 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Gets an unsigned 32-bit integer contained within the attribute. If the
+     * attribute does not contain an unsigned 32-bit integer, or is invalid,
+     * 0 will be returned.
+     * @param attribute - a file attribute key.
+     */
     getAttributeUint32(attribute) {
         return call("libgio-2.0.so.0", "g_file_info_get_attribute_uint32", [
             {
@@ -241,6 +393,12 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: true });
     }
+    /**
+     * Gets a unsigned 64-bit integer contained within the attribute. If the
+     * attribute does not contain an unsigned 64-bit integer, or is invalid,
+     * 0 will be returned.
+     * @param attribute - a file attribute key.
+     */
     getAttributeUint64(attribute) {
         return call("libgio-2.0.so.0", "g_file_info_get_attribute_uint64", [
             {
@@ -253,6 +411,12 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "int", size: 64, unsigned: true });
     }
+    /**
+     * Gets the file's content type.
+     *
+     * It is an error to call this if the #GFileInfo does not contain
+     * %G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE.
+     */
     getContentType() {
         return call("libgio-2.0.so.0", "g_file_info_get_content_type", [
             {
@@ -261,6 +425,18 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets the creation time of the current `info` and returns it as a
+     * #GDateTime.
+     *
+     * It is an error to call this if the #GFileInfo does not contain
+     * %G_FILE_ATTRIBUTE_TIME_CREATED. If %G_FILE_ATTRIBUTE_TIME_CREATED_USEC is
+     * provided, the resulting #GDateTime will additionally have microsecond
+     * precision.
+     *
+     * If nanosecond precision is needed, %G_FILE_ATTRIBUTE_TIME_CREATED_NSEC must
+     * be queried separately using g_file_info_get_attribute_uint32().
+     */
     getCreationDateTime() {
         const ptr = call("libgio-2.0.so.0", "g_file_info_get_creation_date_time", [
             {
@@ -277,6 +453,11 @@ export class FileInfo extends GObject.GObject {
             return null;
         return getObject(ptr, GLib.DateTime);
     }
+    /**
+     * Returns the #GDateTime representing the deletion date of the file, as
+     * available in %G_FILE_ATTRIBUTE_TRASH_DELETION_DATE. If the
+     * %G_FILE_ATTRIBUTE_TRASH_DELETION_DATE attribute is unset, %NULL is returned.
+     */
     getDeletionDate() {
         const ptr = call("libgio-2.0.so.0", "g_file_info_get_deletion_date", [
             {
@@ -293,6 +474,12 @@ export class FileInfo extends GObject.GObject {
             return null;
         return getObject(ptr, GLib.DateTime);
     }
+    /**
+     * Gets a display name for a file. This is guaranteed to always be set.
+     *
+     * It is an error to call this if the #GFileInfo does not contain
+     * %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME.
+     */
     getDisplayName() {
         return call("libgio-2.0.so.0", "g_file_info_get_display_name", [
             {
@@ -301,6 +488,12 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets the edit name for a file.
+     *
+     * It is an error to call this if the #GFileInfo does not contain
+     * %G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME.
+     */
     getEditName() {
         return call("libgio-2.0.so.0", "g_file_info_get_edit_name", [
             {
@@ -309,6 +502,13 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets the [entity tag][iface@Gio.File#entity-tags] for a given
+     * #GFileInfo. See %G_FILE_ATTRIBUTE_ETAG_VALUE.
+     *
+     * It is an error to call this if the #GFileInfo does not contain
+     * %G_FILE_ATTRIBUTE_ETAG_VALUE.
+     */
     getEtag() {
         return call("libgio-2.0.so.0", "g_file_info_get_etag", [
             {
@@ -317,6 +517,13 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets a file's type (whether it is a regular file, symlink, etc).
+     * This is different from the file's content type, see g_file_info_get_content_type().
+     *
+     * It is an error to call this if the #GFileInfo does not contain
+     * %G_FILE_ATTRIBUTE_STANDARD_TYPE.
+     */
     getFileType() {
         return call("libgio-2.0.so.0", "g_file_info_get_file_type", [
             {
@@ -325,6 +532,12 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Gets the icon for a file.
+     *
+     * It is an error to call this if the #GFileInfo does not contain
+     * %G_FILE_ATTRIBUTE_STANDARD_ICON.
+     */
     getIcon() {
         const ptr = call("libgio-2.0.so.0", "g_file_info_get_icon", [
             {
@@ -336,6 +549,12 @@ export class FileInfo extends GObject.GObject {
             return null;
         return getObject(ptr, Icon);
     }
+    /**
+     * Checks if a file is a backup file.
+     *
+     * It is an error to call this if the #GFileInfo does not contain
+     * %G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP.
+     */
     getIsBackup() {
         return call("libgio-2.0.so.0", "g_file_info_get_is_backup", [
             {
@@ -344,6 +563,12 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Checks if a file is hidden.
+     *
+     * It is an error to call this if the #GFileInfo does not contain
+     * %G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN.
+     */
     getIsHidden() {
         return call("libgio-2.0.so.0", "g_file_info_get_is_hidden", [
             {
@@ -352,6 +577,12 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Checks if a file is a symlink.
+     *
+     * It is an error to call this if the #GFileInfo does not contain
+     * %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK.
+     */
     getIsSymlink() {
         return call("libgio-2.0.so.0", "g_file_info_get_is_symlink", [
             {
@@ -360,6 +591,18 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Gets the modification time of the current `info` and returns it as a
+     * #GDateTime.
+     *
+     * It is an error to call this if the #GFileInfo does not contain
+     * %G_FILE_ATTRIBUTE_TIME_MODIFIED. If %G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC is
+     * provided, the resulting #GDateTime will additionally have microsecond
+     * precision.
+     *
+     * If nanosecond precision is needed, %G_FILE_ATTRIBUTE_TIME_MODIFIED_NSEC must
+     * be queried separately using g_file_info_get_attribute_uint32().
+     */
     getModificationDateTime() {
         const ptr = call("libgio-2.0.so.0", "g_file_info_get_modification_date_time", [
             {
@@ -376,6 +619,15 @@ export class FileInfo extends GObject.GObject {
             return null;
         return getObject(ptr, GLib.DateTime);
     }
+    /**
+     * Gets the modification time of the current `info` and sets it
+     * in @result.
+     *
+     * It is an error to call this if the #GFileInfo does not contain
+     * %G_FILE_ATTRIBUTE_TIME_MODIFIED. If %G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC is
+     * provided it will be used too.
+     * @param result - a #GTimeVal.
+     */
     getModificationTime(result) {
         call("libgio-2.0.so.0", "g_file_info_get_modification_time", [
             {
@@ -391,6 +643,12 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Gets the name for a file. This is guaranteed to always be set.
+     *
+     * It is an error to call this if the #GFileInfo does not contain
+     * %G_FILE_ATTRIBUTE_STANDARD_NAME.
+     */
     getName() {
         return call("libgio-2.0.so.0", "g_file_info_get_name", [
             {
@@ -399,6 +657,14 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets the file's size (in bytes). The size is retrieved through the value of
+     * the %G_FILE_ATTRIBUTE_STANDARD_SIZE attribute and is converted
+     * from #guint64 to #goffset before returning the result.
+     *
+     * It is an error to call this if the #GFileInfo does not contain
+     * %G_FILE_ATTRIBUTE_STANDARD_SIZE.
+     */
     getSize() {
         return call("libgio-2.0.so.0", "g_file_info_get_size", [
             {
@@ -407,6 +673,13 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "int", size: 64, unsigned: false });
     }
+    /**
+     * Gets the value of the sort_order attribute from the #GFileInfo.
+     * See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.
+     *
+     * It is an error to call this if the #GFileInfo does not contain
+     * %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.
+     */
     getSortOrder() {
         return call("libgio-2.0.so.0", "g_file_info_get_sort_order", [
             {
@@ -415,6 +688,12 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Gets the symbolic icon for a file.
+     *
+     * It is an error to call this if the #GFileInfo does not contain
+     * %G_FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON.
+     */
     getSymbolicIcon() {
         const ptr = call("libgio-2.0.so.0", "g_file_info_get_symbolic_icon", [
             {
@@ -426,6 +705,12 @@ export class FileInfo extends GObject.GObject {
             return null;
         return getObject(ptr, Icon);
     }
+    /**
+     * Gets the symlink target for a given #GFileInfo.
+     *
+     * It is an error to call this if the #GFileInfo does not contain
+     * %G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET.
+     */
     getSymlinkTarget() {
         return call("libgio-2.0.so.0", "g_file_info_get_symlink_target", [
             {
@@ -434,6 +719,10 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Checks if a file info structure has an attribute named @attribute.
+     * @param attribute - a file attribute key.
+     */
     hasAttribute(attribute) {
         return call("libgio-2.0.so.0", "g_file_info_has_attribute", [
             {
@@ -446,6 +735,11 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Checks if a file info structure has an attribute in the
+     * specified @name_space.
+     * @param nameSpace - a file attribute namespace.
+     */
     hasNamespace(nameSpace) {
         return call("libgio-2.0.so.0", "g_file_info_has_namespace", [
             {
@@ -458,6 +752,10 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Lists the file info structure's attributes.
+     * @param nameSpace - a file attribute key's namespace, or %NULL to list
+     */
     listAttributes(nameSpace) {
         return call("libgio-2.0.so.0", "g_file_info_list_attributes", [
             {
@@ -471,6 +769,10 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "array", itemType: { type: "string" } });
     }
+    /**
+     * Removes all cases of `attribute` from `info` if it exists.
+     * @param attribute - a file attribute key.
+     */
     removeAttribute(attribute) {
         call("libgio-2.0.so.0", "g_file_info_remove_attribute", [
             {
@@ -483,6 +785,14 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the %G_FILE_ATTRIBUTE_TIME_ACCESS and
+     * %G_FILE_ATTRIBUTE_TIME_ACCESS_USEC attributes in the file info to the
+     * given date/time value.
+     *
+     * %G_FILE_ATTRIBUTE_TIME_ACCESS_NSEC will be cleared.
+     * @param atime - a #GDateTime.
+     */
     setAccessDateTime(atime) {
         call("libgio-2.0.so.0", "g_file_info_set_access_date_time", [
             {
@@ -500,6 +810,13 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the `attribute` to contain the given value, if possible. To unset the
+     * attribute, use %G_FILE_ATTRIBUTE_TYPE_INVALID for @type.
+     * @param attribute - a file attribute key.
+     * @param type - a #GFileAttributeType
+     * @param valueP - pointer to the value
+     */
     setAttribute(attribute, type, valueP) {
         call("libgio-2.0.so.0", "g_file_info_set_attribute", [
             {
@@ -520,6 +837,12 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the `attribute` to contain the given @attr_value,
+     * if possible.
+     * @param attribute - a file attribute key.
+     * @param attrValue - a boolean value.
+     */
     setAttributeBoolean(attribute, attrValue) {
         call("libgio-2.0.so.0", "g_file_info_set_attribute_boolean", [
             {
@@ -536,6 +859,12 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the `attribute` to contain the given @attr_value,
+     * if possible.
+     * @param attribute - a file attribute key.
+     * @param attrValue - a byte string.
+     */
     setAttributeByteString(attribute, attrValue) {
         call("libgio-2.0.so.0", "g_file_info_set_attribute_byte_string", [
             {
@@ -552,6 +881,15 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the `attribute` to contain the given @attr_value,
+     * if possible.
+     *
+     * This function is meant to be used by language bindings that have specific
+     * handling for Unix paths.
+     * @param attribute - a file attribute key.
+     * @param attrValue - a file path.
+     */
     setAttributeFilePath(attribute, attrValue) {
         call("libgio-2.0.so.0", "g_file_info_set_attribute_file_path", [
             {
@@ -568,6 +906,12 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the `attribute` to contain the given @attr_value,
+     * if possible.
+     * @param attribute - a file attribute key.
+     * @param attrValue - a signed 32-bit integer
+     */
     setAttributeInt32(attribute, attrValue) {
         call("libgio-2.0.so.0", "g_file_info_set_attribute_int32", [
             {
@@ -584,6 +928,12 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the `attribute` to contain the given @attr_value,
+     * if possible.
+     * @param attribute - attribute name to set.
+     * @param attrValue - int64 value to set attribute to.
+     */
     setAttributeInt64(attribute, attrValue) {
         call("libgio-2.0.so.0", "g_file_info_set_attribute_int64", [
             {
@@ -600,6 +950,10 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets `mask` on `info` to match specific attribute types.
+     * @param mask - a #GFileAttributeMatcher.
+     */
     setAttributeMask(mask) {
         call("libgio-2.0.so.0", "g_file_info_set_attribute_mask", [
             {
@@ -617,6 +971,12 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the `attribute` to contain the given @attr_value,
+     * if possible.
+     * @param attribute - a file attribute key.
+     * @param attrValue - a #GObject.
+     */
     setAttributeObject(attribute, attrValue) {
         call("libgio-2.0.so.0", "g_file_info_set_attribute_object", [
             {
@@ -633,6 +993,16 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the attribute status for an attribute key. This is only
+     * needed by external code that implement g_file_set_attributes_from_info()
+     * or similar functions.
+     *
+     * The attribute must exist in `info` for this to work. Otherwise %FALSE
+     * is returned and `info` is unchanged.
+     * @param attribute - a file attribute key
+     * @param status - a #GFileAttributeStatus
+     */
     setAttributeStatus(attribute, status) {
         return call("libgio-2.0.so.0", "g_file_info_set_attribute_status", [
             {
@@ -649,6 +1019,12 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Sets the `attribute` to contain the given @attr_value,
+     * if possible.
+     * @param attribute - a file attribute key.
+     * @param attrValue - a UTF-8 string.
+     */
     setAttributeString(attribute, attrValue) {
         call("libgio-2.0.so.0", "g_file_info_set_attribute_string", [
             {
@@ -665,6 +1041,14 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the `attribute` to contain the given @attr_value,
+     * if possible.
+     *
+     * Sinze: 2.22
+     * @param attribute - a file attribute key
+     * @param attrValue - a %NULL
+     */
     setAttributeStringv(attribute, attrValue) {
         call("libgio-2.0.so.0", "g_file_info_set_attribute_stringv", [
             {
@@ -681,6 +1065,12 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the `attribute` to contain the given @attr_value,
+     * if possible.
+     * @param attribute - a file attribute key.
+     * @param attrValue - an unsigned 32-bit integer.
+     */
     setAttributeUint32(attribute, attrValue) {
         call("libgio-2.0.so.0", "g_file_info_set_attribute_uint32", [
             {
@@ -697,6 +1087,12 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the `attribute` to contain the given @attr_value,
+     * if possible.
+     * @param attribute - a file attribute key.
+     * @param attrValue - an unsigned 64-bit integer.
+     */
     setAttributeUint64(attribute, attrValue) {
         call("libgio-2.0.so.0", "g_file_info_set_attribute_uint64", [
             {
@@ -713,6 +1109,11 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the content type attribute for a given #GFileInfo.
+     * See %G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE.
+     * @param contentType - a content type.
+     */
     setContentType(contentType) {
         call("libgio-2.0.so.0", "g_file_info_set_content_type", [
             {
@@ -725,6 +1126,14 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the %G_FILE_ATTRIBUTE_TIME_CREATED and
+     * %G_FILE_ATTRIBUTE_TIME_CREATED_USEC attributes in the file info to the
+     * given date/time value.
+     *
+     * %G_FILE_ATTRIBUTE_TIME_CREATED_NSEC will be cleared.
+     * @param creationTime - a #GDateTime.
+     */
     setCreationDateTime(creationTime) {
         call("libgio-2.0.so.0", "g_file_info_set_creation_date_time", [
             {
@@ -742,6 +1151,11 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the display name for the current #GFileInfo.
+     * See %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME.
+     * @param displayName - a string containing a display name.
+     */
     setDisplayName(displayName) {
         call("libgio-2.0.so.0", "g_file_info_set_display_name", [
             {
@@ -754,6 +1168,11 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the edit name for the current file.
+     * See %G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME.
+     * @param editName - a string containing an edit name.
+     */
     setEditName(editName) {
         call("libgio-2.0.so.0", "g_file_info_set_edit_name", [
             {
@@ -766,6 +1185,11 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the file type in a #GFileInfo to @type.
+     * See %G_FILE_ATTRIBUTE_STANDARD_TYPE.
+     * @param type - a #GFileType.
+     */
     setFileType(type) {
         call("libgio-2.0.so.0", "g_file_info_set_file_type", [
             {
@@ -778,6 +1202,11 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the icon for a given #GFileInfo.
+     * See %G_FILE_ATTRIBUTE_STANDARD_ICON.
+     * @param icon - a #GIcon.
+     */
     setIcon(icon) {
         call("libgio-2.0.so.0", "g_file_info_set_icon", [
             {
@@ -790,6 +1219,11 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the "is_hidden" attribute in a #GFileInfo according to @is_hidden.
+     * See %G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN.
+     * @param isHidden - a #gboolean.
+     */
     setIsHidden(isHidden) {
         call("libgio-2.0.so.0", "g_file_info_set_is_hidden", [
             {
@@ -802,6 +1236,11 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the "is_symlink" attribute in a #GFileInfo according to @is_symlink.
+     * See %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK.
+     * @param isSymlink - a #gboolean.
+     */
     setIsSymlink(isSymlink) {
         call("libgio-2.0.so.0", "g_file_info_set_is_symlink", [
             {
@@ -814,6 +1253,14 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the %G_FILE_ATTRIBUTE_TIME_MODIFIED and
+     * %G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC attributes in the file info to the
+     * given date/time value.
+     *
+     * %G_FILE_ATTRIBUTE_TIME_MODIFIED_NSEC will be cleared.
+     * @param mtime - a #GDateTime.
+     */
     setModificationDateTime(mtime) {
         call("libgio-2.0.so.0", "g_file_info_set_modification_date_time", [
             {
@@ -831,6 +1278,14 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the %G_FILE_ATTRIBUTE_TIME_MODIFIED and
+     * %G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC attributes in the file info to the
+     * given time value.
+     *
+     * %G_FILE_ATTRIBUTE_TIME_MODIFIED_NSEC will be cleared.
+     * @param mtime - a #GTimeVal.
+     */
     setModificationTime(mtime) {
         call("libgio-2.0.so.0", "g_file_info_set_modification_time", [
             {
@@ -843,6 +1298,11 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the name attribute for the current #GFileInfo.
+     * See %G_FILE_ATTRIBUTE_STANDARD_NAME.
+     * @param name - a string containing a name.
+     */
     setName(name) {
         call("libgio-2.0.so.0", "g_file_info_set_name", [
             {
@@ -855,6 +1315,11 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the %G_FILE_ATTRIBUTE_STANDARD_SIZE attribute in the file info
+     * to the given size.
+     * @param size - a #goffset containing the file's size.
+     */
     setSize(size) {
         call("libgio-2.0.so.0", "g_file_info_set_size", [
             {
@@ -867,6 +1332,11 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the sort order attribute in the file info structure. See
+     * %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.
+     * @param sortOrder - a sort order integer.
+     */
     setSortOrder(sortOrder) {
         call("libgio-2.0.so.0", "g_file_info_set_sort_order", [
             {
@@ -879,6 +1349,11 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the symbolic icon for a given #GFileInfo.
+     * See %G_FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON.
+     * @param icon - a #GIcon.
+     */
     setSymbolicIcon(icon) {
         call("libgio-2.0.so.0", "g_file_info_set_symbolic_icon", [
             {
@@ -891,6 +1366,11 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the %G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET attribute in the file info
+     * to the given symlink target.
+     * @param symlinkTarget - a static string containing a path to a symlink target.
+     */
     setSymlinkTarget(symlinkTarget) {
         call("libgio-2.0.so.0", "g_file_info_set_symlink_target", [
             {
@@ -903,6 +1383,10 @@ export class FileInfo extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Unsets a mask set by g_file_info_set_attribute_mask(), if one
+     * is set.
+     */
     unsetAttributeMask() {
         call("libgio-2.0.so.0", "g_file_info_unset_attribute_mask", [
             {