From d49f981e17586b73984c63470d718f146016e846 Mon Sep 17 00:00:00 2001 From: sdroege <301846+sdroege@users.noreply.github.com> Date: Sun, 8 Dec 2024 01:26:42 +0000 Subject: [PATCH] Update GIR files --- GLib-2.0.gir | 39 +++++-- GObject-2.0.gir | 190 +++++++++++++++++++++++++-------- Gdk-4.0.gir | 1 + Gio-2.0.gir | 43 +++++--- Gtk-3.0.gir | 8 +- Gtk-4.0.gir | 273 ++++++++++++++++++++++++------------------------ 6 files changed, 351 insertions(+), 203 deletions(-) diff --git a/GLib-2.0.gir b/GLib-2.0.gir index 38d4eb81..3c4dd082 100644 --- a/GLib-2.0.gir +++ b/GLib-2.0.gir @@ -15101,13 +15101,16 @@ custom log handler functions behave similarly, so that logging calls in user code do not need modifying to add a new-line character to the message if the log handler is changed. +The `log_domain` parameter can be set to `NULL` or an empty string to use the default +application domain. + This is not used if structured logging is enabled; see [Using Structured Logging](logging.html#using-structured-logging). - + the log domain of the message @@ -30592,6 +30595,21 @@ If a thread can not be created (due to resource limits), + + Gets the name of the thread. + +This function is intended for debugging purposes. + + the name of the thread + + + + + a thread + + + + Waits until @thread finishes, i.e. the function @func, as given to g_thread_new(), returns or g_thread_exit() is called. @@ -49267,6 +49285,9 @@ you want to set a handler for this log level you must combine it with This has no effect if structured logging is enabled; see [Using Structured Logging](logging.html#using-structured-logging). +The `log_domain` parameter can be set to `NULL` or an empty string to use the default +application domain. + Here is an example for adding a log handler for all warning messages in the default domain: @@ -49294,7 +49315,7 @@ g_log_set_handler ("GLib", G_LOG_LEVEL_MASK | G_LOG_FLAG_FATAL - the log domain, or `NULL` for the default `""` + the log domain application domain @@ -49319,14 +49340,17 @@ g_log_set_handler ("GLib", G_LOG_LEVEL_MASK | G_LOG_FLAG_FATAL Like [func@GLib.log_set_handler], but takes a destroy notify for the @user_data. This has no effect if structured logging is enabled; see -[Using Structured Logging](logging.html#using-structured-logging). +[Using Structured Logging](logging.html#using-structured-logging). + +The `log_domain` parameter can be set to `NULL` or an empty string to use the default +application domain. the ID of the new handler - the log domain, or `NULL` for the default `""` + the log domain application domain @@ -49946,13 +49970,16 @@ character will automatically be appended to @..., and need not be entered manually. If [structured logging is enabled](logging.html#using-structured-logging) this will -output via the structured log writer function (see [func@GLib.log_set_writer_func]). +output via the structured log writer function (see [func@GLib.log_set_writer_func]). + +The `log_domain` parameter can be set to `NULL` or an empty string to use the default +application domain. - the log domain, or `NULL` for the default `""` + the log domain application domain diff --git a/GObject-2.0.gir b/GObject-2.0.gir index d9bb7e40..f6ab5956 100644 --- a/GObject-2.0.gir +++ b/GObject-2.0.gir @@ -14343,7 +14343,27 @@ without first having or creating a strong reference to the object. - + + Change the object to which @weak_ref points, or set it to +%NULL. + +You must own a strong reference on @object while calling this +function. + + + + + + location for a weak reference + + + + a #GObject or %NULL + + + + + Frees resources associated with a non-statically-allocated #GWeakRef. After this call, the #GWeakRef is left in an undefined state. @@ -14353,14 +14373,14 @@ g_weak_ref_init() called on it. - + location of a weak reference, which may be empty - + - - + + If @weak_ref is not empty, atomically acquire a strong reference to the object it points to, and return that reference. @@ -14376,13 +14396,13 @@ by using g_object_unref(). - + location of a weak reference to a #GObject - + - - + + Initialise a non-statically-allocated #GWeakRef. This function also calls g_weak_ref_set() with @object on the @@ -14396,37 +14416,17 @@ properly initialised. Just use g_weak_ref_set() directly. - + uninitialized or empty location for a weak reference - - - a #GObject or %NULL - - - - - Change the object to which @weak_ref points, or set it to -%NULL. - -You must own a strong reference on @object while calling this -function. - - - - - - location for a weak reference - - a #GObject or %NULL - + @@ -17048,8 +17048,13 @@ The handler will be called synchronously, before the default handler of the sign See [memory management of signal handlers](signals.html#Memory_management_of_signal_handlers) for details on how to handle the return value and memory management of @data. -This function cannot fail. If the given signal doesn’t exist, a critical -warning is emitted. +This function cannot fail. If the given signal name doesn’t exist, +a critical warning is emitted. No validation is performed on the +‘detail’ string when specified in @detailed_signal, other than a +non-empty check. + +Refer to the [signals documentation](signals.html) for more +details. the instance to connect to. @@ -17070,8 +17075,13 @@ warning is emitted. The handler will be called synchronously, after the default handler of the signal. -This function cannot fail. If the given signal doesn’t exist, a critical -warning is emitted. +This function cannot fail. If the given signal name doesn’t exist, +a critical warning is emitted. No validation is performed on the +‘detail’ string when specified in @detailed_signal, other than a +non-empty check. + +Refer to the [signals documentation](signals.html) for more +details. the instance to connect to. @@ -17093,8 +17103,13 @@ warning is emitted. If @closure is a floating reference (see g_closure_sink()), this function takes ownership of @closure. -This function cannot fail. If the given signal doesn’t exist, a critical -warning is emitted. +This function cannot fail. If the given signal name doesn’t exist, +a critical warning is emitted. No validation is performed on the +‘detail’ string when specified in @detailed_signal, other than a +non-empty check. + +Refer to the [signals documentation](signals.html) for more +details. the handler ID (always greater than 0) @@ -17125,8 +17140,13 @@ warning is emitted. If @closure is a floating reference (see g_closure_sink()), this function takes ownership of @closure. -This function cannot fail. If the given signal doesn’t exist, a critical -warning is emitted. +This function cannot fail. If the given signal name doesn’t exist, +a critical warning is emitted. No validation is performed on the +‘detail’ string when specified in @detailed_signal, other than a +non-empty check. + +Refer to the [signals documentation](signals.html) for more +details. the handler ID (always greater than 0) @@ -17162,8 +17182,13 @@ which will be called when the signal handler is disconnected and no longer used. Specify @connect_flags if you need `..._after()` or `..._swapped()` variants of this function. -This function cannot fail. If the given signal doesn’t exist, a critical -warning is emitted. +This function cannot fail. If the given signal name doesn’t exist, +a critical warning is emitted. No validation is performed on the +‘detail’ string when specified in @detailed_signal, other than a +non-empty check. + +Refer to the [signals documentation](signals.html) for more +details. the handler ID (always greater than 0) @@ -17203,7 +17228,15 @@ by temporarily adding a reference count to @gobject. When the @gobject is destroyed the signal handler will be automatically disconnected. Note that this is not currently threadsafe (ie: emitting a signal while @gobject is being destroyed in another thread -is not safe). +is not safe). + +This function cannot fail. If the given signal name doesn’t exist, +a critical warning is emitted. No validation is performed on the +"detail" string when specified in @detailed_signal, other than a +non-empty check. + +Refer to the [signals documentation](signals.html) for more +details. the handler id. @@ -17260,8 +17293,13 @@ g_signal_connect (button, "clicked", (GCallback) button_clicked_cb, other_widget); ]| -This function cannot fail. If the given signal doesn’t exist, a critical -warning is emitted. +This function cannot fail. If the given signal name doesn’t exist, +a critical warning is emitted. No validation is performed on the +‘detail’ string when specified in @detailed_signal, other than a +non-empty check. + +Refer to the [signals documentation](signals.html) for more +details. the instance to connect to. @@ -19568,5 +19606,69 @@ transformation function must be registered. + + Frees resources associated with a non-statically-allocated #GWeakRef. +After this call, the #GWeakRef is left in an undefined state. + +You should only call this on a #GWeakRef that previously had +g_weak_ref_init() called on it. + + + + + + location of a weak reference, which + may be empty + + + + + + If @weak_ref is not empty, atomically acquire a strong +reference to the object it points to, and return that reference. + +This function is needed because of the potential race between taking +the pointer value and g_object_ref() on it, if the object was losing +its last reference at the same time in a different thread. + +The caller should release the resulting reference in the usual way, +by using g_object_unref(). + + the object pointed to + by @weak_ref, or %NULL if it was empty + + + + + location of a weak reference to a #GObject + + + + + + Initialise a non-statically-allocated #GWeakRef. + +This function also calls g_weak_ref_set() with @object on the +freshly-initialised weak reference. + +This function should always be matched with a call to +g_weak_ref_clear(). It is not necessary to use this function for a +#GWeakRef in static storage because it will already be +properly initialised. Just use g_weak_ref_set() directly. + + + + + + uninitialized or empty location for a weak + reference + + + + a #GObject or %NULL + + + + diff --git a/Gdk-4.0.gir b/Gdk-4.0.gir index bbcc36c6..9b5adf37 100644 --- a/Gdk-4.0.gir +++ b/Gdk-4.0.gir @@ -1851,6 +1851,7 @@ is returned. + Auxiliary object to create a `GdkContentFormats`. Create a new `GdkContentFormatsBuilder` object. diff --git a/Gio-2.0.gir b/Gio-2.0.gir index fa58f7b6..7543c16d 100644 --- a/Gio-2.0.gir +++ b/Gio-2.0.gir @@ -13732,8 +13732,9 @@ Note that @interface_ will hold a weak reference to @object. A #GDBusConnection. - - The unique bus name of the remote caller. + + The unique bus name of the remote caller or %NULL if + not specified by the caller, e.g. on peer-to-peer connections. @@ -14014,7 +14015,14 @@ the memory used is freed. - The type of the @method_call function in #GDBusInterfaceVTable. + The type of the @method_call function in #GDBusInterfaceVTable. + +@interface_name may be `NULL` if not specified by the sender, although it’s +encouraged for the sender to set it. If unset, and the object has only one +method (across all interfaces) matching @method_name, that method is invoked. +Otherwise, behaviour is implementation defined. See the +[D-Bus specification](https://dbus.freedesktop.org/doc/dbus-specification.html#message-protocol-types-method). +It is recommended to return [error@Gio.DBusError.UNKNOWN_METHOD]. @@ -14023,16 +14031,18 @@ the memory used is freed. A #GDBusConnection. - - The unique bus name of the remote caller. + + The unique bus name of the remote caller, or `NULL` if + not specified by the caller, e.g. on peer-to-peer connections. The object path that the method was invoked on. - - The D-Bus interface name the method was invoked on. + + The D-Bus interface name the method was invoked on, + or `NULL` if not specified by the sender. @@ -14064,8 +14074,9 @@ the memory used is freed. A #GDBusConnection. - - The unique bus name of the remote caller. + + The unique bus name of the remote caller or %NULL if + not specified by the caller, e.g. on peer-to-peer connections. @@ -15789,11 +15800,16 @@ it as an argument to the `handle_method_call()` function in a Gets the name of the D-Bus interface the method was invoked on. +This can be `NULL` if it was not specified by the sender. See +[callback@Gio.DBusInterfaceMethodCallFunc] or the +[D-Bus Specification](https://dbus.freedesktop.org/doc/dbus-specification.html#message-protocol-types-method) +for details on when this can happen and how it should be handled. + If this method call is a property Get, Set or GetAll call that has been redirected to the method call handler then "org.freedesktop.DBus.Properties" will be returned. See #GDBusInterfaceVTable for more information. - + A string. Do not free, it is owned by @invocation. @@ -15906,8 +15922,11 @@ If the call was GetAll, %NULL will be returned. - Gets the bus name that invoked the method. - + Gets the bus name that invoked the method. + +This can return %NULL if not specified by the caller, e.g. on peer-to-peer +connections. + A string. Do not free, it is owned by @invocation. diff --git a/Gtk-3.0.gir b/Gtk-3.0.gir index 7b024b6f..f12b6d2b 100644 --- a/Gtk-3.0.gir +++ b/Gtk-3.0.gir @@ -141934,14 +141934,14 @@ should use gtk_accelerator_parse() instead. Parses a string representing an accelerator. The format looks like -“<Control>a” or “<Shift><Alt>F1” or “<Release>z” (the last one is +`<Control>a` or `<Shift><Alt>F1` or `<Release>z` (the last one is for key release). The parser is fairly liberal and allows lower or upper case, and also -abbreviations such as “<Ctl>” and “<Ctrl>”. Key names are parsed using +abbreviations such as `<Ctl>` and `<Ctrl>`. Key names are parsed using gdk_keyval_from_name(). For character keys the name is not the symbol, -but the lowercase name, e.g. one would use “<Ctrl>minus” instead of -“<Ctrl>-”. +but the lowercase name, e.g. one would use `<Ctrl>minus` instead of +`<Ctrl>-`. If the parse fails, @accelerator_key and @accelerator_mods will be set to 0 (zero). diff --git a/Gtk-4.0.gir b/Gtk-4.0.gir index adffcf29..c7c247c9 100644 --- a/Gtk-4.0.gir +++ b/Gtk-4.0.gir @@ -3261,11 +3261,11 @@ as %FALSE and %TRUE. - `GtkActionBar` is designed to present contextual actions. + Designed to present contextual actions. ![An example GtkActionBar](action-bar.png) -It is expected to be displayed below the content and expand +`GtkActionBar` is expected to be displayed below the content and expand horizontally to fill the area. It allows placing children at the start or the end. In addition, it @@ -3303,7 +3303,7 @@ Each of the boxes contains children packed for that side. - Creates a new `GtkActionBar` widget. + Creates a new action bar widget. a new `GtkActionBar` @@ -3312,12 +3312,12 @@ Each of the boxes contains children packed for that side. Retrieves the center bar widget of the bar. - the center `GtkWidget` + the center widget - a `GtkActionBar` + an action bsar @@ -3331,69 +3331,69 @@ Each of the boxes contains children packed for that side. - a `GtkActionBar` + an action bar - Adds @child to @action_bar, packed with reference to the -end of the @action_bar. + Adds a child to the action bar, packed with reference to the +end of the action bar. - A `GtkActionBar` + an action bar - the `GtkWidget` to be added to @action_bar + the widget to be added - Adds @child to @action_bar, packed with reference to the -start of the @action_bar. + Adds a child to the action, packed with reference to the +start of the action bar. - A `GtkActionBar` + an action bar - the `GtkWidget` to be added to @action_bar + the widget to be added - Removes a child from @action_bar. + Removes a child from the action bar. - a `GtkActionBar` + an action bar - the `GtkWidget` to be removed + the widget to be removed - Sets the center widget for the `GtkActionBar`. + Sets the center widget for the action bar. - a `GtkActionBar` + an action bar @@ -3405,7 +3405,7 @@ start of the @action_bar. Reveals or conceals the content of the action bar. -Note: this does not show or hide @action_bar in the +Note: this does not show or hide the action bar in the [property@Gtk.Widget:visible] sense, so revealing has no effect if the action bar is hidden. @@ -3413,11 +3413,11 @@ no effect if the action bar is hidden. - a `GtkActionBar` + an action bar - The new value of the property + the new value for the property @@ -5532,19 +5532,18 @@ Return or Enter. - `GtkApplication` is a high-level API for writing applications. + A high-level API for writing applications. -It supports many aspects of writing a GTK application in a convenient -fashion, without enforcing a one-size-fits-all model. +`GtkApplication` supports many aspects of writing a GTK application +in a convenient fashion, without enforcing a one-size-fits-all model. -Currently, `GtkApplication` handles GTK initialization, application -uniqueness, session management, provides some basic scriptability and -desktop shell integration by exporting actions and menus and manages a -list of toplevel windows whose life-cycle is automatically tied to the -life-cycle of your application. +Currently, it handles GTK initialization, application uniqueness, session +management, provides some basic scriptability and desktop shell integration +by exporting actions and menus and manages a list of toplevel windows whose +life-cycle is automatically tied to the life-cycle of your application. -While `GtkApplication` works fine with plain [class@Gtk.Window]s, it is -recommended to use it together with [class@Gtk.ApplicationWindow]. +While `GtkApplication` works fine with plain [class@Gtk.Window]s, +it is recommended to use it together with [class@Gtk.ApplicationWindow]. ## Automatic resources @@ -5606,21 +5605,21 @@ session while inhibitors are present. - Creates a new `GtkApplication` instance. + Creates a new application instance. When using `GtkApplication`, it is not necessary to call [func@Gtk.init] manually. It is called as soon as the application gets registered as the primary instance. Concretely, [func@Gtk.init] is called in the default handler for the -`GApplication::startup` signal. Therefore, `GtkApplication` subclasses should -always chain up in their `GApplication::startup` handler before using any GTK -API. +`GApplication::tartup` signal. Therefore, `GtkApplication` subclasses +should always chain up in their [vfunc@GIO.Application.startup] handler +before using any GTK API. Note that commandline arguments are not passed to [func@Gtk.init]. -If `application_id` is not %NULL, then it must be valid. See -`g_application_id_is_valid()`. +If `application_id` is not `NULL`, then it must be valid. See +[func@Gio.Application.id_is_valid]. If no application ID is given then some features (most notably application uniqueness) will be disabled. @@ -5671,31 +5670,30 @@ uniqueness) will be disabled. - Adds a window to `application`. + Adds a window to the application. -This call can only happen after the `application` has started; +This call can only happen after the application has started; typically, you should add new application windows in response -to the emission of the `GApplication::activate` signal. +to the emission of the [signal@GIO.Application::activate] signal. This call is equivalent to setting the [property@Gtk.Window:application] -property of `window` to `application`. +property of the window to @application. Normally, the connection between the application and the window will remain until the window is destroyed, but you can explicitly remove it with [method@Gtk.Application.remove_window]. -GTK will keep the `application` running as long as it has -any windows. +GTK will keep the application running as long as it has any windows. - a `GtkApplication` + an application - a `GtkWindow` + a window @@ -5705,14 +5703,14 @@ any windows. the given action. - accelerators for `detailed_action_name` + accelerators for @detailed_action_name - a `GtkApplication` + an application @@ -5723,7 +5721,7 @@ the given action. - Returns the list of actions (possibly empty) that `accel` maps to. + Returns the list of actions (possibly empty) that the accelerator maps to. Each item in the list is a detailed action name in the usual form. @@ -5741,14 +5739,14 @@ It is a programmer error to pass an invalid accelerator string. If you are unsure, check it with [func@Gtk.accelerator_parse] first. - a %NULL-terminated array of actions for `accel` + actions for @accel - a `GtkApplication` + a application @@ -5760,17 +5758,17 @@ If you are unsure, check it with [func@Gtk.accelerator_parse] first. Gets the “active” window for the application. -The active window is the one that was most recently focused (within -the application). This window may not have the focus at the moment -if another application has it — this is just the most -recently-focused window within this application. +The active window is the one that was most recently focused +(within the application). This window may not have the focus +at the moment if another application has it — this is just +the most recently-focused window within this application. the active window - a `GtkApplication` + an application @@ -5782,46 +5780,45 @@ See [the section on Automatic resources](class.Application.html#automatic-resour for more information. Gets the menu with the - given id from the automatically loaded resources + given ID from the automatically loaded resources - a `GtkApplication` + an application - the id of the menu to look up + the ID of the menu to look up - Returns the menu model that has been set with -[method@Gtk.Application.set_menubar]. + Returns the menu model for the menu bar of the application. - the menubar for windows of `application` + the menubar for windows of the application - a `GtkApplication` + an application - Returns the [class@Gtk.ApplicationWindow] with the given ID. + Returns the window with the given ID. The ID of a `GtkApplicationWindow` can be retrieved with [method@Gtk.ApplicationWindow.get_id]. - the window for the given `id` + the window for the given ID - a `GtkApplication` + an application` @@ -5831,7 +5828,7 @@ The ID of a `GtkApplicationWindow` can be retrieved with - Gets a list of the [class@Gtk.Window] instances associated with `application`. + Gets a list of the window associated with the application. The list is sorted by most recently focused window, such that the first element is the currently focused window. (Useful for choosing a parent @@ -5841,21 +5838,20 @@ The list that is returned should not be modified in any way. It will only remain valid until the next focus change or window creation or deletion. - a `GList` of `GtkWindow` - instances + the list of windows - a `GtkApplication` + an application - Inform the session manager that certain types of actions should be + Informs the session manager that certain types of actions should be inhibited. This is not guaranteed to work on all platforms and for all types of @@ -5863,7 +5859,7 @@ actions. Applications should invoke this method when they begin an operation that should not be interrupted, such as creating a CD or DVD. The -types of actions that may be blocked are specified by the `flags` +types of actions that may be blocked are specified by the @flags parameter. When the application completes the operation it should call [method@Gtk.Application.uninhibit] to remove the inhibitor. Note that an application can have multiple inhibitors, and all of them must @@ -5874,24 +5870,27 @@ Applications should not expect that they will always be able to block the action. In most cases, users will be given the option to force the action to take place. -The `reason` message should be short and to the point. +The @reason message should be short and to the point. -If `window` is given, the session manager may point the user to -this window to find out more about why the action is inhibited. +If a window is given, the session manager may point the user to +this window to find out more about why the action is inhibited. + +The cookie tha tis returned by this function should be used as an +argument to [method@Gtk.Application.uninhibit] in order to remove +the request. - A non-zero cookie that is used to uniquely identify this - request. It should be used as an argument to [method@Gtk.Application.uninhibit] - in order to remove the request. If the platform does not support - inhibiting or the request failed for some reason, 0 is returned. + A non-zero cookie that is used to uniquely identify this, or + 0 if the platform does not support inhibiting or the request failed + for some reason - the `GtkApplication` + the application - a `GtkWindow` + a window @@ -5917,30 +5916,30 @@ See [method@Gtk.Application.set_accels_for_action]. - a `GtkApplication` + an application - Remove a window from `application`. + Remove a window from the application. -If `window` belongs to `application` then this call is equivalent to -setting the [property@Gtk.Window:application] property of `window` to -`NULL`. +If the window belongs to the application then this call is +equivalent to setting the [property@Gtk.Window:application] +property of the window to `NULL`. The application may stop running as a result of a call to this -function, if `window` was the last window of the `application`. +function, if the window was the last window of the application. - a `GtkApplication` + an pplication - a `GtkWindow` + a window @@ -5949,20 +5948,20 @@ function, if `window` was the last window of the `application`. Sets zero or more keyboard accelerators that will trigger the given action. -The first item in `accels` will be the primary accelerator, which may be -displayed in the UI. +The first item in @accels will be the primary accelerator, +which may be displayed in the UI. -To remove all accelerators for an action, use an empty, zero-terminated -array for `accels`. +To remove all accelerators for an action, use an empty, +zero-terminated array for @accels. -For the `detailed_action_name`, see `g_action_parse_detailed_name()` and -`g_action_print_detailed_name()`. +For the @detailed_action_name, see [func@Gio.Action.parse_detailed_name] +and [Gio.Action.print_detailed_name]. - a `GtkApplication` + an application @@ -5980,16 +5979,16 @@ For the `detailed_action_name`, see `g_action_parse_detailed_name()` and - Sets or unsets the menubar for windows of `application`. + Sets or unsets the menubar for windows of the application. This is a menubar in the traditional sense. This can only be done in the primary instance of the application, -after it has been registered. `GApplication::startup` is a good place -to call this. +after it has been registered. [vfunc@GIO.Application.startup] is +a good place to call this. Depending on the desktop environment, this may appear at the top of -each window, or at the top of the screen. In some environments, if +each window, or at the top of the screen. In some environments, if both the application menu and the menubar are set, the application menu will be presented as if it were the first item of the menubar. Other environments treat the two as completely separate — for example, @@ -6003,11 +6002,11 @@ user selecting these menu items. - a `GtkApplication` + an application - a `GMenuModel` + a menu model @@ -6023,7 +6022,7 @@ Inhibitors are also cleared when the application exits. - the `GtkApplication` + the application @@ -6037,22 +6036,22 @@ Inhibitors are also cleared when the application exits. - The `GMenuModel` to be used for the application's menu bar. + The menu model to be used for the application's menu bar. - Set this property to `TRUE` to register with the session manager. + Set this property to true to register with the session manager. This will make GTK track the session state (such as the [property@Gtk.Application:screensaver-active] property). - This property is `TRUE` if GTK believes that the screensaver is -currently active. + This property is true if GTK believes that the screensaver +is currently active. GTK only tracks session state (including this) when -[property@Gtk.Application:register-session] is set to %TRUE. +[property@Gtk.Application:register-session] is set to true. Tracking the screensaver state is currently only supported on Linux. @@ -6065,28 +6064,29 @@ Linux. Emitted when the session manager is about to end the session. This signal is only emitted if [property@Gtk.Application:register-session] -is `TRUE`. Applications can connect to this signal and call -[method@Gtk.Application.inhibit] with `GTK_APPLICATION_INHIBIT_LOGOUT` +is true. Applications can connect to this signal and call +[method@Gtk.Application.inhibit] with [flags@Gtk.ApplicationInhibitFlags.logout] to delay the end of the session until state has been saved. - Emitted when a [class@Gtk.Window] is added to `application` through -[method@Gtk.Application.add_window]. + Emitted when a window is added to an application. + +See [method@Gtk.Application.add_window]. - the newly-added [class@Gtk.Window] + the newly-added window - Emitted when a [class@Gtk.Window] is removed from `application`. + Emitted when a window is removed from an application. This can happen as a side-effect of the window being destroyed or explicitly through [method@Gtk.Application.remove_window]. @@ -6095,7 +6095,7 @@ or explicitly through [method@Gtk.Application.remove_window]. - the [class@Gtk.Window] that is being removed + the window that is being removed @@ -6168,18 +6168,17 @@ See [method@Gtk.Application.inhibit]. - `GtkApplicationWindow` is a `GtkWindow` subclass that integrates with -`GtkApplication`. + A `GtkWindow` subclass that integrates with `GtkApplication`. Notably, `GtkApplicationWindow` can handle an application menubar. -This class implements the `GActionGroup` and `GActionMap` interfaces, -to let you add window-specific actions that will be exported by the -associated [class@Gtk.Application], together with its application-wide +This class implements the [iface@Gio.ActionGroup] and [iface@Gio.ActionMap] +interfaces, to let you add window-specific actions that will be exported +by the associated [class@Gtk.Application], together with its application-wide actions. Window-specific actions are prefixed with the “win.” prefix and application-wide actions are prefixed with the “app.” prefix. Actions must be addressed with the prefixed name when -referring to them from a `GMenuModel`. +referring to them from a menu model. Note that widgets that are placed inside a `GtkApplicationWindow` can also activate these actions, if they implement the @@ -6255,7 +6254,7 @@ GtkWidget *window = gtk_application_window_new (app); - a `GtkApplication` + an application @@ -6266,12 +6265,12 @@ GtkWidget *window = gtk_application_window_new (app); See [method@Gtk.ApplicationWindow.set_help_overlay]. the help overlay associated - with @window + with the window - a `GtkApplicationWindow` + an application window @@ -6281,13 +6280,13 @@ See [method@Gtk.ApplicationWindow.set_help_overlay]. If the window has not yet been added to a `GtkApplication`, returns `0`. - the unique ID for @window, or `0` if the window - has not yet been added to a `GtkApplication` + the unique ID for the window, or `0` if the window + has not yet been added to an application - a `GtkApplicationWindow` + an application window @@ -6296,12 +6295,12 @@ See [method@Gtk.ApplicationWindow.set_help_overlay]. Returns whether the window will display a menubar for the app menu and menubar as needed. - %TRUE if @window will display a menubar when needed + True if the window will display a menubar when needed - a `GtkApplicationWindow` + an application window @@ -6312,17 +6311,17 @@ and menubar as needed. Additionally, sets up an action with the name `win.show-help-overlay` to present it. -@window takes responsibility for destroying @help_overlay. +The window takes responsibility for destroying the help overlay. - a `GtkApplicationWindow` + an application window - a `GtkShortcutsWindow` + a shortcuts window @@ -6335,7 +6334,7 @@ and menubar as needed. - a `GtkApplicationWindow` + an application window @@ -6345,12 +6344,12 @@ and menubar as needed. - If this property is %TRUE, the window will display a menubar + If this property is true, the window will display a menubar unless it is shown by the desktop shell. See [method@Gtk.Application.set_menubar]. -If %FALSE, the window will not display a menubar, regardless +If false, the window will not display a menubar, regardless of whether the desktop shell is showing it or not. @@ -7291,7 +7290,7 @@ See gtk_assistant_commit() for details. add its own buttons through gtk_assistant_add_action_widget(). - + Like [func@get_binary_age], but from the headers used at application compile time, rather than from the library linked against at application run time. @@ -58794,7 +58793,7 @@ This macro is longer used by GTK. - + Like [func@get_micro_version], but from the headers used at application compile time, rather than from the library linked against at application run time.