@gtkx/ffi 0.9.0 → 0.9.2

package/dist/generated/adw/about-window.d.ts

@@ -3,6 +3,7 @@ import * as Gtk from "../gtk/index.js";
 import { Window } from "./window.js";
 export declare class AboutWindow extends Window {
     static readonly glibTypeName: string;
+    static readonly objectType: "gobject";
     /**
      * Creates a new `AdwAboutWindow`.
      */
@@ -13,26 +14,26 @@ export declare class AboutWindow extends Window {
      * This automatically sets the following properties with the following AppStream
      * values:
      *
-     * * [property@AboutWindow:application-icon] is set from the `<id>`
-     * * [property@AboutWindow:application-name] is set from the `<name>`
-     * * [property@AboutWindow:developer-name] is set from the `<name>` within
+     * * {@link AboutWindow.application-icon} is set from the `<id>`
+     * * {@link AboutWindow.application-name} is set from the `<name>`
+     * * {@link AboutWindow.developer-name} is set from the `<name>` within
      * `<developer>`
-     * * [property@AboutWindow:version] is set from the version of the latest release
-     * * [property@AboutWindow:website] is set from the `<url type="homepage">`
-     * * [property@AboutWindow:support-url] is set from the `<url type="help">`
-     * * [property@AboutWindow:issue-url] is set from the `<url type="bugtracker">`
-     * * [property@AboutWindow:license-type] is set from the `<project_license>`.
+     * * {@link AboutWindow.version} is set from the version of the latest release
+     * * {@link AboutWindow.website} is set from the `<url type="homepage">`
+     * * {@link AboutWindow.support-url} is set from the `<url type="help">`
+     * * {@link AboutWindow.issue-url} is set from the `<url type="bugtracker">`
+     * * {@link AboutWindow.license-type} is set from the `<project_license>`.
      * If the license type retrieved from AppStream is not listed in
-     * [enum@Gtk.License], it will be set to `GTK_LICENCE_CUSTOM`.
+     * {@link Gtk.License}, it will be set to `GTK_LICENCE_CUSTOM`.
      *
      * If `release_notes_version` is not `NULL`,
-     * [property@AboutWindow:release-notes-version] is set to match it, while
-     * [property@AboutWindow:release-notes] is set from the AppStream release
+     * {@link AboutWindow.release-notes-version} is set to match it, while
+     * {@link AboutWindow.release-notes} is set from the AppStream release
      * description for that version.
      * @param resourcePath - The resource to use
      * @param releaseNotesVersion - The version to retrieve release notes for
      */
-    static windowNewFromAppdata(resourcePath: string, releaseNotesVersion?: string | null): AboutWindow;
+    static windowNewFromAppdata(resourcePath: string, releaseNotesVersion?: string): AboutWindow;
     /**
      * Adds a section to the Acknowledgements page.
      *
@@ -45,16 +46,16 @@ export declare class AboutWindow extends Window {
      *
      * See also:
      *
-     * * [property@AboutWindow:developers]
-     * * [property@AboutWindow:designers]
-     * * [property@AboutWindow:artists]
-     * * [property@AboutWindow:documenters]
-     * * [property@AboutWindow:translator-credits]
-     * * [method@AboutWindow.add_credit_section]
+     * * {@link AboutWindow.developers}
+     * * {@link AboutWindow.designers}
+     * * {@link AboutWindow.artists}
+     * * {@link AboutWindow.documenters}
+     * * {@link AboutWindow.translator-credits}
+     * * {@link AboutWindow.add_credit_section}
      * @param name - the section name
      * @param people - the list of names
      */
-    addAcknowledgementSection(people: string[], name?: string | null): void;
+    addAcknowledgementSection(people: string[], name?: string): void;
     /**
      * Adds an extra section to the Credits page.
      *
@@ -65,24 +66,24 @@ export declare class AboutWindow extends Window {
      *
      * See also:
      *
-     * * [property@AboutWindow:developers]
-     * * [property@AboutWindow:designers]
-     * * [property@AboutWindow:artists]
-     * * [property@AboutWindow:documenters]
-     * * [property@AboutWindow:translator-credits]
-     * * [method@AboutWindow.add_acknowledgement_section]
+     * * {@link AboutWindow.developers}
+     * * {@link AboutWindow.designers}
+     * * {@link AboutWindow.artists}
+     * * {@link AboutWindow.documenters}
+     * * {@link AboutWindow.translator-credits}
+     * * {@link AboutWindow.add_acknowledgement_section}
      * @param name - the section name
      * @param people - the list of names
      */
-    addCreditSection(people: string[], name?: string | null): void;
+    addCreditSection(people: string[], name?: string): void;
     /**
      * Adds an extra section to the Legal page.
      *
      * Extra sections will be displayed below the application's own information.
      *
-     * The parameters @copyright, `license_type` and `license` will be used to present
-     * the it the same way as [property@AboutWindow:copyright],
-     * [property@AboutWindow:license-type] and [property@AboutWindow:license] are
+     * The parameters `copyright`, `license_type` and `license` will be used to present
+     * the it the same way as {@link AboutWindow.copyright},
+     * {@link AboutWindow.license-type} and {@link AboutWindow.license} are
      * for the application's own information.
      *
      * See those properties for more details.
@@ -121,7 +122,7 @@ export declare class AboutWindow extends Window {
      * @param licenseType - the type of license
      * @param license - custom license information
      */
-    addLegalSection(title: string, licenseType: Gtk.License, copyright?: string | null, license?: string | null): void;
+    addLegalSection(title: string, licenseType: Gtk.License, copyright?: string, license?: string): void;
     /**
      * Adds an extra link to the Details page.
      *
@@ -129,17 +130,17 @@ export declare class AboutWindow extends Window {
      *
      * Underlines in `title` will be interpreted as indicating a mnemonic.
      *
-     * See [property@AboutWindow:website].
+     * See {@link AboutWindow.website}.
      * @param title - the link title
      * @param url - the link URL
      */
     addLink(title: string, url: string): void;
     /**
-     * Gets the name of the application icon for @self.
+     * Gets the name of the application icon for `self`.
      */
     getApplicationIcon(): string;
     /**
-     * Gets the application name for @self.
+     * Gets the application name for `self`.
      */
     getApplicationName(): string;
     /**
@@ -151,15 +152,15 @@ export declare class AboutWindow extends Window {
      */
     getComments(): string;
     /**
-     * Gets the copyright information for @self.
+     * Gets the copyright information for `self`.
      */
     getCopyright(): string;
     /**
-     * Gets the debug information for @self.
+     * Gets the debug information for `self`.
      */
     getDebugInfo(): string;
     /**
-     * Gets the debug information filename for @self.
+     * Gets the debug information filename for `self`.
      */
     getDebugInfoFilename(): string;
     /**
@@ -167,7 +168,7 @@ export declare class AboutWindow extends Window {
      */
     getDesigners(): string[] | null;
     /**
-     * Gets the developer name for @self.
+     * Gets the developer name for `self`.
      */
     getDeveloperName(): string;
     /**
@@ -179,19 +180,19 @@ export declare class AboutWindow extends Window {
      */
     getDocumenters(): string[] | null;
     /**
-     * Gets the issue tracker URL for @self.
+     * Gets the issue tracker URL for `self`.
      */
     getIssueUrl(): string;
     /**
-     * Gets the license for @self.
+     * Gets the license for `self`.
      */
     getLicense(): string;
     /**
-     * Gets the license type for @self.
+     * Gets the license type for `self`.
      */
     getLicenseType(): Gtk.License;
     /**
-     * Gets the release notes for @self.
+     * Gets the release notes for `self`.
      */
     getReleaseNotes(): string;
     /**
@@ -199,7 +200,7 @@ export declare class AboutWindow extends Window {
      */
     getReleaseNotesVersion(): string;
     /**
-     * Gets the URL of the support page for @self.
+     * Gets the URL of the support page for `self`.
      */
     getSupportUrl(): string;
     /**
@@ -207,22 +208,22 @@ export declare class AboutWindow extends Window {
      */
     getTranslatorCredits(): string;
     /**
-     * Gets the version for @self.
+     * Gets the version for `self`.
      */
     getVersion(): string;
     /**
-     * Gets the application website URL for @self.
+     * Gets the application website URL for `self`.
      */
     getWebsite(): string;
     /**
-     * Sets the name of the application icon for @self.
+     * Sets the name of the application icon for `self`.
      *
      * The icon is displayed at the top of the main page.
      * @param applicationIcon - the application icon name
      */
     setApplicationIcon(applicationIcon: string): void;
     /**
-     * Sets the application name for @self.
+     * Sets the application name for `self`.
      *
      * The name is displayed at the top of the main page.
      * @param applicationName - the application name
@@ -238,27 +239,27 @@ export declare class AboutWindow extends Window {
      *
      * See also:
      *
-     * * [property@AboutWindow:developers]
-     * * [property@AboutWindow:designers]
-     * * [property@AboutWindow:documenters]
-     * * [property@AboutWindow:translator-credits]
-     * * [method@AboutWindow.add_credit_section]
-     * * [method@AboutWindow.add_acknowledgement_section]
+     * * {@link AboutWindow.developers}
+     * * {@link AboutWindow.designers}
+     * * {@link AboutWindow.documenters}
+     * * {@link AboutWindow.translator-credits}
+     * * {@link AboutWindow.add_credit_section}
+     * * {@link AboutWindow.add_acknowledgement_section}
      * @param artists - the list of artists
      */
-    setArtists(artists?: string[] | null): void;
+    setArtists(artists?: string[]): void;
     /**
      * Sets the comments about the application.
      *
      * Comments will be shown on the Details page, above links.
      *
-     * Unlike [property@Gtk.AboutDialog:comments], this string can be long and
+     * Unlike {@link Gtk.AboutDialog.comments}, this string can be long and
      * detailed. It can also contain links and Pango markup.
      * @param comments - the comments
      */
     setComments(comments: string): void;
     /**
-     * Sets the copyright information for @self.
+     * Sets the copyright information for `self`.
      *
      * This should be a short string of one or two lines, for example:
      * `© 2022 Example`.
@@ -266,20 +267,20 @@ export declare class AboutWindow extends Window {
      * The copyright information will be displayed on the Legal page, before the
      * application license.
      *
-     * [method@AboutWindow.add_legal_section] can be used to add copyright
+     * {@link AboutWindow.add_legal_section} can be used to add copyright
      * information for the application dependencies or other components.
      * @param copyright - the copyright information
      */
     setCopyright(copyright: string): void;
     /**
-     * Sets the debug information for @self.
+     * Sets the debug information for `self`.
      *
      * Debug information will be shown on the Troubleshooting page. It's intended
      * to be attached to issue reports when reporting issues against the
      * application.
      *
      * `AdwAboutWindow` provides a quick way to save debug information to a file.
-     * When saving, [property@AboutWindow:debug-info-filename] would be used as
+     * When saving, {@link AboutWindow.debug-info-filename} would be used as
      * the suggested filename.
      *
      * Debug information cannot contain markup or links.
@@ -287,12 +288,12 @@ export declare class AboutWindow extends Window {
      */
     setDebugInfo(debugInfo: string): void;
     /**
-     * Sets the debug information filename for @self.
+     * Sets the debug information filename for `self`.
      *
      * It will be used as the suggested filename when saving debug information to a
      * file.
      *
-     * See [property@AboutWindow:debug-info].
+     * See {@link AboutWindow.debug-info}.
      * @param filename - the debug info filename
      */
     setDebugInfoFilename(filename: string): void;
@@ -306,24 +307,24 @@ export declare class AboutWindow extends Window {
      *
      * See also:
      *
-     * * [property@AboutWindow:developers]
-     * * [property@AboutWindow:artists]
-     * * [property@AboutWindow:documenters]
-     * * [property@AboutWindow:translator-credits]
-     * * [method@AboutWindow.add_credit_section]
-     * * [method@AboutWindow.add_acknowledgement_section]
+     * * {@link AboutWindow.developers}
+     * * {@link AboutWindow.artists}
+     * * {@link AboutWindow.documenters}
+     * * {@link AboutWindow.translator-credits}
+     * * {@link AboutWindow.add_credit_section}
+     * * {@link AboutWindow.add_acknowledgement_section}
      * @param designers - the list of designers
      */
-    setDesigners(designers?: string[] | null): void;
+    setDesigners(designers?: string[]): void;
     /**
-     * Sets the developer name for @self.
+     * Sets the developer name for `self`.
      *
      * The developer name is displayed on the main page, under the application name.
      *
      * If the application is developed by multiple people, the developer name can be
      * set to values like "AppName team", "AppName developers" or
      * "The AppName project", and the individual contributors can be listed on the
-     * Credits page, with [property@AboutWindow:developers] and related properties.
+     * Credits page, with {@link AboutWindow.developers} and related properties.
      * @param developerName - the developer name
      */
     setDeveloperName(developerName: string): void;
@@ -337,15 +338,15 @@ export declare class AboutWindow extends Window {
      *
      * See also:
      *
-     * * [property@AboutWindow:designers]
-     * * [property@AboutWindow:artists]
-     * * [property@AboutWindow:documenters]
-     * * [property@AboutWindow:translator-credits]
-     * * [method@AboutWindow.add_credit_section]
-     * * [method@AboutWindow.add_acknowledgement_section]
+     * * {@link AboutWindow.designers}
+     * * {@link AboutWindow.artists}
+     * * {@link AboutWindow.documenters}
+     * * {@link AboutWindow.translator-credits}
+     * * {@link AboutWindow.add_credit_section}
+     * * {@link AboutWindow.add_acknowledgement_section}
      * @param developers - the list of developers
      */
-    setDevelopers(developers?: string[] | null): void;
+    setDevelopers(developers?: string[]): void;
     /**
      * Sets the list of documenters of the application.
      *
@@ -356,29 +357,29 @@ export declare class AboutWindow extends Window {
      *
      * See also:
      *
-     * * [property@AboutWindow:developers]
-     * * [property@AboutWindow:designers]
-     * * [property@AboutWindow:artists]
-     * * [property@AboutWindow:translator-credits]
-     * * [method@AboutWindow.add_credit_section]
-     * * [method@AboutWindow.add_acknowledgement_section]
+     * * {@link AboutWindow.developers}
+     * * {@link AboutWindow.designers}
+     * * {@link AboutWindow.artists}
+     * * {@link AboutWindow.translator-credits}
+     * * {@link AboutWindow.add_credit_section}
+     * * {@link AboutWindow.add_acknowledgement_section}
      * @param documenters - the list of documenters
      */
-    setDocumenters(documenters?: string[] | null): void;
+    setDocumenters(documenters?: string[]): void;
     /**
-     * Sets the issue tracker URL for @self.
+     * Sets the issue tracker URL for `self`.
      *
      * The issue tracker link is displayed on the main page.
      * @param issueUrl - the issue tracker URL
      */
     setIssueUrl(issueUrl: string): void;
     /**
-     * Sets the license for @self.
+     * Sets the license for `self`.
      *
      * This can be used to set a custom text for the license if it can't be set via
-     * [property@AboutWindow:license-type].
+     * {@link AboutWindow.license-type}.
      *
-     * When set, [property@AboutWindow:license-type] will be set to
+     * When set, {@link AboutWindow.license-type} will be set to
      * `GTK_LICENSE_CUSTOM`.
      *
      * The license text will be displayed on the Legal page, below the copyright
@@ -386,7 +387,7 @@ export declare class AboutWindow extends Window {
      *
      * License text can contain Pango markup and links.
      *
-     * [method@AboutWindow.add_legal_section] can be used to add license information
+     * {@link AboutWindow.add_legal_section} can be used to add license information
      * for the application dependencies or other components.
      * @param license - the license
      */
@@ -395,24 +396,24 @@ export declare class AboutWindow extends Window {
      * Sets the license for `self` from a list of known licenses.
      *
      * If the application's license is not in the list,
-     * [property@AboutWindow:license] can be used instead. The license type will be
+     * {@link AboutWindow.license} can be used instead. The license type will be
      * automatically set to `GTK_LICENSE_CUSTOM` in that case.
      *
      * If `license_type` is `GTK_LICENSE_UNKNOWN`, no information will be displayed.
      *
      * If `license_type` is different from `GTK_LICENSE_CUSTOM`.
-     * [property@AboutWindow:license] will be cleared out.
+     * {@link AboutWindow.license} will be cleared out.
      *
      * The license description will be displayed on the Legal page, below the
      * copyright information.
      *
-     * [method@AboutWindow.add_legal_section] can be used to add license information
+     * {@link AboutWindow.add_legal_section} can be used to add license information
      * for the application dependencies or other components.
      * @param licenseType - the license type
      */
     setLicenseType(licenseType: Gtk.License): void;
     /**
-     * Sets the release notes for @self.
+     * Sets the release notes for `self`.
      *
      * Release notes are displayed on the the What's New page.
      *
@@ -434,8 +435,8 @@ export declare class AboutWindow extends Window {
      * Nested lists are not supported.
      *
      * `AdwAboutWindow` displays the version above the release notes. If set, the
-     * [property@AboutWindow:release-notes-version] of the property will be used
-     * as the version; otherwise, [property@AboutWindow:version] is used.
+     * {@link AboutWindow.release-notes-version} of the property will be used
+     * as the version; otherwise, {@link AboutWindow.version} is used.
      * @param releaseNotes - the release notes
      */
     setReleaseNotes(releaseNotes: string): void;
@@ -445,18 +446,18 @@ export declare class AboutWindow extends Window {
      * The release notes version is displayed on the What's New page, above the
      * release notes.
      *
-     * If not set, [property@AboutWindow:version] will be used instead.
+     * If not set, {@link AboutWindow.version} will be used instead.
      *
      * For example, an application with the current version 2.0.2 might want to
      * keep the release notes from 2.0.0, and set the release notes version
      * accordingly.
      *
-     * See [property@AboutWindow:release-notes].
+     * See {@link AboutWindow.release-notes}.
      * @param version - the release notes version
      */
     setReleaseNotesVersion(version: string): void;
     /**
-     * Sets the URL of the support page for @self.
+     * Sets the URL of the support page for `self`.
      *
      * The support page link is displayed on the main page.
      * @param supportUrl - the support page URL
@@ -476,32 +477,32 @@ export declare class AboutWindow extends Window {
      *
      * See also:
      *
-     * * [property@AboutWindow:developers]
-     * * [property@AboutWindow:designers]
-     * * [property@AboutWindow:artists]
-     * * [property@AboutWindow:documenters]
-     * * [method@AboutWindow.add_credit_section]
-     * * [method@AboutWindow.add_acknowledgement_section]
+     * * {@link AboutWindow.developers}
+     * * {@link AboutWindow.designers}
+     * * {@link AboutWindow.artists}
+     * * {@link AboutWindow.documenters}
+     * * {@link AboutWindow.add_credit_section}
+     * * {@link AboutWindow.add_acknowledgement_section}
      * @param translatorCredits - the translator credits
      */
     setTranslatorCredits(translatorCredits: string): void;
     /**
-     * Sets the version for @self.
+     * Sets the version for `self`.
      *
      * The version is displayed on the main page.
      *
-     * If [property@AboutWindow:release-notes-version] is not set, the version will
+     * If {@link AboutWindow.release-notes-version} is not set, the version will
      * also be displayed above the release notes on the What's New page.
      * @param version - the version
      */
     setVersion(version: string): void;
     /**
-     * Sets the application website URL for @self.
+     * Sets the application website URL for `self`.
      *
      * Website is displayed on the Details page, below comments, or on the main page
      * if the Details page doesn't have any other content.
      *
-     * Applications can add other links below, see [method@AboutWindow.add_link].
+     * Applications can add other links below, see {@link AboutWindow.add_link}.
      * @param website - the website URL
      */
     setWebsite(website: string): void;