API consistency with x11 move_to_{top,bottom}

libqtile/backend/base/window.py

@@ -197,25 +197,31 @@ def move_down(self, force: bool = False) -> None:
         """
 
     @expose_command()
-    def move_to_top(self) -> None:
+    def move_to_top(self, force: bool = False) -> None:
         """
         Move this window above all windows in the current layer
         e.g. if you have 3 windows all with "keep_above" set, calling
         this method will move the window to the top of those three windows.
 
         Calling this on a "normal" window will not raise it above a "kept_above"
         window.
+
+        Will not raise a window where "keep_below" is True unless
+        force is set to True.
         """
 
     @expose_command()
-    def move_to_bottom(self) -> None:
+    def move_to_bottom(self, force: bool = False) -> None:
         """
         Move this window below all windows in the current layer
         e.g. if you have 3 windows all with "keep_above" set, calling
         this method will move the window to the bottom of those three windows.
 
         Calling this on a "normal" window will not raise it below a "kept_below"
         window.
+
+        Will not lower a window where "keep_above" is True unless
+        force is set to True.
         """
 
 

libqtile/backend/wayland/window.py

@@ -777,12 +777,12 @@ def is_visible(self) -> bool:
         return self.container.node.enabled
 
     @expose_command()
-    def move_to_top(self) -> None:
+    def move_to_top(self, force=False) -> None:
         if self.tree:
             self.tree.node.raise_to_top()
 
     @expose_command()
-    def move_to_bottom(self) -> None:
+    def move_to_bottom(self, force=False) -> None:
         if self.tree:
             self.tree.node.lower_to_bottom()
 
@@ -916,11 +916,11 @@ def bring_to_front(self) -> None:
         self.container.node.raise_to_top()
 
     @expose_command()
-    def move_to_top(self) -> None:
+    def move_to_top(self, force=False) -> None:
         self.container.node.raise_to_top()
 
     @expose_command()
-    def move_to_bottom(self) -> None:
+    def move_to_bottom(self, force=False) -> None:
         self.container.node.lower_to_bottom()
 
     @expose_command()
@@ -1128,11 +1128,11 @@ def bring_to_front(self) -> None:
         self.tree.node.raise_to_top()
 
     @expose_command()
-    def move_to_top(self) -> None:
+    def move_to_top(self, force=False) -> None:
         self.tree.node.raise_to_top()
 
     @expose_command()
-    def move_to_bottom(self) -> None:
+    def move_to_bottom(self, force=False) -> None:
         self.tree.node.lower_to_bottom()