@gtkx/ffi 0.9.1 → 0.9.3

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

@@ -1,12 +1,12 @@
 import { call } from "../../batch.js";
-import { getObject } from "../../native/object.js";
+import { getNativeObject } from "../../native/object.js";
 import { isInstantiating, setInstantiating } from "../../native/base.js";
 import { registerNativeClass } from "../../registry.js";
 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].
+ * Stores information about a file system object referenced by a {@link Gio.File}.
  *
  * Functionality for manipulating basic metadata for files. `GFileInfo`
  * implements methods for getting information that all files should
@@ -15,32 +15,32 @@ import * as GObject from "../gobject/index.js";
  * 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 obtain a `GFileInfo` for a {@link Gio.File}, use
+ * {@link Gio.File.query_info} (or its async variant). To obtain a `GFileInfo`
+ * for a file input or output stream, use {@link Gio.FileInputStream.query_info}
+ * or {@link 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`.
+ * attribute in the `GFileInfo` and call {@link Gio.File.set_attributes_from_info}
+ * or {@link 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
+ * the actual size of a file cannot be changed via {@link Gio.FileInfo.set_size}.
+ * You may call {@link Gio.File.query_settable_attributes} and
+ * {@link 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
+ * The direct accessors, such as {@link 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
+ * {@link 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]
+ * {@link Gio.FileInfo.has_attribute} or {@link Gio.FileInfo.list_attributes}
  * to check what attributes are specified for a `GFileInfo`.
  *
- * [struct@Gio.FileAttributeMatcher] allows for searching through a `GFileInfo`
+ * {@link Gio.FileAttributeMatcher} allows for searching through a `GFileInfo`
  * for attributes.
  */
 export class FileInfo extends GObject.GObject {
@@ -66,7 +66,7 @@ export class FileInfo extends GObject.GObject {
         }
     }
     /**
-     * Clears the status information from @info.
+     * Clears the status information from `info`.
      */
     clearStatus() {
         call("libgio-2.0.so.0", "g_file_info_clear_status", [
@@ -78,7 +78,7 @@ export class FileInfo extends GObject.GObject {
     }
     /**
      * First clears all of the GFileAttribute of
-     * @dest_info, and then copies all of the file attributes from `src_info` to @dest_info.
+     * `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) {
@@ -103,7 +103,7 @@ export class FileInfo extends GObject.GObject {
                 value: this.id,
             },
         ], { type: "gobject", borrowed: true });
-        return getObject(ptr);
+        return getNativeObject(ptr);
     }
     /**
      * Gets the access time of the current `info` and returns it as a
@@ -127,11 +127,12 @@ export class FileInfo extends GObject.GObject {
             type: "boxed",
             borrowed: true,
             innerType: "GDateTime",
-            lib: "libgio-2.0.so.0",
+            lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
+            getTypeFn: "g_date_time_get_type",
         });
         if (ptr === null)
             return null;
-        return getObject(ptr, GLib.DateTime);
+        return getNativeObject(ptr, GLib.DateTime);
     }
     /**
      * Gets the value of an attribute, formatted as a human readable string.
@@ -141,8 +142,8 @@ export class FileInfo extends GObject.GObject {
      * 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:
+     * {@link Gio.FileAttributeType.BYTE_STRING} for output as UTF-8, use
+     * {@link GLib.filename_to_utf8} instead:
      * ```c
      * const char *trash_orig_path_byte_string;
      * g_autofree char *trash_orig_path_utf8 = NULL;
@@ -318,7 +319,7 @@ export class FileInfo extends GObject.GObject {
         ], { type: "gobject", borrowed: true });
         if (ptr === null)
             return null;
-        return getObject(ptr);
+        return getNativeObject(ptr);
     }
     /**
      * Gets the attribute status for an attribute key.
@@ -458,11 +459,12 @@ export class FileInfo extends GObject.GObject {
             type: "boxed",
             borrowed: true,
             innerType: "GDateTime",
-            lib: "libgio-2.0.so.0",
+            lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
+            getTypeFn: "g_date_time_get_type",
         });
         if (ptr === null)
             return null;
-        return getObject(ptr, GLib.DateTime);
+        return getNativeObject(ptr, GLib.DateTime);
     }
     /**
      * Returns the #GDateTime representing the deletion date of the file, as
@@ -479,11 +481,12 @@ export class FileInfo extends GObject.GObject {
             type: "boxed",
             borrowed: true,
             innerType: "GDateTime",
-            lib: "libgio-2.0.so.0",
+            lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
+            getTypeFn: "g_date_time_get_type",
         });
         if (ptr === null)
             return null;
-        return getObject(ptr, GLib.DateTime);
+        return getNativeObject(ptr, GLib.DateTime);
     }
     /**
      * Gets a display name for a file. This is guaranteed to always be set.
@@ -514,7 +517,7 @@ export class FileInfo extends GObject.GObject {
         ], { type: "string", borrowed: true });
     }
     /**
-     * Gets the [entity tag][iface@Gio.File#entity-tags] for a given
+     * Gets the [entity tag]{@link 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
@@ -558,7 +561,7 @@ export class FileInfo extends GObject.GObject {
         ], { type: "gobject", borrowed: true });
         if (ptr === null)
             return null;
-        return getObject(ptr, Icon);
+        return getNativeObject(ptr, Icon);
     }
     /**
      * Checks if a file is a backup file.
@@ -624,15 +627,16 @@ export class FileInfo extends GObject.GObject {
             type: "boxed",
             borrowed: true,
             innerType: "GDateTime",
-            lib: "libgio-2.0.so.0",
+            lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
+            getTypeFn: "g_date_time_get_type",
         });
         if (ptr === null)
             return null;
-        return getObject(ptr, GLib.DateTime);
+        return getNativeObject(ptr, GLib.DateTime);
     }
     /**
      * Gets the modification time of the current `info` and sets it
-     * in @result.
+     * 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
@@ -714,7 +718,7 @@ export class FileInfo extends GObject.GObject {
         ], { type: "gobject", borrowed: true });
         if (ptr === null)
             return null;
-        return getObject(ptr, Icon);
+        return getNativeObject(ptr, Icon);
     }
     /**
      * Gets the symlink target for a given #GFileInfo.
@@ -731,7 +735,7 @@ export class FileInfo extends GObject.GObject {
         ], { type: "string", borrowed: true });
     }
     /**
-     * Checks if a file info structure has an attribute named @attribute.
+     * Checks if a file info structure has an attribute named `attribute`.
      * @param attribute - a file attribute key.
      */
     hasAttribute(attribute) {
@@ -748,7 +752,7 @@ export class FileInfo extends GObject.GObject {
     }
     /**
      * Checks if a file info structure has an attribute in the
-     * specified @name_space.
+     * specified `name_space`.
      * @param nameSpace - a file attribute namespace.
      */
     hasNamespace(nameSpace) {
@@ -815,7 +819,8 @@ export class FileInfo extends GObject.GObject {
                     type: "boxed",
                     borrowed: true,
                     innerType: "GDateTime",
-                    lib: "libgio-2.0.so.0",
+                    lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
+                    getTypeFn: "g_date_time_get_type",
                 },
                 value: atime?.id ?? atime,
             },
@@ -823,7 +828,7 @@ export class FileInfo extends GObject.GObject {
     }
     /**
      * Sets the `attribute` to contain the given value, if possible. To unset the
-     * attribute, use %G_FILE_ATTRIBUTE_TYPE_INVALID for @type.
+     * 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
@@ -849,7 +854,7 @@ export class FileInfo extends GObject.GObject {
         ], { type: "undefined" });
     }
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * Sets the `attribute` to contain the given `attr_value`,
      * if possible.
      * @param attribute - a file attribute key.
      * @param attrValue - a boolean value.
@@ -871,7 +876,7 @@ export class FileInfo extends GObject.GObject {
         ], { type: "undefined" });
     }
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * Sets the `attribute` to contain the given `attr_value`,
      * if possible.
      * @param attribute - a file attribute key.
      * @param attrValue - a byte string.
@@ -893,7 +898,7 @@ export class FileInfo extends GObject.GObject {
         ], { type: "undefined" });
     }
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * Sets the `attribute` to contain the given `attr_value`,
      * if possible.
      *
      * This function is meant to be used by language bindings that have specific
@@ -918,7 +923,7 @@ export class FileInfo extends GObject.GObject {
         ], { type: "undefined" });
     }
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * Sets the `attribute` to contain the given `attr_value`,
      * if possible.
      * @param attribute - a file attribute key.
      * @param attrValue - a signed 32-bit integer
@@ -940,7 +945,7 @@ export class FileInfo extends GObject.GObject {
         ], { type: "undefined" });
     }
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * 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.
@@ -977,13 +982,14 @@ export class FileInfo extends GObject.GObject {
                     borrowed: true,
                     innerType: "GFileAttributeMatcher",
                     lib: "libgio-2.0.so.0",
+                    getTypeFn: "g_file_attribute_matcher_get_type",
                 },
                 value: mask?.id ?? mask,
             },
         ], { type: "undefined" });
     }
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * Sets the `attribute` to contain the given `attr_value`,
      * if possible.
      * @param attribute - a file attribute key.
      * @param attrValue - a #GObject.
@@ -1031,7 +1037,7 @@ export class FileInfo extends GObject.GObject {
         ], { type: "boolean" });
     }
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * Sets the `attribute` to contain the given `attr_value`,
      * if possible.
      * @param attribute - a file attribute key.
      * @param attrValue - a UTF-8 string.
@@ -1053,7 +1059,7 @@ export class FileInfo extends GObject.GObject {
         ], { type: "undefined" });
     }
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * Sets the `attribute` to contain the given `attr_value`,
      * if possible.
      *
      * Sinze: 2.22
@@ -1077,7 +1083,7 @@ export class FileInfo extends GObject.GObject {
         ], { type: "undefined" });
     }
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * Sets the `attribute` to contain the given `attr_value`,
      * if possible.
      * @param attribute - a file attribute key.
      * @param attrValue - an unsigned 32-bit integer.
@@ -1099,7 +1105,7 @@ export class FileInfo extends GObject.GObject {
         ], { type: "undefined" });
     }
     /**
-     * Sets the `attribute` to contain the given @attr_value,
+     * Sets the `attribute` to contain the given `attr_value`,
      * if possible.
      * @param attribute - a file attribute key.
      * @param attrValue - an unsigned 64-bit integer.
@@ -1156,7 +1162,8 @@ export class FileInfo extends GObject.GObject {
                     type: "boxed",
                     borrowed: true,
                     innerType: "GDateTime",
-                    lib: "libgio-2.0.so.0",
+                    lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
+                    getTypeFn: "g_date_time_get_type",
                 },
                 value: creationTime?.id ?? creationTime,
             },
@@ -1197,7 +1204,7 @@ export class FileInfo extends GObject.GObject {
         ], { type: "undefined" });
     }
     /**
-     * Sets the file type in a #GFileInfo to @type.
+     * Sets the file type in a #GFileInfo to `type`.
      * See %G_FILE_ATTRIBUTE_STANDARD_TYPE.
      * @param type - a #GFileType.
      */
@@ -1231,7 +1238,7 @@ export class FileInfo extends GObject.GObject {
         ], { type: "undefined" });
     }
     /**
-     * Sets the "is_hidden" attribute in a #GFileInfo according to @is_hidden.
+     * Sets the "is_hidden" attribute in a #GFileInfo according to `is_hidden`.
      * See %G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN.
      * @param isHidden - a #gboolean.
      */
@@ -1248,7 +1255,7 @@ export class FileInfo extends GObject.GObject {
         ], { type: "undefined" });
     }
     /**
-     * Sets the "is_symlink" attribute in a #GFileInfo according to @is_symlink.
+     * Sets the "is_symlink" attribute in a #GFileInfo according to `is_symlink`.
      * See %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK.
      * @param isSymlink - a #gboolean.
      */
@@ -1283,7 +1290,8 @@ export class FileInfo extends GObject.GObject {
                     type: "boxed",
                     borrowed: true,
                     innerType: "GDateTime",
-                    lib: "libgio-2.0.so.0",
+                    lib: "libgobject-2.0.so.0,libglib-2.0.so.0",
+                    getTypeFn: "g_date_time_get_type",
                 },
                 value: mtime?.id ?? mtime,
             },
@@ -1411,7 +1419,7 @@ export class FileInfo extends GObject.GObject {
         const argTypes = [selfType];
         const returnType = undefined;
         const wrappedHandler = (...args) => {
-            const self = getObject(args[0]);
+            const self = getNativeObject(args[0]);
             return handler(self, ...args.slice(1));
         };
         return call("libgio-2.0.so.0", "g_signal_connect_closure", [

package/dist/generated/gio/file-input-stream.d.ts

@@ -8,19 +8,19 @@ import { InputStream } from "./input-stream.js";
  * `GFileInputStream` provides input streams that take their
  * content from a file.
  *
- * `GFileInputStream` implements [iface@Gio.Seekable], which allows the input
+ * `GFileInputStream` implements {@link Gio.Seekable}, which allows the input
  * stream to jump to arbitrary positions in the file, provided the
  * filesystem of the file allows it. To find the position of a file
- * input stream, use [method@Gio.Seekable.tell]. To find out if a file input
- * stream supports seeking, use [vfunc@Gio.Seekable.can_seek].
- * To position a file input stream, use [vfunc@Gio.Seekable.seek].
+ * input stream, use {@link Gio.Seekable.tell}. To find out if a file input
+ * stream supports seeking, use {@link Gio.Seekable.can_seek}.
+ * To position a file input stream, use {@link Gio.Seekable.seek}.
  */
 export declare class FileInputStream extends InputStream {
     static readonly glibTypeName: string;
     static readonly objectType: "gobject";
     constructor();
     /**
-     * Queries a file input stream the given @attributes. This function blocks
+     * Queries a file input stream the given `attributes`. This function blocks
      * while querying the stream. For the asynchronous (non-blocking) version
      * of this function, see g_file_input_stream_query_info_async(). While the
      * stream is blocked, the stream will set the pending flag internally, and
@@ -44,7 +44,7 @@ export declare class FileInputStream extends InputStream {
      */
     canTruncate(): boolean;
     /**
-     * Seeks in the stream by the given @offset, modified by @type.
+     * Seeks in the stream by the given `offset`, modified by `type`.
      *
      * Attempting to seek past the end of the stream will have different
      * results depending on if the stream is fixed-sized or resizable.  If
@@ -68,16 +68,16 @@ export declare class FileInputStream extends InputStream {
      */
     tell(): number;
     /**
-     * Sets the length of the stream to @offset. If the stream was previously
-     * larger than @offset, the extra data is discarded. If the stream was
-     * previously shorter than @offset, it is extended with NUL ('\0') bytes.
+     * Sets the length of the stream to `offset`. If the stream was previously
+     * larger than `offset`, the extra data is discarded. If the stream was
+     * previously shorter than `offset`, it is extended with NUL ('\0') bytes.
      *
      * If `cancellable` is not %NULL, then the operation 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 an
      * operation was partially finished when the operation was cancelled the
      * partial result will be returned, without an error.
-     * @param offset - new length for @seekable, in bytes.
+     * @param offset - new length for `seekable`, in bytes.
      * @param cancellable - optional #GCancellable object, %NULL to ignore.
      */
     truncate(offset: number, cancellable?: Cancellable): boolean;

package/dist/generated/gio/file-input-stream.js

@@ -1,6 +1,6 @@
 import { call } from "../../batch.js";
 import { NativeError } from "../../native/error.js";
-import { getObject } from "../../native/object.js";
+import { getNativeObject } from "../../native/object.js";
 import { isInstantiating, setInstantiating } from "../../native/base.js";
 import { registerNativeClass } from "../../registry.js";
 import { InputStream } from "./input-stream.js";
@@ -8,12 +8,12 @@ import { InputStream } from "./input-stream.js";
  * `GFileInputStream` provides input streams that take their
  * content from a file.
  *
- * `GFileInputStream` implements [iface@Gio.Seekable], which allows the input
+ * `GFileInputStream` implements {@link Gio.Seekable}, which allows the input
  * stream to jump to arbitrary positions in the file, provided the
  * filesystem of the file allows it. To find the position of a file
- * input stream, use [method@Gio.Seekable.tell]. To find out if a file input
- * stream supports seeking, use [vfunc@Gio.Seekable.can_seek].
- * To position a file input stream, use [vfunc@Gio.Seekable.seek].
+ * input stream, use {@link Gio.Seekable.tell}. To find out if a file input
+ * stream supports seeking, use {@link Gio.Seekable.can_seek}.
+ * To position a file input stream, use {@link Gio.Seekable.seek}.
  */
 export class FileInputStream extends InputStream {
     static glibTypeName = "GFileInputStream";
@@ -36,7 +36,7 @@ export class FileInputStream extends InputStream {
         }
     }
     /**
-     * Queries a file input stream the given @attributes. This function blocks
+     * Queries a file input stream the given `attributes`. This function blocks
      * while querying the stream. For the asynchronous (non-blocking) version
      * of this function, see g_file_input_stream_query_info_async(). While the
      * stream is blocked, the stream will set the pending flag internally, and
@@ -75,7 +75,7 @@ export class FileInputStream extends InputStream {
         if (error.value !== null) {
             throw new NativeError(error.value);
         }
-        return getObject(ptr);
+        return getNativeObject(ptr);
     }
     /**
      * Finishes an asynchronous info query operation.
@@ -107,7 +107,7 @@ export class FileInputStream extends InputStream {
         if (error.value !== null) {
             throw new NativeError(error.value);
         }
-        return getObject(ptr);
+        return getNativeObject(ptr);
     }
     /**
      * Tests if the stream supports the #GSeekableIface.
@@ -133,7 +133,7 @@ export class FileInputStream extends InputStream {
         ], { type: "boolean" });
     }
     /**
-     * Seeks in the stream by the given @offset, modified by @type.
+     * Seeks in the stream by the given `offset`, modified by `type`.
      *
      * Attempting to seek past the end of the stream will have different
      * results depending on if the stream is fixed-sized or resizable.  If
@@ -200,16 +200,16 @@ export class FileInputStream extends InputStream {
         ], { type: "int", size: 64, unsigned: false });
     }
     /**
-     * Sets the length of the stream to @offset. If the stream was previously
-     * larger than @offset, the extra data is discarded. If the stream was
-     * previously shorter than @offset, it is extended with NUL ('\0') bytes.
+     * Sets the length of the stream to `offset`. If the stream was previously
+     * larger than `offset`, the extra data is discarded. If the stream was
+     * previously shorter than `offset`, it is extended with NUL ('\0') bytes.
      *
      * If `cancellable` is not %NULL, then the operation 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 an
      * operation was partially finished when the operation was cancelled the
      * partial result will be returned, without an error.
-     * @param offset - new length for @seekable, in bytes.
+     * @param offset - new length for `seekable`, in bytes.
      * @param cancellable - optional #GCancellable object, %NULL to ignore.
      */
     truncate(offset, cancellable) {
@@ -250,7 +250,7 @@ export class FileInputStream extends InputStream {
         const argTypes = [selfType];
         const returnType = undefined;
         const wrappedHandler = (...args) => {
-            const self = getObject(args[0]);
+            const self = getNativeObject(args[0]);
             return handler(self, ...args.slice(1));
         };
         return call("libgio-2.0.so.0", "g_signal_connect_closure", [

package/dist/generated/gio/file-iostream.d.ts

@@ -8,21 +8,21 @@ import { IOStream } from "./iostream.js";
  * `GFileIOStream` provides I/O streams that both read and write to the same
  * file handle.
  *
- * `GFileIOStream` implements [iface@Gio.Seekable], which allows the I/O
+ * `GFileIOStream` implements {@link Gio.Seekable}, which allows the I/O
  * stream to jump to arbitrary positions in the file and to truncate
  * the file, provided the filesystem of the file supports these
  * operations.
  *
- * To find the position of a file I/O stream, use [method@Gio.Seekable.tell].
+ * To find the position of a file I/O stream, use {@link Gio.Seekable.tell}.
  *
  * To find out if a file I/O stream supports seeking, use
- * [method@Gio.Seekable.can_seek]. To position a file I/O stream, use
- * [method@Gio.Seekable.seek]. To find out if a file I/O stream supports
- * truncating, use [method@Gio.Seekable.can_truncate]. To truncate a file I/O
- * stream, use [method@Gio.Seekable.truncate].
+ * {@link Gio.Seekable.can_seek}. To position a file I/O stream, use
+ * {@link Gio.Seekable.seek}. To find out if a file I/O stream supports
+ * truncating, use {@link Gio.Seekable.can_truncate}. To truncate a file I/O
+ * stream, use {@link Gio.Seekable.truncate}.
  *
  * The default implementation of all the `GFileIOStream` operations
- * and the implementation of [iface@Gio.Seekable] just call into the same
+ * and the implementation of {@link Gio.Seekable} just call into the same
  * operations on the output stream.
  */
 export declare class FileIOStream extends IOStream {
@@ -36,7 +36,7 @@ export declare class FileIOStream extends IOStream {
      */
     getEtag(): string | null;
     /**
-     * Queries a file io stream for the given @attributes.
+     * Queries a file io stream for the given `attributes`.
      * This function blocks while querying the stream. For the asynchronous
      * version of this function, see g_file_io_stream_query_info_async().
      * While the stream is blocked, the stream will set the pending flag
@@ -73,7 +73,7 @@ export declare class FileIOStream extends IOStream {
      */
     canTruncate(): boolean;
     /**
-     * Seeks in the stream by the given @offset, modified by @type.
+     * Seeks in the stream by the given `offset`, modified by `type`.
      *
      * Attempting to seek past the end of the stream will have different
      * results depending on if the stream is fixed-sized or resizable.  If
@@ -97,16 +97,16 @@ export declare class FileIOStream extends IOStream {
      */
     tell(): number;
     /**
-     * Sets the length of the stream to @offset. If the stream was previously
-     * larger than @offset, the extra data is discarded. If the stream was
-     * previously shorter than @offset, it is extended with NUL ('\0') bytes.
+     * Sets the length of the stream to `offset`. If the stream was previously
+     * larger than `offset`, the extra data is discarded. If the stream was
+     * previously shorter than `offset`, it is extended with NUL ('\0') bytes.
      *
      * If `cancellable` is not %NULL, then the operation 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 an
      * operation was partially finished when the operation was cancelled the
      * partial result will be returned, without an error.
-     * @param offset - new length for @seekable, in bytes.
+     * @param offset - new length for `seekable`, in bytes.
      * @param cancellable - optional #GCancellable object, %NULL to ignore.
      */
     truncate(offset: number, cancellable?: Cancellable): boolean;