Remove wrong annotation for GdkToplevel::compute-size
authorEmmanuele Bassi <ebassi@gnome.org>
Sun, 26 Mar 2023 14:48:44 +0000 (15:48 +0100)
committerMatthias Clasen <mclasen@redhat.com>
Fri, 21 Apr 2023 06:43:34 +0000 (08:43 +0200)
The size argument is passed to the signal by the GDK surface machinery,
as is: it's not going to be allocated by the caller (since it's a
signal), and it's not an out argument.

gdk/gdktoplevel.c

index a7e4e42fcf8664c62708827bf56abe70a8194fb0..5a5c9e4d0f6c1eff6fd7eede86457cf4a474d8ab 100644 (file)
@@ -261,15 +261,16 @@ gdk_toplevel_default_init (GdkToplevelInterface *iface)
   /**
    * GdkToplevel::compute-size:
    * @toplevel: a `GdkToplevel`
-   * @size: (type Gdk.ToplevelSize) (out caller-allocates): a `GdkToplevelSize`
+   * @size: (type Gdk.ToplevelSize): a `GdkToplevelSize`
    *
    * Emitted when the size for the surface needs to be computed, when
    * it is present.
    *
-   * It will normally be emitted during or after [method@Gdk.Toplevel.present],
-   * depending on the configuration received by the windowing system.
-   * It may also be emitted at any other point in time, in response
-   * to the windowing system spontaneously changing the configuration.
+   * This signal will normally be emitted during or after a call to
+   * [method@Gdk.Toplevel.present], depending on the configuration
+   * received by the windowing system. It may also be emitted at any
+   * other point in time, in response to the windowing system
+   * spontaneously changing the configuration of the toplevel surface.
    *
    * It is the responsibility of the toplevel user to handle this signal
    * and compute the desired size of the toplevel, given the information