Merge pull request #697 from GuillaumeGomez/must-use

GuillaumeGomez · web-flow · commit 1f8207970382 · 2022-01-04T19:38:43.000+01:00
[gir] Generate #[must_use] where needed
diff --git a/atk/src/auto/object.rs b/atk/src/auto/object.rs
@@ -72,6 +72,7 @@ pub trait AtkObjectExt: 'static {
 
     #[doc(alias = "atk_object_get_parent")]
     #[doc(alias = "get_parent")]
+    #[must_use]
     fn parent(&self) -> Option<Object>;
 
     #[doc(alias = "atk_object_get_role")]
@@ -85,9 +86,11 @@ pub trait AtkObjectExt: 'static {
     fn notify_state_change(&self, state: State, value: bool);
 
     #[doc(alias = "atk_object_peek_parent")]
+    #[must_use]
     fn peek_parent(&self) -> Option<Object>;
 
     #[doc(alias = "atk_object_ref_accessible_child")]
+    #[must_use]
     fn ref_accessible_child(&self, i: i32) -> Option<Object>;
 
     #[doc(alias = "atk_object_ref_relation_set")]
diff --git a/atk/src/auto/state_set.rs b/atk/src/auto/state_set.rs
@@ -40,6 +40,7 @@ pub trait StateSetExt: 'static {
     //fn add_states(&self, types: /*Unimplemented*/&CArray TypeId { ns_id: 1, id: 68 });
 
     #[doc(alias = "atk_state_set_and_sets")]
+    #[must_use]
     fn and_sets(&self, compare_set: &impl IsA<StateSet>) -> Option<StateSet>;
 
     #[doc(alias = "atk_state_set_clear_states")]
@@ -55,12 +56,14 @@ pub trait StateSetExt: 'static {
     fn is_empty(&self) -> bool;
 
     #[doc(alias = "atk_state_set_or_sets")]
+    #[must_use]
     fn or_sets(&self, compare_set: &impl IsA<StateSet>) -> Option<StateSet>;
 
     #[doc(alias = "atk_state_set_remove_state")]
     fn remove_state(&self, type_: StateType) -> bool;
 
     #[doc(alias = "atk_state_set_xor_sets")]
+    #[must_use]
     fn xor_sets(&self, compare_set: &impl IsA<StateSet>) -> Option<StateSet>;
 }
 
diff --git a/atk/src/auto/versions.txt b/atk/src/auto/versions.txt
@@ -1,2 +1,2 @@
-Generated by gir (https://github.com/gtk-rs/gir @ e1c90d705644)
+Generated by gir (https://github.com/gtk-rs/gir @ 79e747a1a188)
 from gir-files (https://github.com/gtk-rs/gir-files @ 898f6c1fb177)
diff --git a/atk/sys/versions.txt b/atk/sys/versions.txt
@@ -1,2 +1,2 @@
-Generated by gir (https://github.com/gtk-rs/gir @ e1c90d705644)
+Generated by gir (https://github.com/gtk-rs/gir @ 79e747a1a188)
 from gir-files (https://github.com/gtk-rs/gir-files @ 898f6c1fb177)
diff --git a/gdk/src/auto/device.rs b/gdk/src/auto/device.rs
@@ -49,6 +49,7 @@ glib::wrapper! {
 impl Device {
     #[doc(alias = "gdk_device_get_associated_device")]
     #[doc(alias = "get_associated_device")]
+    #[must_use]
     pub fn associated_device(&self) -> Option<Device> {
         unsafe { from_glib_none(ffi::gdk_device_get_associated_device(self.to_glib_none().0)) }
     }
diff --git a/gdk/src/auto/gl_context.rs b/gdk/src/auto/gl_context.rs
@@ -60,6 +60,7 @@ impl GLContext {
 
     #[doc(alias = "gdk_gl_context_get_shared_context")]
     #[doc(alias = "get_shared_context")]
+    #[must_use]
     pub fn shared_context(&self) -> Option<GLContext> {
         unsafe {
             from_glib_none(ffi::gdk_gl_context_get_shared_context(
diff --git a/gdk/src/auto/rectangle.rs b/gdk/src/auto/rectangle.rs
@@ -45,6 +45,7 @@ impl Rectangle {
     }
 
     #[doc(alias = "gdk_rectangle_union")]
+    #[must_use]
     pub fn union(&self, src2: &Rectangle) -> Rectangle {
         unsafe {
             let mut dest = Rectangle::uninitialized();
diff --git a/gdk/src/auto/versions.txt b/gdk/src/auto/versions.txt
@@ -1,2 +1,2 @@
-Generated by gir (https://github.com/gtk-rs/gir @ e1c90d705644)
+Generated by gir (https://github.com/gtk-rs/gir @ 79e747a1a188)
 from gir-files (https://github.com/gtk-rs/gir-files @ 898f6c1fb177)
diff --git a/gdk/src/auto/window.rs b/gdk/src/auto/window.rs
@@ -438,12 +438,14 @@ impl Window {
 
     #[doc(alias = "gdk_window_get_effective_parent")]
     #[doc(alias = "get_effective_parent")]
+    #[must_use]
     pub fn effective_parent(&self) -> Option<Window> {
         unsafe { from_glib_none(ffi::gdk_window_get_effective_parent(self.to_glib_none().0)) }
     }
 
     #[doc(alias = "gdk_window_get_effective_toplevel")]
     #[doc(alias = "get_effective_toplevel")]
+    #[must_use]
     pub fn effective_toplevel(&self) -> Window {
         unsafe {
             from_glib_none(ffi::gdk_window_get_effective_toplevel(
@@ -517,6 +519,7 @@ impl Window {
 
     #[doc(alias = "gdk_window_get_group")]
     #[doc(alias = "get_group")]
+    #[must_use]
     pub fn group(&self) -> Option<Window> {
         unsafe { from_glib_none(ffi::gdk_window_get_group(self.to_glib_none().0)) }
     }
@@ -549,6 +552,7 @@ impl Window {
 
     #[doc(alias = "gdk_window_get_parent")]
     #[doc(alias = "get_parent")]
+    #[must_use]
     pub fn parent(&self) -> Option<Window> {
         unsafe { from_glib_none(ffi::gdk_window_get_parent(self.to_glib_none().0)) }
     }
@@ -645,6 +649,7 @@ impl Window {
 
     #[doc(alias = "gdk_window_get_toplevel")]
     #[doc(alias = "get_toplevel")]
+    #[must_use]
     pub fn toplevel(&self) -> Window {
         unsafe { from_glib_none(ffi::gdk_window_get_toplevel(self.to_glib_none().0)) }
     }
diff --git a/gdk/sys/versions.txt b/gdk/sys/versions.txt
@@ -1,2 +1,2 @@
-Generated by gir (https://github.com/gtk-rs/gir @ e1c90d705644)
+Generated by gir (https://github.com/gtk-rs/gir @ 79e747a1a188)
 from gir-files (https://github.com/gtk-rs/gir-files @ 898f6c1fb177)
diff --git a/gdkx11/src/auto/versions.txt b/gdkx11/src/auto/versions.txt
@@ -1,2 +1,2 @@
-Generated by gir (https://github.com/gtk-rs/gir @ e1c90d705644)
+Generated by gir (https://github.com/gtk-rs/gir @ 79e747a1a188)
 from gir-files (https://github.com/gtk-rs/gir-files @ 898f6c1fb177)
diff --git a/gdkx11/sys/versions.txt b/gdkx11/sys/versions.txt
@@ -1,2 +1,2 @@
-Generated by gir (https://github.com/gtk-rs/gir @ e1c90d705644)
+Generated by gir (https://github.com/gtk-rs/gir @ 79e747a1a188)
 from gir-files (https://github.com/gtk-rs/gir-files @ 898f6c1fb177)
diff --git a/gir b/gir
@@ -1 +1 @@
-Subproject commit e1c90d70564418550a321b11f89b4a578f2ad43a
+Subproject commit 79e747a1a188038046cf02ccf997ec0b60ffb853
diff --git a/gtk/src/auto/css_section.rs b/gtk/src/auto/css_section.rs
@@ -37,6 +37,7 @@ impl CssSection {
 
     #[doc(alias = "gtk_css_section_get_parent")]
     #[doc(alias = "get_parent")]
+    #[must_use]
     pub fn parent(&self) -> Option<CssSection> {
         unsafe { from_glib_none(ffi::gtk_css_section_get_parent(self.to_glib_none().0)) }
     }
diff --git a/gtk/src/auto/page_setup.rs b/gtk/src/auto/page_setup.rs
@@ -77,6 +77,7 @@ impl PageSetup {
     }
 
     #[doc(alias = "gtk_page_setup_copy")]
+    #[must_use]
     pub fn copy(&self) -> Option<PageSetup> {
         unsafe { from_glib_full(ffi::gtk_page_setup_copy(self.to_glib_none().0)) }
     }
diff --git a/gtk/src/auto/print_settings.rs b/gtk/src/auto/print_settings.rs
@@ -86,6 +86,7 @@ impl PrintSettings {
     }
 
     #[doc(alias = "gtk_print_settings_copy")]
+    #[must_use]
     pub fn copy(&self) -> Option<PrintSettings> {
         unsafe { from_glib_full(ffi::gtk_print_settings_copy(self.to_glib_none().0)) }
     }
diff --git a/gtk/src/auto/style_context.rs b/gtk/src/auto/style_context.rs
@@ -186,6 +186,7 @@ pub trait StyleContextExt: 'static {
 
     #[doc(alias = "gtk_style_context_get_parent")]
     #[doc(alias = "get_parent")]
+    #[must_use]
     fn parent(&self) -> Option<StyleContext>;
 
     #[doc(alias = "gtk_style_context_get_path")]
diff --git a/gtk/src/auto/text_attributes.rs b/gtk/src/auto/text_attributes.rs
@@ -23,6 +23,7 @@ impl TextAttributes {
     }
 
     #[doc(alias = "gtk_text_attributes_copy")]
+    #[must_use]
     pub fn copy(&self) -> Option<TextAttributes> {
         unsafe { from_glib_full(ffi::gtk_text_attributes_copy(self.to_glib_none().0)) }
     }
diff --git a/gtk/src/auto/versions.txt b/gtk/src/auto/versions.txt
@@ -1,2 +1,2 @@
-Generated by gir (https://github.com/gtk-rs/gir @ e1c90d705644)
+Generated by gir (https://github.com/gtk-rs/gir @ 79e747a1a188)
 from gir-files (https://github.com/gtk-rs/gir-files @ 898f6c1fb177)
diff --git a/gtk/src/auto/widget.rs b/gtk/src/auto/widget.rs
@@ -260,6 +260,7 @@ pub trait WidgetExt: 'static {
 
     #[doc(alias = "gtk_widget_get_ancestor")]
     #[doc(alias = "get_ancestor")]
+    #[must_use]
     fn ancestor(&self, widget_type: glib::types::Type) -> Option<Widget>;
 
     #[doc(alias = "gtk_widget_get_app_paintable")]
@@ -386,6 +387,7 @@ pub trait WidgetExt: 'static {
 
     #[doc(alias = "gtk_widget_get_parent")]
     #[doc(alias = "get_parent")]
+    #[must_use]
     fn parent(&self) -> Option<Widget>;
 
     #[doc(alias = "gtk_widget_get_parent_window")]
@@ -481,6 +483,7 @@ pub trait WidgetExt: 'static {
 
     #[doc(alias = "gtk_widget_get_toplevel")]
     #[doc(alias = "get_toplevel")]
+    #[must_use]
     fn toplevel(&self) -> Option<Widget>;
 
     #[doc(alias = "gtk_widget_get_valign")]
diff --git a/gtk/src/auto/widget_path.rs b/gtk/src/auto/widget_path.rs
@@ -53,6 +53,7 @@ impl WidgetPath {
     }
 
     #[doc(alias = "gtk_widget_path_copy")]
+    #[must_use]
     pub fn copy(&self) -> Option<WidgetPath> {
         unsafe { from_glib_full(ffi::gtk_widget_path_copy(self.to_glib_none().0)) }
     }
@@ -135,6 +136,7 @@ impl WidgetPath {
     }
 
     #[doc(alias = "gtk_widget_path_iter_get_siblings")]
+    #[must_use]
     pub fn iter_get_siblings(&self, pos: i32) -> Option<WidgetPath> {
         unsafe {
             from_glib_none(ffi::gtk_widget_path_iter_get_siblings(
diff --git a/gtk/src/auto/window.rs b/gtk/src/auto/window.rs
@@ -895,6 +895,7 @@ pub trait GtkWindowExt: 'static {
 
     #[doc(alias = "gtk_window_get_transient_for")]
     #[doc(alias = "get_transient_for")]
+    #[must_use]
     fn transient_for(&self) -> Option<Window>;
 
     #[doc(alias = "gtk_window_get_type_hint")]
diff --git a/gtk/sys/versions.txt b/gtk/sys/versions.txt
@@ -1,2 +1,2 @@
-Generated by gir (https://github.com/gtk-rs/gir @ e1c90d705644)
+Generated by gir (https://github.com/gtk-rs/gir @ 79e747a1a188)
 from gir-files (https://github.com/gtk-rs/gir-files @ 898f6c1fb177)

Original file line number	Diff line number	Diff line change
`@@ -1,2 +1,2 @@`
`1`		`-Generated by gir (https://github.com/gtk-rs/gir @ e1c90d705644)`
	`1`	`+Generated by gir (https://github.com/gtk-rs/gir @ 79e747a1a188)`
`2`	`2`	`from gir-files (https://github.com/gtk-rs/gir-files @ 898f6c1fb177)`
Original file line number	Diff line number	Diff line change
`@@ -49,6 +49,7 @@ glib::wrapper! {`
`49`	`49`	`impl Device {`
`50`	`50`	`#[doc(alias = "gdk_device_get_associated_device")]`
`51`	`51`	`#[doc(alias = "get_associated_device")]`
	`52`	`+ #[must_use]`
`52`	`53`	`pub fn associated_device(&self) -> Option<Device> {`
`53`	`54`	`unsafe { from_glib_none(ffi::gdk_device_get_associated_device(self.to_glib_none().0)) }`
`54`	`55`	`}`
Original file line number	Diff line number	Diff line change
`@@ -45,6 +45,7 @@ impl Rectangle {`
`45`	`45`	`}`
`46`	`46`
`47`	`47`	`#[doc(alias = "gdk_rectangle_union")]`
	`48`	`+ #[must_use]`
`48`	`49`	`pub fn union(&self, src2: &Rectangle) -> Rectangle {`
`49`	`50`	`unsafe {`
`50`	`51`	`let mut dest = Rectangle::uninitialized();`