Merge remote-tracking branch 'upstream/main' into force_render

Author: busyoGG

docs/wiki/Accessibility.md

@@ -10,6 +10,7 @@ Specifically, niri will announce:
 
 - workspace switching, for example it'll say "Workspace 2" when you switch to the second workspace;
 - the exit confirmation dialog (appears on <kbd>Super</kbd><kbd>Shift</kbd><kbd>E</kbd> by default);
+- <sup>Since: next release</sup> niri has an <kbd>Alt</kbd><kbd>Tab</kbd> window switcher where it will announce the selected window title;
 - entering the screenshot UI and the overview (niri will say when these are focused, nothing else for now);
 - whenever a config parse error occurs;
 - the important hotkeys list (for now, as one big announcement without tab navigation; appears on <kbd>Super</kbd><kbd>Shift</kbd><kbd>/</kbd> by default).
@@ -27,7 +28,6 @@ The default config binds <kbd>Super</kbd><kbd>Alt</kbd><kbd>S</kbd> to toggle Or
 
 Note that there are some limitations:
 
-- We don't have an Alt-Tab window switcher yet; it's in the works.
 - We don't have a bind to move focus to layer-shell panels. This is not hard to add, but it would be good to have some consensus or prior art with LXQt/Xfce on how exactly this should work.
 - You need to have a screen connected and enabled. Without a screen, niri won't give focus any window. This makes sense for sighted users, and I'm not entirely sure what makes the most sense for accessibility purposes (maybe, it'd be better solved with virtual monitors).
 - You need working EGL (hardware acceleration).

docs/wiki/Application-Issues.md

@@ -52,6 +52,17 @@ To fix this, run them with the `_JAVA_AWT_WM_NONREPARENTING=1` environment varia
 For some reason, DMABUF screencasts are disabled in the Zen Browser, so screencasting doesn't work out of the box on niri.
 To fix it, open `about:config` and set `widget.dmabuf.force-enabled` to `true`.
 
+### GTK 4 dead keys / Compose
+
+GTK 4.20 [stopped](https://gitlab.gnome.org/GNOME/gtk/-/merge_requests/8556) handling dead keys and Compose on its own on Wayland.
+To make them work, either run an IME like IBus or Fcitx5, or set the `GTK_IM_MODULE=simple` environment variable.
+
+```kdl
+environment {
+    GTK_IM_MODULE "simple"
+}
+```
+
 ### Fullscreen games
 
 Some video games, both Linux-native and on Wine, have various issues when using non-stacking desktop environments.

docs/wiki/Configuration:-Debug-Options.md

@@ -32,7 +32,6 @@ debug {
     honor-xdg-activation-with-invalid-serial
     skip-cursor-only-updates-during-vrr
     deactivate-unfocused-windows
-    keep-max-bpc-unchanged
 }
 
 binds {
@@ -320,6 +319,10 @@ Apparently, setting max bpc to 8 breaks some displays driven by AMDGPU.
 If this happens to you, set this debug flag, which will prevent niri from changing max bpc.
 AMDGPU bug report: https://gitlab.freedesktop.org/drm/amd/-/issues/4487.
 
+<sup>Since: next release</sup>
+This setting is deprecated and does nothing: niri no longer sets max bpc.
+The old niri behavior with this setting enabled matches the new behavior.
+
 ```kdl
 debug {
     keep-max-bpc-unchanged

docs/wiki/Configuration:-Outputs.md

@@ -97,6 +97,10 @@ output "eDP-1" {
 You can configure a custom mode (not offered by the monitor) by setting `custom=true`.
 In this case, the refresh rate is mandatory.
 
+Custom modes are not guaranteed to work.
+Niri is asking the monitor to run in a mode not supported by the manufacturer.
+Use at your own risk.
+
 > [!CAUTION]
 > Custom modes may damage your monitor, especially if it's a CRT.
 > Follow the maximum supported limits in your monitor's instructions.
@@ -115,6 +119,10 @@ output "HDMI-A-1" {
 Directly configures the monitor's mode via a modeline, overriding any configured `mode`.
 The modeline can be calculated via utilities such as [cvt](https://man.archlinux.org/man/cvt.1.en) or [gtf](https://man.archlinux.org/man/gtf.1.en).
 
+Modelines are not guaranteed to work.
+Niri is asking the monitor to run in a mode not supported by the manufacturer.
+Use at your own risk.
+
 > [!CAUTION]
 > Out of spec modelines may damage your monitor, especially if it's a CRT.
 > Follow the maximum supported limits in your monitor's instructions.

docs/wiki/Configuration:-Recent-Windows.md

@@ -138,7 +138,8 @@ recent-windows {
 }
 ```
 
-The recent windows binds have a precedence over the [normal binds](./Configuration:-Key-Bindings.md), meaning that if you have <kbd>Alt</kbd><kbd>Tab</kbd> bound to something else in the normal binds, the `recent-windows` bind will override it.
+The recent windows binds have lower precedence than the [normal binds](./Configuration:-Key-Bindings.md), meaning that if you have <kbd>Alt</kbd><kbd>Tab</kbd> bound to something else in the normal binds, the `recent-windows` bind won't work.
+In this case, you can remove the conflicting normal bind.
 
 All binds in this section must have a modifier key like <kbd>Alt</kbd> or <kbd>Mod</kbd> because the recent windows switcher remains open only while you hold any modifier key.
 

docs/wiki/FAQ.md

@@ -142,3 +142,8 @@ profile {
 	output eDP-1 enable scale 1.25 position 1920,0
 }
 ```
+
+### Why does Firefox or Thunderbird have 1 px smaller border?
+
+They draw their own 1 px dark border around the window, which obscures one pixel of niri's border.
+If you don't like this, set the [`clip-to-geometry true` window rule](./Configuration:-Window-Rules.md#clip-to-geometry).

docs/wiki/Getting-Started.md

@@ -11,7 +11,7 @@ systemctl --user add-wants niri.service dms
 
 Arch Linux (via [paru](https://github.com/morganamilo/paru)):
 ```
-sudo pacman -Syu niri xwayland-satellite xdg-desktop-portal-gnome xdg-desktop-portal-gtk
+sudo pacman -Syu niri xwayland-satellite xdg-desktop-portal-gnome xdg-desktop-portal-gtk alacritty
 paru -S dms-shell-bin matugen wl-clipboard cliphist cava qt6-multimedia-ffmpeg
 systemctl --user add-wants niri.service dms
 ```

docs/wiki/_assets/stylesheets/niri.css

@@ -59,3 +59,8 @@
     padding: .5em 1.25em;
     vertical-align: middle;
 }
+
+/* Improve keyboard shortcuts for screen readers: this way they won't break on them. */
+.md-typeset kbd {
+    display: inline;
+}

niri.spec.rpkg

@@ -128,6 +128,10 @@ sed -i 's/\[env\]/[env]\nNIRI_BUILD_COMMIT="%{version}"/' .cargo/config.toml
 %build
 %cargo_build
 
+target/rpm/niri completions bash > ./niri
+target/rpm/niri completions fish > ./niri.fish
+target/rpm/niri completions zsh > ./_niri
+
 %install
 %cargo_install
 
@@ -137,6 +141,10 @@ install -Dm644 -t %{buildroot}%{_datadir}/xdg-desktop-portal ./resources/niri-po
 install -Dm644 -t %{buildroot}%{_userunitdir} ./resources/niri.service
 install -Dm644 -t %{buildroot}%{_userunitdir} ./resources/niri-shutdown.target
 
+install -Dm644 -t %{buildroot}%{bash_completions_dir} ./niri
+install -Dm644 -t %{buildroot}%{fish_completions_dir} ./niri.fish
+install -Dm644 -t %{buildroot}%{zsh_completions_dir} ./_niri
+
 %if %{with check}
 %check
 # Skip tests that run into open fd limits, until we figure out a fix.
@@ -155,6 +163,9 @@ install -Dm644 -t %{buildroot}%{_userunitdir} ./resources/niri-shutdown.target
 %{_datadir}/xdg-desktop-portal/niri-portals.conf
 %{_userunitdir}/niri.service
 %{_userunitdir}/niri-shutdown.target
+%{bash_completions_dir}/niri
+%{fish_completions_dir}/niri.fish
+%{zsh_completions_dir}/_niri
 
 %changelog
 {{{ git_dir_changelog }}}

resources/default-config.kdl

@@ -374,7 +374,8 @@ binds {
     // Example volume keys mappings for PipeWire & WirePlumber.
     // The allow-when-locked=true property makes them work even when the session is locked.
     // Using spawn-sh allows to pass multiple arguments together with the command.
-    XF86AudioRaiseVolume allow-when-locked=true { spawn-sh "wpctl set-volume @DEFAULT_AUDIO_SINK@ 0.1+"; }
+    // "-l 1.0" limits the volume to 100%.
+    XF86AudioRaiseVolume allow-when-locked=true { spawn-sh "wpctl set-volume @DEFAULT_AUDIO_SINK@ 0.1+ -l 1.0"; }
     XF86AudioLowerVolume allow-when-locked=true { spawn-sh "wpctl set-volume @DEFAULT_AUDIO_SINK@ 0.1-"; }
     XF86AudioMute        allow-when-locked=true { spawn-sh "wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle"; }
     XF86AudioMicMute     allow-when-locked=true { spawn-sh "wpctl set-mute @DEFAULT_AUDIO_SOURCE@ toggle"; }