docs(hyprland): minimize disabled config diff

configs/nixos/modules/desktop/session/hyprland/hyprlock.nix

@@ -1,17 +1,13 @@
 {
   config,
   lib,
-  # pkgs,
+  pkgs,
   ...
 }:
 # The lock screen: a hyprlock session-lock surface the compositor owns.
 let
   user = config.user.name;
 
-  /*
-    Slice 1 disables the lock keybinds, so their supporting values stay
-    commented out with the bind block.
-
   # The hyprlock this module installs, used by the lock keybind below.
   hyprlock = "${config.home-manager.users.${user}.programs.hyprlock.package}/bin/hyprlock";
 
@@ -46,7 +42,6 @@ let
       ${pkgs.swayosd}/bin/swayosd-client --custom-message "${sleepOffIcon}"
     fi
   '';
-  */
 in
 {
   options.modules.desktop.session.hyprland.hyprlock.enable =
@@ -87,10 +82,10 @@ in
         };
       };
 
+      # Lock on Super+X.
+      # The guard drops the keypress when a locker is already up, so a second
+      # hyprlock never stacks over the first.
       /*
-        Slice 1 disables external Hyprland binds while the compositor config
-        moves to a minimal Lua baseline.
-
       wayland.windowManager.hyprland.settings.bind = [
         "$mod, X, exec, ${pkgs.procps}/bin/pidof hyprlock || ${hyprlock}"
         "$mod CTRL, X, exec, ${idleLockToggle}"

configs/nixos/modules/desktop/session/mako.nix

@@ -1,19 +1,14 @@
 {
   config,
   lib,
-  # pkgs,
+  pkgs,
   ...
 }:
 # mako as the notification daemon: toasts, a do-not-disturb mode, and history recall.
 let
   user = config.user.name;
 
-  /*
-    Slice 1 disables the Mako recall keybind, so its supporting value stays
-    commented out with the bind block.
-
   makoctl = "${pkgs.mako}/bin/makoctl";
-  */
 in
 {
   options.modules.desktop.session.mako.enable = lib.mkEnableOption "the mako notification daemon";
@@ -37,10 +32,10 @@ in
         };
       };
 
+      # Recall the last notification from history, keyboard-only like the rest
+      # of the session.
+      # $mod is defined by the compositor config these binds share.
       /*
-        Slice 1 disables external Hyprland binds while the compositor config
-        moves to a minimal Lua baseline.
-
       wayland.windowManager.hyprland.settings.bind = [
         "$mod, N, exec, ${makoctl} restore"
       ];

configs/nixos/modules/desktop/session/rofi.nix

@@ -1,17 +1,13 @@
 {
   config,
   lib,
-  # pkgs,
+  pkgs,
   ...
 }:
 # rofi as the desktop launcher and dmenu-style menu frontend.
 let
   user = config.user.name;
 
-  /*
-    Slice 1 disables the Rofi keybinds, so their supporting script stays
-    commented out with the bind block.
-
   # A session menu built on the same themed rofi, so the power actions look
   # like every other menu the launcher drives.
   powerMenu = pkgs.writeShellScript "rofi-power-menu" ''
@@ -25,7 +21,6 @@ let
       'Shut down') ${pkgs.systemd}/bin/systemctl poweroff ;;
     esac
   '';
-  */
 in
 {
   options.modules.desktop.session.rofi.enable = lib.mkEnableOption "the rofi launcher";
@@ -45,10 +40,9 @@ in
         };
       };
 
+      # The launcher and the session menu, kept next to the tool they drive.
+      # $mod is defined by the compositor config these binds share.
       /*
-        Slice 1 disables external Hyprland binds while the compositor config
-        moves to a minimal Lua baseline.
-
       wayland.windowManager.hyprland.settings.bind = [
         "$mod, R, exec, ${pkgs.rofi}/bin/rofi -show drun"
         "$mod SHIFT, X, exec, ${powerMenu}"

configs/nixos/modules/desktop/utilities/clipboard.nix

@@ -8,25 +8,20 @@
 let
   user = config.user.name;
 
-  /*
-    Slice 1 disables the clipboard picker keybind, so its supporting values
-    stay commented out with the bind block.
-
   cliphist = "${pkgs.cliphist}/bin/cliphist";
   rofi = "${pkgs.rofi}/bin/rofi";
   wl-copy = "${pkgs.wl-clipboard}/bin/wl-copy";
 
   # The picker reuses the themed rofi, so history looks like every other menu
   # the launcher drives.
-    # decode is needed because list emits id-prefixed lines rather than the
+  # decode is needed because list emits id-prefixed lines rather than the copied
-    # copied bytes must be resolved back before it can be re-copied.
+  # bytes, so the chosen id has to be resolved back before it can be re-copied.
   picker = pkgs.writeShellScript "clipboard-picker" ''
     ${cliphist} list \
       | ${rofi} -dmenu -i -p Clipboard \
       | ${cliphist} decode \
       | ${wl-copy}
   '';
-  */
 in
 {
   options.modules.desktop.utilities.clipboard.enable =
@@ -44,10 +39,8 @@ in
       # session so uwsm starts and stops them with it.
       services.cliphist.enable = true;
 
+      # $mod is defined by the compositor config these binds share.
       /*
-        Slice 1 disables external Hyprland binds while the compositor config
-        moves to a minimal Lua baseline.
-
       wayland.windowManager.hyprland.settings.bind = [
         "$mod SHIFT, V, exec, ${picker}"
       ];

configs/nixos/modules/desktop/utilities/recording.nix

@@ -1,17 +1,13 @@
 {
   config,
   lib,
-  # pkgs,
+  pkgs,
   ...
 }:
 # Keybound screen recording: pick a region, then toggle a video-only capture.
 let
   user = config.user.name;
 
-  /*
-    Slice 1 disables the recording keybind, so its supporting values stay
-    commented out with the bind block.
-
   slurp = "${pkgs.slurp}/bin/slurp";
   wf-recorder = "${pkgs.wf-recorder}/bin/wf-recorder";
   notify-send = "${pkgs.libnotify}/bin/notify-send";
@@ -23,9 +19,9 @@ let
 
   # A single key both starts and stops.
   # A running wf-recorder is stopped with SIGINT so it finalises the file.
-    # Otherwise slurp picks a region and wf-recorder runs in the foreground
+  # Otherwise slurp picks a region and wf-recorder runs in the foreground until
-    # until that stop arrives.
+  # that stop arrives, so this instance lives for the whole recording and then
-    # This instance lives for the whole recording and then reports it saved.
+  # reports it saved.
   # No -a means no audio is captured.
   toggle = pkgs.writeShellScript "screen-record-toggle" ''
     if ${pgrep} -x wf-recorder >/dev/null; then
@@ -42,7 +38,6 @@ let
     ${wf-recorder} -g "$region" -f "$file"
     ${notify-send} -a "Screen recording" "Recording saved" "$file"
   '';
-  */
 in
 {
   options.modules.desktop.utilities.recording.enable =
@@ -50,10 +45,8 @@ in
 
   config = lib.mkIf config.modules.desktop.utilities.recording.enable {
     home-manager.users.${user} = {
+      # $mod is defined by the compositor config these binds share.
       /*
-        Slice 1 disables external Hyprland binds while the compositor config
-        moves to a minimal Lua baseline.
-
       wayland.windowManager.hyprland.settings.bind = [
         "$mod SHIFT, R, exec, ${toggle}"
       ];

configs/nixos/modules/desktop/utilities/screenshot.nix

@@ -1,7 +1,7 @@
 {
   config,
   lib,
-  # pkgs,
+  pkgs,
   ...
 }:
 # Keyboard-driven screenshots copy to the clipboard before Satty opens for
@@ -9,10 +9,6 @@
 let
   user = config.user.name;
 
-  /*
-    Slice 1 disables the screenshot keybinds and Satty rule, so their
-    supporting values stay commented out with the bind block.
-
   grimblast = "${pkgs.grimblast}/bin/grimblast";
   satty = "${pkgs.satty}/bin/satty";
   tee = "${pkgs.coreutils}/bin/tee";
@@ -35,7 +31,6 @@ let
           --early-exit \
           --actions-on-enter save-to-clipboard
     '';
-  */
 in
 {
   options.modules.desktop.utilities.screenshot.enable =
@@ -43,14 +38,20 @@ in
 
   config = lib.mkIf config.modules.desktop.utilities.screenshot.enable {
     home-manager.users.${user} = {
+      # satty is a one-shot annotation surface, so float it rather than letting
+      # it claim a tile in the layout.
+      # windowrule v3 syntax: space-separated field/value tokens, comma
+      # separated, with matchers under a match: prefix and effects bare.
       /*
-        Slice 1 disables external Hyprland rules and binds while the compositor
-        config moves to a minimal Lua baseline.
-
       wayland.windowManager.hyprland.settings.windowrule = [
         "float 1, match:class ^(com\\.gabm\\.satty)$"
       ];
+      */
 
+      # Print with plain/Shift/Ctrl for region/window/full.
+      # Super+L is already the hjkl focus and movement bind, so screenshots take
+      # the Print key instead.
+      /*
       wayland.windowManager.hyprland.settings.bind = [
         ", Print, exec, ${capture "area"}"
         "SHIFT, Print, exec, ${capture "active"}"