@gtkx/ffi 0.10.5 → 0.11.1

package/dist/generated/gio/functions.d.ts

@@ -1,35 +1,39 @@
 import { Ref } from "@gtkx/native";
 import { AppInfoCreateFlags, BusNameOwnerFlags, BusNameWatcherFlags, BusType, IOErrorEnum, ResourceLookupFlags } from "./enums.js";
-import { DBusAnnotationInfo } from "./dbus-annotation-info.js";
+import { DBusAnnotationInfo } from "./d-bus-annotation-info.js";
+import { DBusErrorEntry } from "./d-bus-error-entry.js";
+import { IOExtension } from "./io-extension.js";
+import { IOExtensionPoint } from "./io-extension-point.js";
+import { IOModuleScope } from "./io-module-scope.js";
 import { Resource } from "./resource.js";
 import { SettingsSchemaSource } from "./settings-schema-source.js";
 import { AppInfo } from "./app-info.js";
-import { AppLaunchContext } from "./app-launch-context.js";
 import { AsyncResult } from "./async-result.js";
-import { Cancellable } from "./cancellable.js";
 import { DatagramBased } from "./datagram-based.js";
-import { DBusConnection } from "./dbus-connection.js";
 import { DtlsClientConnection } from "./dtls-client-connection.js";
 import { DtlsServerConnection } from "./dtls-server-connection.js";
 import { File } from "./file.js";
-import { FileIOStream } from "./file-iostream.js";
 import { Icon } from "./icon.js";
-import { InputStream } from "./input-stream.js";
-import { IOModule } from "./iomodule.js";
-import { IOStream } from "./iostream.js";
 import { MemoryMonitor } from "./memory-monitor.js";
 import { NetworkMonitor } from "./network-monitor.js";
-import { OutputStream } from "./output-stream.js";
 import { PowerProfileMonitor } from "./power-profile-monitor.js";
 import { Proxy } from "./proxy.js";
 import { ProxyResolver } from "./proxy-resolver.js";
-import { SettingsBackend } from "./settings-backend.js";
 import { SocketConnectable } from "./socket-connectable.js";
 import { TlsBackend } from "./tls-backend.js";
-import { TlsCertificate } from "./tls-certificate.js";
 import { TlsClientConnection } from "./tls-client-connection.js";
 import { TlsFileDatabase } from "./tls-file-database.js";
 import { TlsServerConnection } from "./tls-server-connection.js";
+import { AppLaunchContext } from "./app-launch-context.js";
+import { Cancellable } from "./cancellable.js";
+import { DBusConnection } from "./d-bus-connection.js";
+import { FileIOStream } from "./file-io-stream.js";
+import { InputStream } from "./input-stream.js";
+import { IOModule } from "./io-module.js";
+import { IOStream } from "./io-stream.js";
+import { OutputStream } from "./output-stream.js";
+import { SettingsBackend } from "./settings-backend.js";
+import { TlsCertificate } from "./tls-certificate.js";
 import * as GLib from "../glib/index.js";
 import * as GObject from "../gobject/index.js";
 /**
@@ -40,7 +44,6 @@ import * as GObject from "../gobject/index.js";
  *
  * It is an error to call this function with a non-UTF-8 `action_name`.
  * `action_name` must not be `NULL`.
- * @param actionName - a potential action name
  */
 export declare const actionNameIsValid: (actionName: string) => boolean;
 /**
@@ -74,11 +77,8 @@ export declare const actionNameIsValid: (actionName: string) => boolean;
  * returned in `target_value`, as the `detailed_name` may not contain a target.
  *
  * If returned, the {@link GLib.Variant} in `target_value` is guaranteed to not be floating.
- * @param detailedName - a detailed action name
- * @param actionName - the action name
- * @param targetValue - the target value,
  */
-export declare const actionParseDetailedName: (detailedName: string, actionName?: Ref<string>, targetValue?: Ref<GLib.Variant>) => boolean;
+export declare const actionParseDetailedName: (detailedName: string, actionName?: Ref<string> | null, targetValue?: Ref<GLib.Variant> | null) => boolean;
 /**
  * Formats a detailed action name from `action_name` and `target_value`.
  *
@@ -90,10 +90,8 @@ export declare const actionParseDetailedName: (detailedName: string, actionName?
  *
  * See that function for the types of strings that will be printed by
  * this function.
- * @param actionName - a valid action name
- * @param targetValue - a {@link GLib.Variant} target value, or `NULL`
  */
-export declare const actionPrintDetailedName: (actionName: string, targetValue?: GLib.Variant) => string;
+export declare const actionPrintDetailedName: (actionName: string, targetValue?: GLib.Variant | null) => string;
 /**
  * Creates a new {@link Gio.AppInfo} from the given information.
  *
@@ -104,11 +102,8 @@ export declare const actionPrintDetailedName: (actionName: string, targetValue?:
  * being swallowed by `Exec` key unquoting. See
  * the specification
  * for exact quoting rules.
- * @param commandline - the command line to use
- * @param applicationName - the application name, or `NULL` to use `commandline`
- * @param flags - flags that can specify details of the created {@link Gio.AppInfo}
  */
-export declare const appInfoCreateFromCommandline: (commandline: string, flags: AppInfoCreateFlags, applicationName?: string) => AppInfo;
+export declare const appInfoCreateFromCommandline: (commandline: string, flags: AppInfoCreateFlags, applicationName?: string | null) => AppInfo;
 /**
  * Gets a list of all of the applications currently registered
  * on this system.
@@ -130,22 +125,21 @@ export declare const appInfoGetAll: () => AppInfo[];
  * including the recommended and fallback {@link Gio.AppInfo}s. See
  * {@link Gio.AppInfo.get_recommended_for_type} and
  * {@link Gio.AppInfo.get_fallback_for_type}.
- * @param contentType - the content type to find a {@link Gio.AppInfo} for
  */
 export declare const appInfoGetAllForType: (contentType: string) => AppInfo[];
+/** Gets the default {@link Gio.AppInfo} for a given content type. */
+export declare const appInfoGetDefaultForType: (contentType: string, mustSupportUris: boolean) => AppInfo | null;
 /**
- * Gets the default {@link Gio.AppInfo} for a given content type.
- * @param contentType - the content type to find a {@link Gio.AppInfo} for
- * @param mustSupportUris - if `TRUE`, the {@link Gio.AppInfo} is expected to
+ * Asynchronously gets the default {@link Gio.AppInfo} for a given content
+ * type.
  */
-export declare const appInfoGetDefaultForType: (contentType: string, mustSupportUris: boolean) => AppInfo | null;
+export declare const appInfoGetDefaultForTypeAsync: (contentType: string, mustSupportUris: boolean, cancellable?: Cancellable | null, callback?: (source_object: GObject.GObject | null, res: AsyncResult) => void | null) => void;
 /**
  * Finishes a default {@link Gio.AppInfo} lookup started by
  * {@link Gio.AppInfo.get_default_for_type_async}.
  *
  * If no #{@link Gio.AppInfo} is found, then `error` will be set to
  * {@link Gio.IOErrorEnum.NOT_FOUND}.
- * @param result - the async result
  */
 export declare const appInfoGetDefaultForTypeFinish: (result: AsyncResult) => AppInfo;
 /**
@@ -153,23 +147,27 @@ export declare const appInfoGetDefaultForTypeFinish: (result: AsyncResult) => Ap
  *
  * A URI scheme is the initial part of the URI, up to but not including the `:`.
  * For example, `http`, `ftp` or `sip`.
- * @param uriScheme - a string containing a URI scheme.
  */
 export declare const appInfoGetDefaultForUriScheme: (uriScheme: string) => AppInfo | null;
+/**
+ * Asynchronously gets the default application for handling URIs with
+ * the given URI scheme. A URI scheme is the initial part
+ * of the URI, up to but not including the `:`, e.g. `http`,
+ * `ftp` or `sip`.
+ */
+export declare const appInfoGetDefaultForUriSchemeAsync: (uriScheme: string, cancellable?: Cancellable | null, callback?: (source_object: GObject.GObject | null, res: AsyncResult) => void | null) => void;
 /**
  * Finishes a default {@link Gio.AppInfo} lookup started by
  * {@link Gio.AppInfo.get_default_for_uri_scheme_async}.
  *
  * If no {@link Gio.AppInfo} is found, then `error` will be set to
  * {@link Gio.IOErrorEnum.NOT_FOUND}.
- * @param result - the async result
  */
 export declare const appInfoGetDefaultForUriSchemeFinish: (result: AsyncResult) => AppInfo;
 /**
  * Gets a list of fallback {@link Gio.AppInfo}s for a given content type, i.e.
  * those applications which claim to support the given content type by MIME
  * type subclassing and not directly.
- * @param contentType - the content type to find a {@link Gio.AppInfo} for
  */
 export declare const appInfoGetFallbackForType: (contentType: string) => AppInfo[];
 /**
@@ -180,7 +178,6 @@ export declare const appInfoGetFallbackForType: (contentType: string) => AppInfo
  * Note that the first application of the list is the last used one, i.e.
  * the last one for which {@link Gio.AppInfo.set_as_last_used_for_type} has
  * been called.
- * @param contentType - the content type to find a {@link Gio.AppInfo} for
  */
 export declare const appInfoGetRecommendedForType: (contentType: string) => AppInfo[];
 /**
@@ -191,14 +188,21 @@ export declare const appInfoGetRecommendedForType: (contentType: string) => AppI
  * The D-Bus–activated applications don’t have to be started if your application
  * terminates too soon after this function. To prevent this, use
  * {@link Gio.AppInfo.launch_default_for_uri_async} instead.
- * @param uri - the uri to show
- * @param context - optional launch context
  */
-export declare const appInfoLaunchDefaultForUri: (uri: string, context?: AppLaunchContext) => boolean;
+export declare const appInfoLaunchDefaultForUri: (uri: string, context?: AppLaunchContext | null) => boolean;
 /**
- * Finishes an asynchronous launch-default-for-uri operation.
- * @param result - the async result
+ * Async version of {@link Gio.AppInfo.launch_default_for_uri}.
+ *
+ * This version is useful if you are interested in receiving error information
+ * in the case where the application is sandboxed and the portal may present an
+ * application chooser dialog to the user.
+ *
+ * This is also useful if you want to be sure that the D-Bus–activated
+ * applications are really started before termination and if you are interested
+ * in receiving error information from their activation.
  */
+export declare const appInfoLaunchDefaultForUriAsync: (uri: string, context?: AppLaunchContext | null, cancellable?: Cancellable | null, callback?: (source_object: GObject.GObject | null, res: AsyncResult) => void | null) => void;
+/** Finishes an asynchronous launch-default-for-uri operation. */
 export declare const appInfoLaunchDefaultForUriFinish: (result: AsyncResult) => boolean;
 /**
  * Removes all changes to the type associations done by
@@ -206,9 +210,27 @@ export declare const appInfoLaunchDefaultForUriFinish: (result: AsyncResult) =>
  * {@link Gio.AppInfo.set_as_default_for_extension},
  * {@link Gio.AppInfo.add_supports_type} or
  * {@link Gio.AppInfo.remove_supports_type}.
- * @param contentType - a content type
  */
 export declare const appInfoResetTypeAssociations: (contentType: string) => void;
+/**
+ * Helper function for constructing #GAsyncInitable object. This is
+ * similar to g_object_newv() but also initializes the object asynchronously.
+ *
+ * When the initialization is finished, `callback` will be called. You can
+ * then call g_async_initable_new_finish() to get the new object and check
+ * for any errors.
+ */
+export declare const asyncInitableNewvAsync: (objectType: number, nParameters: number, parameters: GObject.Parameter, ioPriority: number, cancellable?: Cancellable | null, callback?: (source_object: GObject.GObject | null, res: AsyncResult) => void | null) => void;
+/**
+ * Asynchronously connects to the message bus specified by `bus_type`.
+ *
+ * When the operation is finished, `callback` will be invoked. You can
+ * then call g_bus_get_finish() to get the result of the operation.
+ *
+ * This is an asynchronous failable function. See g_bus_get_sync() for
+ * the synchronous version.
+ */
+export declare const busGet: (busType: BusType, cancellable?: Cancellable | null, callback?: (source_object: GObject.GObject | null, res: AsyncResult) => void | null) => void;
 /**
  * Finishes an operation started with g_bus_get().
  *
@@ -222,7 +244,6 @@ export declare const appInfoResetTypeAssociations: (contentType: string) => void
  *
  * Note that the returned #GDBusConnection object will (usually) have
  * the #GDBusConnection:exit-on-close property set to %TRUE.
- * @param res - a #GAsyncResult obtained from the #GAsyncReadyCallback passed
  */
 export declare const busGetFinish: (res: AsyncResult) => DBusConnection;
 /**
@@ -244,31 +265,18 @@ export declare const busGetFinish: (res: AsyncResult) => DBusConnection;
  *
  * Note that the returned #GDBusConnection object will (usually) have
  * the #GDBusConnection:exit-on-close property set to %TRUE.
- * @param busType - a #GBusType
- * @param cancellable - a #GCancellable or %NULL
  */
-export declare const busGetSync: (busType: BusType, cancellable?: Cancellable) => DBusConnection;
+export declare const busGetSync: (busType: BusType, cancellable?: Cancellable | null) => DBusConnection;
 /**
  * Version of {@link Gio.bus_own_name_on_connection} using closures instead of
  * callbacks for easier binding in other languages.
- * @param connection - a bus connection
- * @param name - the well-known name to own
- * @param flags - a set of flags with ownership options
- * @param nameAcquiredClosure - closure to invoke when `name` is
- * @param nameLostClosure - closure to invoke when `name` is lost,
  */
-export declare const busOwnNameOnConnectionWithClosures: (connection: DBusConnection, name: string, flags: BusNameOwnerFlags, nameAcquiredClosure?: GObject.Closure, nameLostClosure?: GObject.Closure) => number;
+export declare const busOwnNameOnConnectionWithClosures: (connection: DBusConnection, name: string, flags: BusNameOwnerFlags, nameAcquiredClosure?: GObject.Closure | null, nameLostClosure?: GObject.Closure | null) => number;
 /**
  * Version of [func`Gio`.bus_own_name using closures instead of callbacks for
  * easier binding in other languages.
- * @param busType - the type of bus to own a name on
- * @param name - the well-known name to own
- * @param flags - a set of flags with ownership options
- * @param busAcquiredClosure - closure to invoke when connected to
- * @param nameAcquiredClosure - closure to invoke when `name` is
- * @param nameLostClosure - closure to invoke when `name` is lost, or
  */
-export declare const busOwnNameWithClosures: (busType: BusType, name: string, flags: BusNameOwnerFlags, busAcquiredClosure?: GObject.Closure, nameAcquiredClosure?: GObject.Closure, nameLostClosure?: GObject.Closure) => number;
+export declare const busOwnNameWithClosures: (busType: BusType, name: string, flags: BusNameOwnerFlags, busAcquiredClosure?: GObject.Closure | null, nameAcquiredClosure?: GObject.Closure | null, nameLostClosure?: GObject.Closure | null) => number;
 /**
  * Stops owning a name.
  *
@@ -279,7 +287,6 @@ export declare const busOwnNameWithClosures: (busType: BusType, name: string, fl
  * {@link GLib.DestroyNotify} function passed to {@link Gio.bus_own_name} is
  * called, in order to avoid memory leaks through callbacks queued on the
  * {@link GLib.MainContext} after it’s stopped being iterated.
- * @param ownerId - an identifier obtained from {@link Gio.bus_own_name}
  */
 export declare const busUnownName: (ownerId: number) => void;
 /**
@@ -291,50 +298,28 @@ export declare const busUnownName: (ownerId: number) => void;
  * until the #GDestroyNotify function passed to g_bus_watch_name() is called, in
  * order to avoid memory leaks through callbacks queued on the #GMainContext
  * after it’s stopped being iterated.
- * @param watcherId - An identifier obtained from g_bus_watch_name()
  */
 export declare const busUnwatchName: (watcherId: number) => void;
 /**
  * Version of g_bus_watch_name_on_connection() using closures instead of callbacks for
  * easier binding in other languages.
- * @param connection - A #GDBusConnection.
- * @param name - The name (well-known or unique) to watch.
- * @param flags - Flags from the #GBusNameWatcherFlags enumeration.
- * @param nameAppearedClosure - #GClosure to invoke when `name` is known
- * @param nameVanishedClosure - #GClosure to invoke when `name` is known
  */
-export declare const busWatchNameOnConnectionWithClosures: (connection: DBusConnection, name: string, flags: BusNameWatcherFlags, nameAppearedClosure?: GObject.Closure, nameVanishedClosure?: GObject.Closure) => number;
+export declare const busWatchNameOnConnectionWithClosures: (connection: DBusConnection, name: string, flags: BusNameWatcherFlags, nameAppearedClosure?: GObject.Closure | null, nameVanishedClosure?: GObject.Closure | null) => number;
 /**
  * Version of g_bus_watch_name() using closures instead of callbacks for
  * easier binding in other languages.
- * @param busType - The type of bus to watch a name on.
- * @param name - The name (well-known or unique) to watch.
- * @param flags - Flags from the #GBusNameWatcherFlags enumeration.
- * @param nameAppearedClosure - #GClosure to invoke when `name` is known
- * @param nameVanishedClosure - #GClosure to invoke when `name` is known
  */
-export declare const busWatchNameWithClosures: (busType: BusType, name: string, flags: BusNameWatcherFlags, nameAppearedClosure?: GObject.Closure, nameVanishedClosure?: GObject.Closure) => number;
+export declare const busWatchNameWithClosures: (busType: BusType, name: string, flags: BusNameWatcherFlags, nameAppearedClosure?: GObject.Closure | null, nameVanishedClosure?: GObject.Closure | null) => number;
 /**
  * Checks if a content type can be executable. Note that for instance
  * things like text files can be executables (i.e. scripts and batch files).
- * @param type - a content type string
  */
 export declare const contentTypeCanBeExecutable: (type: string) => boolean;
-/**
- * Compares two content types for equality.
- * @param type1 - a content type string
- * @param type2 - a content type string
- */
+/** Compares two content types for equality. */
 export declare const contentTypeEquals: (type1: string, type2: string) => boolean;
-/**
- * Tries to find a content type based on the mime type name.
- * @param mimeType - a mime type string
- */
+/** Tries to find a content type based on the mime type name. */
 export declare const contentTypeFromMimeType: (mimeType: string) => string | null;
-/**
- * Gets the human readable description of the content type.
- * @param type - a content type string
- */
+/** Gets the human readable description of the content type. */
 export declare const contentTypeGetDescription: (type: string) => string;
 /**
  * Gets the generic icon name for a content type.
@@ -342,40 +327,26 @@ export declare const contentTypeGetDescription: (type: string) => string;
  * See the
  * [shared-mime-info](http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec)
  * specification for more on the generic icon name.
- * @param type - a content type string
  */
 export declare const contentTypeGetGenericIconName: (type: string) => string | null;
-/**
- * Gets the icon for a content type.
- * @param type - a content type string
- */
+/** Gets the icon for a content type. */
 export declare const contentTypeGetIcon: (type: string) => Icon;
 /**
  * Get the list of directories which MIME data is loaded from. See
  * g_content_type_set_mime_dirs() for details.
  */
 export declare const contentTypeGetMimeDirs: () => string[];
-/**
- * Gets the mime type for the content type, if one is registered.
- * @param type - a content type string
- */
+/** Gets the mime type for the content type, if one is registered. */
 export declare const contentTypeGetMimeType: (type: string) => string | null;
-/**
- * Gets the symbolic icon for a content type.
- * @param type - a content type string
- */
+/** Gets the symbolic icon for a content type. */
 export declare const contentTypeGetSymbolicIcon: (type: string) => Icon;
 /**
  * Guesses the content type based on example data. If the function is
  * uncertain, `result_uncertain` will be set to %TRUE. Either `filename`
  * or `data` may be %NULL, in which case the guess will be based solely
  * on the other argument.
- * @param filename - a path, or %NULL
- * @param data - a stream of data, or %NULL
- * @param dataSize - the size of `data`
- * @param resultUncertain - return location for the certainty
  */
-export declare const contentTypeGuess: (dataSize: number, filename?: string, data?: number[], resultUncertain?: Ref<boolean>) => string;
+export declare const contentTypeGuess: (dataSize: number, filename?: string | null, data?: number[] | null, resultUncertain?: Ref<boolean> | null) => string;
 /**
  * Tries to guess the type of the tree with root `root`, by
  * looking at the files it contains. The result is an array
@@ -389,20 +360,13 @@ export declare const contentTypeGuess: (dataSize: number, filename?: string, dat
  *
  * This function is useful in the implementation of
  * g_mount_guess_content_type().
- * @param root - the root of the tree to guess a type for
  */
 export declare const contentTypeGuessForTree: (root: File) => string[];
-/**
- * Determines if `type` is a subset of `supertype`.
- * @param type - a content type string
- * @param supertype - a content type string
- */
+/** Determines if `type` is a subset of `supertype`. */
 export declare const contentTypeIsA: (type: string, supertype: string) => boolean;
 /**
  * Determines if `type` is a subset of `mime_type`.
  * Convenience wrapper around g_content_type_is_a().
- * @param type - a content type string
- * @param mimeType - a mime type string
  */
 export declare const contentTypeIsMimeType: (type: string, mimeType: string) => boolean;
 /**
@@ -410,15 +374,14 @@ export declare const contentTypeIsMimeType: (type: string, mimeType: string) =>
  * On UNIX this is the "application/octet-stream" mimetype,
  * while on win32 it is "*" and on OSX it is a dynamic type
  * or octet-stream.
- * @param type - a content type string
  */
 export declare const contentTypeIsUnknown: (type: string) => boolean;
 /**
  * Set the list of directories used by GIO to load the MIME database.
  * If `dirs` is %NULL, the directories used are the default:
  *
- * - the `mime` subdirectory of the directory in `$XDG_DATA_HOME`
- * - the `mime` subdirectory of every directory in `$XDG_DATA_DIRS`
+ *  - the `mime` subdirectory of the directory in `$XDG_DATA_HOME`
+ *  - the `mime` subdirectory of every directory in `$XDG_DATA_DIRS`
  *
  * This function is intended to be used when writing tests that depend on
  * information stored in the MIME database, in order to control the data.
@@ -428,18 +391,17 @@ export declare const contentTypeIsUnknown: (type: string) => boolean;
  * with `dirs` set to %NULL before calling g_test_init(), for instance:
  *
  * |[<!-- language="C" -->
- * // Load MIME data from the system
- * g_content_type_set_mime_dirs (NULL);
- * // Isolate the environment
- * g_test_init (&argc, &argv, G_TEST_OPTION_ISOLATE_DIRS, NULL);
+ *   // Load MIME data from the system
+ *   g_content_type_set_mime_dirs (NULL);
+ *   // Isolate the environment
+ *   g_test_init (&argc, &argv, G_TEST_OPTION_ISOLATE_DIRS, NULL);
  *
- * …
+ *   …
  *
- * return g_test_run ();
+ *   return g_test_run ();
  * ]|
- * @param dirs - %NULL-terminated list of
  */
-export declare const contentTypeSetMimeDirs: (dirs?: string[]) => void;
+export declare const contentTypeSetMimeDirs: (dirs?: string[] | null) => void;
 /**
  * Gets a list of strings containing all the registered content types
  * known to the system. The list and its data should be freed using
@@ -454,7 +416,6 @@ export declare const contentTypesGetRegistered: () => string[];
  * this function would return `/run/bus-for-%3A0`,
  * which could be used in a D-Bus address like
  * `unix:nonce-tcp:host=127.0.0.1,port=42,noncefile=/run/bus-for-%3A0`.
- * @param string - an unescaped string to be included in a D-Bus address
  */
 export declare const dbusAddressEscapeValue: (string: string) => string;
 /**
@@ -464,19 +425,29 @@ export declare const dbusAddressEscapeValue: (string: string) => string;
  *
  * The returned address will be in the
  * D-Bus address format.
- * @param busType - a #GBusType
- * @param cancellable - a #GCancellable or %NULL
  */
-export declare const dbusAddressGetForBusSync: (busType: BusType, cancellable?: Cancellable) => string;
+export declare const dbusAddressGetForBusSync: (busType: BusType, cancellable?: Cancellable | null) => string;
+/**
+ * Asynchronously connects to an endpoint specified by `address` and
+ * sets up the connection so it is in a state to run the client-side
+ * of the D-Bus authentication conversation. `address` must be in the
+ * D-Bus address format.
+ *
+ * When the operation is finished, `callback` will be invoked. You can
+ * then call g_dbus_address_get_stream_finish() to get the result of
+ * the operation.
+ *
+ * This is an asynchronous failable function. See
+ * g_dbus_address_get_stream_sync() for the synchronous version.
+ */
+export declare const dbusAddressGetStream: (address: string, cancellable?: Cancellable | null, callback?: (source_object: GObject.GObject | null, res: AsyncResult) => void | null) => void;
 /**
  * Finishes an operation started with g_dbus_address_get_stream().
  *
  * A server is not required to set a GUID, so `out_guid` may be set to %NULL
  * even on success.
- * @param res - A #GAsyncResult obtained from the GAsyncReadyCallback passed to g_dbus_address_get_stream().
- * @param outGuid - %NULL or return location to store the GUID extracted from `address`, if any.
  */
-export declare const dbusAddressGetStreamFinish: (res: AsyncResult, outGuid?: Ref<string>) => IOStream;
+export declare const dbusAddressGetStreamFinish: (res: AsyncResult, outGuid?: Ref<string> | null) => IOStream;
 /**
  * Synchronously connects to an endpoint specified by `address` and
  * sets up the connection so it is in a state to run the client-side
@@ -488,19 +459,14 @@ export declare const dbusAddressGetStreamFinish: (res: AsyncResult, outGuid?: Re
  *
  * This is a synchronous failable function. See
  * g_dbus_address_get_stream() for the asynchronous version.
- * @param address - A valid D-Bus address.
- * @param outGuid - %NULL or return location to store the GUID extracted from `address`, if any.
- * @param cancellable - A #GCancellable or %NULL.
  */
-export declare const dbusAddressGetStreamSync: (address: string, outGuid?: Ref<string>, cancellable?: Cancellable) => IOStream;
+export declare const dbusAddressGetStreamSync: (address: string, outGuid?: Ref<string> | null, cancellable?: Cancellable | null) => IOStream;
 /**
  * Looks up the value of an annotation.
  *
  * The cost of this function is O(n) in number of annotations.
- * @param annotations - A %NULL-terminated array of annotations or %NULL.
- * @param name - The name of the annotation to look up.
  */
-export declare const dbusAnnotationInfoLookup: (name: string, annotations?: DBusAnnotationInfo[]) => string | null;
+export declare const dbusAnnotationInfoLookup: (name: string, annotations?: DBusAnnotationInfo[] | null) => string | null;
 /**
  * Creates a D-Bus error name to use for `error`.
  *
@@ -516,7 +482,6 @@ export declare const dbusAnnotationInfoLookup: (name: string, annotations?: DBus
  *
  * This function is typically only used in object mappings to put a
  * {@link GLib.Error} on the wire. Regular applications should not use it.
- * @param error - an error
  */
 export declare const dbusErrorEncodeGerror: (error: GLib.GError) => string;
 /**
@@ -526,14 +491,12 @@ export declare const dbusErrorEncodeGerror: (error: GLib.GError) => string;
  * {@link GLib.Error}s returned from functions handling remote method calls
  * (for example, {@link Gio.DBusConnection.call_finish}) unless
  * {@link Gio.DBusError.strip_remote_error} has already been used on `error`.
- * @param error - an error
  */
 export declare const dbusErrorGetRemoteError: (error: GLib.GError) => string | null;
 /**
  * Checks if `error` represents an error received via D-Bus from a remote peer.
  *
  * If so, use {@link Gio.DBusError.get_remote_error} to get the name of the error.
- * @param error - an error
  */
 export declare const dbusErrorIsRemoteError: (error: GLib.GError) => boolean;
 /**
@@ -566,8 +529,6 @@ export declare const dbusErrorIsRemoteError: (error: GLib.GError) => boolean;
  * This function is typically only used in object mappings to prepare
  * {@link GLib.Error} instances for applications. Regular applications should not
  * use it.
- * @param dbusErrorName - D-Bus error name
- * @param dbusErrorMessage - D-Bus error message
  */
 export declare const dbusErrorNewForDbusError: (dbusErrorName: string, dbusErrorMessage: string) => GLib.GError;
 export declare const dbusErrorQuark: () => number;
@@ -577,9 +538,6 @@ export declare const dbusErrorQuark: () => number;
  *
  * This is typically done in the function that returns the {@link GLib.Quark} for
  * an error domain.
- * @param errorDomain - a {@link GLib.Quark} for an error domain
- * @param errorCode - an error code
- * @param dbusErrorName - a D-Bus error name
  */
 export declare const dbusErrorRegisterError: (errorDomain: number, errorCode: number, dbusErrorName: string) => boolean;
 /**
@@ -588,12 +546,8 @@ export declare const dbusErrorRegisterError: (errorDomain: number, errorCode: nu
  *
  * While `quark_volatile` has a `volatile` qualifier, this is a historical
  * artifact and the argument passed to it should not be `volatile`.
- * @param errorDomainQuarkName - the error domain name
- * @param quarkVolatile - return location for the {@link GLib.Quark} representing the
- * @param entries - items to register
- * @param numEntries - number of items to register
  */
-export declare const dbusErrorRegisterErrorDomain: (errorDomainQuarkName: string, quarkVolatile: number, entries: number[], numEntries: number) => void;
+export declare const dbusErrorRegisterErrorDomain: (errorDomainQuarkName: string, quarkVolatile: number, entries: DBusErrorEntry[], numEntries: number) => void;
 /**
  * Looks for extra information in the error message used to recover
  * the D-Bus error name and strips it if found.
@@ -603,21 +557,14 @@ export declare const dbusErrorRegisterErrorDomain: (errorDomainQuarkName: string
  * received on the wire.
  *
  * This is typically used when presenting errors to the end user.
- * @param error - an error
  */
 export declare const dbusErrorStripRemoteError: (error: GLib.GError) => boolean;
 /**
  * Destroys an association previously set up with
  * {@link Gio.DBusError.register_error}.
- * @param errorDomain - a {@link GLib.Quark} for an error domain
- * @param errorCode - an error code
- * @param dbusErrorName - a D-Bus error name
  */
 export declare const dbusErrorUnregisterError: (errorDomain: number, errorCode: number, dbusErrorName: string) => boolean;
-/**
- * This is a language binding friendly version of g_dbus_escape_object_path_bytestring().
- * @param s - the string to escape
- */
+/** This is a language binding friendly version of g_dbus_escape_object_path_bytestring(). */
 export declare const dbusEscapeObjectPath: (s: string) => string;
 /**
  * Escapes `bytes` for use in a D-Bus object path component.
@@ -636,7 +583,6 @@ export declare const dbusEscapeObjectPath: (s: string) => string;
  * D-Bus object paths.
  *
  * This can be reversed with g_dbus_unescape_object_path().
- * @param bytes - the string of bytes to escape
  */
 export declare const dbusEscapeObjectPathBytestring: (bytes: number[]) => string;
 /**
@@ -682,8 +628,6 @@ export declare const dbusGenerateGuid: () => string;
  *
  * See the g_dbus_gvariant_to_gvalue() function for how to convert a
  * #GVariant to a #GValue.
- * @param gvalue - A #GValue to convert to a #GVariant
- * @param type - A #GVariantType
  */
 export declare const dbusGvalueToGvariant: (gvalue: GObject.Value, type: GLib.VariantType) => GLib.Variant;
 /**
@@ -698,8 +642,6 @@ export declare const dbusGvalueToGvariant: (gvalue: GObject.Value, type: GLib.Va
  *
  * The conversion never fails - a valid #GValue is always returned in
  * `out_gvalue`.
- * @param value - A #GVariant.
- * @param outGvalue - Return location pointing to a zero-filled (uninitialized) #GValue.
  */
 export declare const dbusGvariantToGvalue: (value: GLib.Variant, outGvalue: GObject.Value) => void;
 /**
@@ -709,7 +651,6 @@ export declare const dbusGvariantToGvalue: (value: GLib.Variant, outGvalue: GObj
  * This doesn't check if `string` is actually supported by #GDBusServer
  * or #GDBusConnection - use g_dbus_is_supported_address() to do more
  * checks.
- * @param string - A string.
  */
 export declare const dbusIsAddress: (string: string) => boolean;
 /**
@@ -718,7 +659,6 @@ export declare const dbusIsAddress: (string: string) => boolean;
  * This function returns the same result as g_dbus_is_interface_name(),
  * because D-Bus error names are defined to have exactly the
  * same syntax as interface names.
- * @param string - The string to check.
  */
 export declare const dbusIsErrorName: (string: string) => boolean;
 /**
@@ -726,36 +666,22 @@ export declare const dbusIsErrorName: (string: string) => boolean;
  *
  * See the documentation for g_dbus_generate_guid() for more information about
  * the format of a GUID.
- * @param string - The string to check.
  */
 export declare const dbusIsGuid: (string: string) => boolean;
-/**
- * Checks if `string` is a valid D-Bus interface name.
- * @param string - The string to check.
- */
+/** Checks if `string` is a valid D-Bus interface name. */
 export declare const dbusIsInterfaceName: (string: string) => boolean;
-/**
- * Checks if `string` is a valid D-Bus member (e.g. signal or method) name.
- * @param string - The string to check.
- */
+/** Checks if `string` is a valid D-Bus member (e.g. signal or method) name. */
 export declare const dbusIsMemberName: (string: string) => boolean;
-/**
- * Checks if `string` is a valid D-Bus bus name (either unique or well-known).
- * @param string - The string to check.
- */
+/** Checks if `string` is a valid D-Bus bus name (either unique or well-known). */
 export declare const dbusIsName: (string: string) => boolean;
 /**
  * Like g_dbus_is_address() but also checks if the library supports the
  * transports in `string` and that key/value pairs for each transport
  * are valid. See the specification of the
  * D-Bus address format.
- * @param string - A string.
  */
 export declare const dbusIsSupportedAddress: (string: string) => boolean;
-/**
- * Checks if `string` is a valid D-Bus unique bus name.
- * @param string - The string to check.
- */
+/** Checks if `string` is a valid D-Bus unique bus name. */
 export declare const dbusIsUniqueName: (string: string) => boolean;
 /**
  * Unescapes an string that was previously escaped with
@@ -766,29 +692,21 @@ export declare const dbusIsUniqueName: (string: string) => boolean;
  * Encoding alphanumeric characters which do not need to be
  * encoded is not allowed (e.g `_63` is not valid, the string
  * should contain `c` instead).
- * @param s - the string to unescape
  */
 export declare const dbusUnescapeObjectPath: (s: string) => number[] | null;
 /**
  * Creates a new #GDtlsClientConnection wrapping `base_socket` which is
  * assumed to communicate with the server identified by `server_identity`.
- * @param baseSocket - the #GDatagramBased to wrap
- * @param serverIdentity - the expected identity of the server
  */
-export declare const dtlsClientConnectionNew: (baseSocket: DatagramBased, serverIdentity?: SocketConnectable) => DtlsClientConnection;
-/**
- * Creates a new #GDtlsServerConnection wrapping `base_socket`.
- * @param baseSocket - the #GDatagramBased to wrap
- * @param certificate - the default server certificate, or %NULL
- */
-export declare const dtlsServerConnectionNew: (baseSocket: DatagramBased, certificate?: TlsCertificate) => DtlsServerConnection;
+export declare const dtlsClientConnectionNew: (baseSocket: DatagramBased, serverIdentity?: SocketConnectable | null) => DtlsClientConnection;
+/** Creates a new #GDtlsServerConnection wrapping `base_socket`. */
+export declare const dtlsServerConnectionNew: (baseSocket: DatagramBased, certificate?: TlsCertificate | null) => DtlsServerConnection;
 /**
  * Constructs a #GFile from a vector of elements using the correct
  * separator for filenames.
  *
  * Using this function is equivalent to calling g_build_filenamev(),
  * followed by g_file_new_for_path() on the result.
- * @param args - %NULL-terminated
  */
 export declare const fileNewBuildFilenamev: (args: string[]) => File;
 /**
@@ -806,7 +724,6 @@ export declare const fileNewBuildFilenamev: (args: string[]) => File;
  * g_application_command_line_create_file_for_arg() may be more useful
  * for you there.  It is also always possible to use this function with
  * #GOptionContext arguments of type %G_OPTION_ARG_FILENAME.
- * @param arg - a command line string
  */
 export declare const fileNewForCommandlineArg: (arg: string) => File;
 /**
@@ -821,15 +738,12 @@ export declare const fileNewForCommandlineArg: (arg: string) => File;
  * other than the invocation of the current process.
  *
  * See also g_application_command_line_create_file_for_arg().
- * @param arg - a command line string
- * @param cwd - the current working directory of the commandline
  */
 export declare const fileNewForCommandlineArgAndCwd: (arg: string, cwd: string) => File;
 /**
  * Constructs a #GFile for a given path. This operation never
  * fails, but the returned object might not support any I/O
  * operation if `path` is malformed.
- * @param path - a string containing a relative or absolute path.
  */
 export declare const fileNewForPath: (path: string) => File;
 /**
@@ -837,7 +751,6 @@ export declare const fileNewForPath: (path: string) => File;
  * fails, but the returned object might not support any I/O
  * operation if `uri` is malformed or if the uri type is
  * not supported.
- * @param uri - a UTF-8 string containing a URI
  */
 export declare const fileNewForUri: (uri: string) => File;
 /**
@@ -851,34 +764,41 @@ export declare const fileNewForUri: (uri: string) => File;
  *
  * Unlike the other #GFile constructors, this will return %NULL if
  * a temporary file could not be created.
- * @param tmpl - Template for the file
- * @param iostream - on return, a #GFileIOStream for the created file
  */
-export declare const fileNewTmp: (iostream: Ref<FileIOStream>, tmpl?: string) => File;
+export declare const fileNewTmp: (iostream: Ref<FileIOStream>, tmpl?: string | null) => File;
+/**
+ * Asynchronously opens a file in the preferred directory for temporary files
+ *  (as returned by g_get_tmp_dir()) as g_file_new_tmp().
+ *
+ * `tmpl` should be a string in the GLib file name encoding
+ * containing a sequence of six 'X' characters, and containing no
+ * directory components. If it is %NULL, a default template is used.
+ */
+export declare const fileNewTmpAsync: (ioPriority: number, tmpl?: string | null, cancellable?: Cancellable | null, callback?: (source_object: GObject.GObject | null, res: AsyncResult) => void | null) => void;
+/**
+ * Asynchronously creates a directory in the preferred directory for
+ * temporary files (as returned by g_get_tmp_dir()) as g_dir_make_tmp().
+ *
+ * `tmpl` should be a string in the GLib file name encoding
+ * containing a sequence of six 'X' characters, and containing no
+ * directory components. If it is %NULL, a default template is used.
+ */
+export declare const fileNewTmpDirAsync: (ioPriority: number, tmpl?: string | null, cancellable?: Cancellable | null, callback?: (source_object: GObject.GObject | null, res: AsyncResult) => void | null) => void;
 /**
  * Finishes a temporary directory creation started by
  * g_file_new_tmp_dir_async().
- * @param result - a #GAsyncResult
  */
 export declare const fileNewTmpDirFinish: (result: AsyncResult) => File;
-/**
- * Finishes a temporary file creation started by g_file_new_tmp_async().
- * @param result - a #GAsyncResult
- * @param iostream - on return, a #GFileIOStream for the created file
- */
+/** Finishes a temporary file creation started by g_file_new_tmp_async(). */
 export declare const fileNewTmpFinish: (result: AsyncResult, iostream: Ref<FileIOStream>) => File;
 /**
  * Constructs a #GFile with the given `parse_name` (i.e. something
  * given by g_file_get_parse_name()). This operation never fails,
  * but the returned object might not support any I/O operation if
  * the `parse_name` cannot be parsed.
- * @param parseName - a file name or path to be parsed
  */
 export declare const fileParseName: (parseName: string) => File;
-/**
- * Deserializes a #GIcon previously serialized using g_icon_serialize().
- * @param value - a #GVariant created with g_icon_serialize()
- */
+/** Deserializes a #GIcon previously serialized using g_icon_serialize(). */
 export declare const iconDeserialize: (value: GLib.Variant) => Icon | null;
 /**
  * Generate a #GIcon instance from `str`. This function can fail if
@@ -887,19 +807,14 @@ export declare const iconDeserialize: (value: GLib.Variant) => Icon | null;
  * If your application or library provides one or more #GIcon
  * implementations you need to ensure that each #GType is registered
  * with the type system prior to calling g_icon_new_for_string().
- * @param str - A string obtained via g_icon_to_string().
  */
 export declare const iconNewForString: (str: string) => Icon;
 /**
  * Helper function for constructing #GInitable object. This is
  * similar to g_object_newv() but also initializes the object
  * and returns %NULL, setting an error on failure.
- * @param objectType - a #GType supporting #GInitable.
- * @param nParameters - the number of parameters in `parameters`
- * @param parameters - the parameters to use to construct the object
- * @param cancellable - optional #GCancellable object, %NULL to ignore.
  */
-export declare const initableNewv: (objectType: number, nParameters: number, parameters: number[], cancellable?: Cancellable) => GObject.GObject;
+export declare const initableNewv: (objectType: number, nParameters: number, parameters: GObject.Parameter[], cancellable?: Cancellable | null) => GObject.GObject;
 /**
  * Converts `errno.h` error codes into GIO error codes.
  *
@@ -912,24 +827,18 @@ export declare const initableNewv: (objectType: number, nParameters: number, par
  * and use the saved value instead of `errno`:
  *
  * |[<!-- language="C" -->
- * int saved_errno;
+ *   int saved_errno;
  *
- * ret = read (blah);
- * saved_errno = errno;
+ *   ret = read (blah);
+ *   saved_errno = errno;
  *
- * g_io_error_from_errno (saved_errno);
+ *   g_io_error_from_errno (saved_errno);
  * ]|
- * @param errNo - Error number as defined in errno.h.
  */
 export declare const ioErrorFromErrno: (errNo: number) => IOErrorEnum;
-/**
- * Converts #GFileError error codes into GIO error codes.
- * @param fileError - a #GFileError.
- */
+/** Converts #GFileError error codes into GIO error codes. */
 export declare const ioErrorFromFileError: (fileError: GLib.FileError) => IOErrorEnum;
-/**
- * Gets the GIO Error Quark.
- */
+/** Gets the GIO Error Quark. */
 export declare const ioErrorQuark: () => number;
 /**
  * Registers `type` as extension for the extension point with name
@@ -937,29 +846,18 @@ export declare const ioErrorQuark: () => number;
  *
  * If `type` has already been registered as an extension for this
  * extension point, the existing #GIOExtension object is returned.
- * @param extensionPointName - the name of the extension point
- * @param type - the #GType to register as extension
- * @param extensionName - the name for the extension
- * @param priority - the priority for the extension
- */
-export declare const ioExtensionPointImplement: (extensionPointName: string, type: number, extensionName: string, priority: number) => number;
-/**
- * Looks up an existing extension point.
- * @param name - the name of the extension point
- */
-export declare const ioExtensionPointLookup: (name: string) => number;
-/**
- * Registers an extension point.
- * @param name - The name of the extension point
  */
-export declare const ioExtensionPointRegister: (name: string) => number;
+export declare const ioExtensionPointImplement: (extensionPointName: string, type: number, extensionName: string, priority: number) => IOExtension;
+/** Looks up an existing extension point. */
+export declare const ioExtensionPointLookup: (name: string) => IOExtensionPoint;
+/** Registers an extension point. */
+export declare const ioExtensionPointRegister: (name: string) => IOExtensionPoint;
 /**
  * Loads all the modules in the specified directory.
  *
  * If don't require all modules to be initialized (and thus registering
  * all gtypes) then you can use g_io_modules_scan_all_in_directory()
  * which allows delayed/lazy loading of modules.
- * @param dirname - pathname for a directory containing modules
  */
 export declare const ioModulesLoadAllInDirectory: (dirname: string) => IOModule[];
 /**
@@ -968,10 +866,8 @@ export declare const ioModulesLoadAllInDirectory: (dirname: string) => IOModule[
  * If don't require all modules to be initialized (and thus registering
  * all gtypes) then you can use g_io_modules_scan_all_in_directory()
  * which allows delayed/lazy loading of modules.
- * @param dirname - pathname for a directory containing modules
- * @param scope - a scope to use when scanning the modules.
  */
-export declare const ioModulesLoadAllInDirectoryWithScope: (dirname: string, scope: number) => IOModule[];
+export declare const ioModulesLoadAllInDirectoryWithScope: (dirname: string, scope: IOModuleScope) => IOModule[];
 /**
  * Scans all the modules in the specified directory, ensuring that
  * any extension point implemented by a module is registered.
@@ -984,7 +880,6 @@ export declare const ioModulesLoadAllInDirectoryWithScope: (dirname: string, sco
  *
  * If you need to guarantee that all types are loaded in all the modules,
  * use g_io_modules_load_all_in_directory().
- * @param dirname - pathname for a directory containing modules
  */
 export declare const ioModulesScanAllInDirectory: (dirname: string) => void;
 /**
@@ -999,10 +894,8 @@ export declare const ioModulesScanAllInDirectory: (dirname: string) => void;
  *
  * If you need to guarantee that all types are loaded in all the modules,
  * use g_io_modules_load_all_in_directory().
- * @param dirname - pathname for a directory containing modules
- * @param scope - a scope to use when scanning the modules
  */
-export declare const ioModulesScanAllInDirectoryWithScope: (dirname: string, scope: number) => void;
+export declare const ioModulesScanAllInDirectoryWithScope: (dirname: string, scope: IOModuleScope) => void;
 /**
  * Cancels all cancellable I/O jobs.
  *
@@ -1060,14 +953,9 @@ export declare const ioSchedulerCancelAllJobs: () => void;
  * the directory specified by the `GKeyfileSettingsBackend:defaults-dir`
  * property, and a list of locked keys from a text file with the name `locks` in
  * the same location.
- * @param filename - the filename of the keyfile
- * @param rootPath - the path under which all settings keys appear
- * @param rootGroup - the group name corresponding to `root_path`, or
- */
-export declare const keyfileSettingsBackendNew: (filename: string, rootPath: string, rootGroup?: string) => SettingsBackend;
-/**
- * Gets a reference to the default #GMemoryMonitor for the system.
  */
+export declare const keyfileSettingsBackendNew: (filename: string, rootPath: string, rootGroup?: string | null) => SettingsBackend;
+/** Gets a reference to the default #GMemoryMonitor for the system. */
 export declare const memoryMonitorDupDefault: () => MemoryMonitor;
 /**
  * Creates a memory-backed #GSettingsBackend.
@@ -1077,9 +965,7 @@ export declare const memoryMonitorDupDefault: () => MemoryMonitor;
  * the memory backend will start out with the default values again.
  */
 export declare const memorySettingsBackendNew: () => SettingsBackend;
-/**
- * Gets the default #GNetworkMonitor for the system.
- */
+/** Gets the default #GNetworkMonitor for the system. */
 export declare const networkMonitorGetDefault: () => NetworkMonitor;
 /**
  * Initializes the platform networking libraries (eg, on Windows, this
@@ -1101,7 +987,6 @@ export declare const nullSettingsBackendNew: () => SettingsBackend;
  * type #GPollableSourceFunc. The new source does not actually do
  * anything on its own; use g_source_add_child_source() to add other
  * sources to it to cause it to trigger.
- * @param pollableStream - the stream associated with the new source
  */
 export declare const pollableSourceNew: (pollableStream: GObject.GObject) => GLib.Source;
 /**
@@ -1109,11 +994,8 @@ export declare const pollableSourceNew: (pollableStream: GObject.GObject) => GLi
  * implementations. Creates a new #GSource, as with
  * g_pollable_source_new(), but also attaching `child_source` (with a
  * dummy callback), and `cancellable`, if they are non-%NULL.
- * @param pollableStream - the stream associated with the
- * @param childSource - optional child source to attach
- * @param cancellable - optional #GCancellable to attach
  */
-export declare const pollableSourceNewFull: (pollableStream: GObject.GObject, childSource?: GLib.Source, cancellable?: Cancellable) => GLib.Source;
+export declare const pollableSourceNewFull: (pollableStream: GObject.GObject, childSource?: GLib.Source | null, cancellable?: Cancellable | null) => GLib.Source;
 /**
  * Tries to read from `stream`, as with g_input_stream_read() (if
  * `blocking` is %TRUE) or g_pollable_input_stream_read_nonblocking()
@@ -1124,13 +1006,8 @@ export declare const pollableSourceNewFull: (pollableStream: GObject.GObject, ch
  * #GPollableInputStream for which g_pollable_input_stream_can_poll()
  * returns %TRUE, or else the behavior is undefined. If `blocking` is
  * %TRUE, then `stream` does not need to be a #GPollableInputStream.
- * @param stream - a #GInputStream
- * @param buffer - a buffer to
- * @param count - the number of bytes to read
- * @param blocking - whether to do blocking I/O
- * @param cancellable - optional #GCancellable object, %NULL to ignore.
  */
-export declare const pollableStreamRead: (stream: InputStream, buffer: number[], count: number, blocking: boolean, cancellable?: Cancellable) => number;
+export declare const pollableStreamRead: (stream: InputStream, buffer: number[], count: number, blocking: boolean, cancellable?: Cancellable | null) => number;
 /**
  * Tries to write to `stream`, as with g_output_stream_write() (if
  * `blocking` is %TRUE) or g_pollable_output_stream_write_nonblocking()
@@ -1142,13 +1019,8 @@ export declare const pollableStreamRead: (stream: InputStream, buffer: number[],
  * g_pollable_output_stream_can_poll() returns %TRUE or else the
  * behavior is undefined. If `blocking` is %TRUE, then `stream` does not
  * need to be a #GPollableOutputStream.
- * @param stream - a #GOutputStream.
- * @param buffer - the buffer
- * @param count - the number of bytes to write
- * @param blocking - whether to do blocking I/O
- * @param cancellable - optional #GCancellable object, %NULL to ignore.
  */
-export declare const pollableStreamWrite: (stream: OutputStream, buffer: number[], count: number, blocking: boolean, cancellable?: Cancellable) => number;
+export declare const pollableStreamWrite: (stream: OutputStream, buffer: number[], count: number, blocking: boolean, cancellable?: Cancellable | null) => number;
 /**
  * Tries to write `count` bytes to `stream`, as with
  * g_output_stream_write_all(), but using g_pollable_stream_write()
@@ -1168,35 +1040,20 @@ export declare const pollableStreamWrite: (stream: OutputStream, buffer: number[
  * g_pollable_output_stream_can_poll() returns %TRUE or else the
  * behavior is undefined. If `blocking` is %TRUE, then `stream` does not
  * need to be a #GPollableOutputStream.
- * @param stream - a #GOutputStream.
- * @param buffer - the buffer
- * @param count - the number of bytes to write
- * @param blocking - whether to do blocking I/O
- * @param bytesWritten - location to store the number of bytes that was
- * @param cancellable - optional #GCancellable object, %NULL to ignore.
- */
-export declare const pollableStreamWriteAll: (stream: OutputStream, buffer: number[], count: number, blocking: boolean, bytesWritten: Ref<number>, cancellable?: Cancellable) => boolean;
-/**
- * Gets a reference to the default #GPowerProfileMonitor for the system.
  */
+export declare const pollableStreamWriteAll: (stream: OutputStream, buffer: number[], count: number, blocking: boolean, bytesWritten: Ref<number>, cancellable?: Cancellable | null) => boolean;
+/** Gets a reference to the default #GPowerProfileMonitor for the system. */
 export declare const powerProfileMonitorDupDefault: () => PowerProfileMonitor;
 /**
  * Find the `gio-proxy` extension point for a proxy implementation that supports
  * the specified protocol.
- * @param protocol - the proxy protocol name (e.g. http, socks, etc)
  */
 export declare const proxyGetDefaultForProtocol: (protocol: string) => Proxy | null;
-/**
- * Gets the default #GProxyResolver for the system.
- */
+/** Gets the default #GProxyResolver for the system. */
 export declare const proxyResolverGetDefault: () => ProxyResolver;
-/**
- * Gets the #GResolver Error Quark.
- */
+/** Gets the #GResolver Error Quark. */
 export declare const resolverErrorQuark: () => number;
-/**
- * Gets the {@link Gio.Resource} Error Quark.
- */
+/** Gets the {@link Gio.Resource} Error Quark. */
 export declare const resourceErrorQuark: () => number;
 /**
  * Loads a binary resource bundle and creates a {@link Gio.Resource}
@@ -1209,7 +1066,6 @@ export declare const resourceErrorQuark: () => number;
  * %G_RESOURCE_ERROR_INTERNAL will be returned. If `filename` doesn’t exist, or
  * there is an error in reading it, an error from {@link GLib.MappedFile.new}
  * will be returned.
- * @param filename - the path of a filename to load, in the GLib filename encoding
  */
 export declare const resourceLoad: (filename: string) => Resource;
 /**
@@ -1220,8 +1076,6 @@ export declare const resourceLoad: (filename: string) => Resource;
  * be released with {@link GLib.strfreev}.
  *
  * `lookup_flags` controls the behaviour of the lookup.
- * @param path - A path name inside the resource
- * @param lookupFlags - A {@link Gio.ResourceLookupFlags}
  */
 export declare const resourcesEnumerateChildren: (path: string, lookupFlags: ResourceLookupFlags) => string[];
 /**
@@ -1229,16 +1083,11 @@ export declare const resourcesEnumerateChildren: (path: string, lookupFlags: Res
  * globally registered resources and if found returns information about it.
  *
  * `lookup_flags` controls the behaviour of the lookup.
- * @param path - A path name inside the resource
- * @param lookupFlags - A {@link Gio.ResourceLookupFlags}
- * @param size - a location to place the length of the contents of the file,
- * @param flags - a location to place the {@link Gio.ResourceFlags} about the file,
  */
-export declare const resourcesGetInfo: (path: string, lookupFlags: ResourceLookupFlags, size?: Ref<number>, flags?: Ref<number>) => boolean;
+export declare const resourcesGetInfo: (path: string, lookupFlags: ResourceLookupFlags, size?: Ref<number> | null, flags?: Ref<number> | null) => boolean;
 /**
  * Returns whether the specified `path` in the set of
  * globally registered resources has children.
- * @param path - A pathname
  */
 export declare const resourcesHasChildren: (path: string) => boolean;
 /**
@@ -1256,8 +1105,6 @@ export declare const resourcesHasChildren: (path: string) => boolean;
  * the heap and automatically uncompress the data.
  *
  * `lookup_flags` controls the behaviour of the lookup.
- * @param path - A path name inside the resource
- * @param lookupFlags - A {@link Gio.ResourceLookupFlags}
  */
 export declare const resourcesLookupData: (path: string, lookupFlags: ResourceLookupFlags) => GLib.Bytes;
 /**
@@ -1266,8 +1113,6 @@ export declare const resourcesLookupData: (path: string, lookupFlags: ResourceLo
  * that lets you read the data.
  *
  * `lookup_flags` controls the behaviour of the lookup.
- * @param path - A path name inside the resource
- * @param lookupFlags - A {@link Gio.ResourceLookupFlags}
  */
 export declare const resourcesOpenStream: (path: string, lookupFlags: ResourceLookupFlags) => InputStream;
 /**
@@ -1276,13 +1121,9 @@ export declare const resourcesOpenStream: (path: string, lookupFlags: ResourceLo
  * Once a resource is registered the files in it can be accessed
  * with the global resource lookup functions like
  * {@link Gio.resources_lookup_data}.
- * @param resource - A {@link Gio.Resource}
  */
 export declare const resourcesRegister: (resource: Resource) => void;
-/**
- * Unregisters the resource from the process-global set of resources.
- * @param resource - A {@link Gio.Resource}
- */
+/** Unregisters the resource from the process-global set of resources. */
 export declare const resourcesUnregister: (resource: Resource) => void;
 /**
  * Gets the default system schema source.
@@ -1301,12 +1142,14 @@ export declare const resourcesUnregister: (resource: Resource) => void;
  */
 export declare const settingsSchemaSourceGetDefault: () => SettingsSchemaSource | null;
 /**
- * Gets the default #GTlsBackend for the system.
+ * Reports an error in an idle function. Similar to
+ * g_simple_async_report_error_in_idle(), but takes a #GError rather
+ * than building a new one.
  */
+export declare const simpleAsyncReportGerrorInIdle: (error: GLib.GError, object?: GObject.GObject | null, callback?: (source_object: GObject.GObject | null, res: AsyncResult) => void | null) => void;
+/** Gets the default #GTlsBackend for the system. */
 export declare const tlsBackendGetDefault: () => TlsBackend;
-/**
- * Gets the TLS channel binding error quark.
- */
+/** Gets the TLS channel binding error quark. */
 export declare const tlsChannelBindingErrorQuark: () => number;
 /**
  * Creates a new #GTlsClientConnection wrapping `base_io_stream` (which
@@ -1316,20 +1159,15 @@ export declare const tlsChannelBindingErrorQuark: () => number;
  * See the documentation for #GTlsConnection:base-io-stream for restrictions
  * on when application code can run operations on the `base_io_stream` after
  * this function has returned.
- * @param baseIoStream - the #GIOStream to wrap
- * @param serverIdentity - the expected identity of the server
- */
-export declare const tlsClientConnectionNew: (baseIoStream: IOStream, serverIdentity?: SocketConnectable) => TlsClientConnection;
-/**
- * Gets the TLS error quark.
  */
+export declare const tlsClientConnectionNew: (baseIoStream: IOStream, serverIdentity?: SocketConnectable | null) => TlsClientConnection;
+/** Gets the TLS error quark. */
 export declare const tlsErrorQuark: () => number;
 /**
  * Creates a new #GTlsFileDatabase which uses anchor certificate authorities
  * in `anchors` to verify certificate chains.
  *
  * The certificates in `anchors` must be PEM encoded.
- * @param anchors - filename of anchor certificate authorities.
  */
 export declare const tlsFileDatabaseNew: (anchors: string) => TlsFileDatabase;
 /**
@@ -1339,7 +1177,5 @@ export declare const tlsFileDatabaseNew: (anchors: string) => TlsFileDatabase;
  * See the documentation for #GTlsConnection:base-io-stream for restrictions
  * on when application code can run operations on the `base_io_stream` after
  * this function has returned.
- * @param baseIoStream - the #GIOStream to wrap
- * @param certificate - the default server certificate, or %NULL
  */
-export declare const tlsServerConnectionNew: (baseIoStream: IOStream, certificate?: TlsCertificate) => TlsServerConnection;
+export declare const tlsServerConnectionNew: (baseIoStream: IOStream, certificate?: TlsCertificate | null) => TlsServerConnection;