Add area screenshots and preserve stacking on hover focus

docs/configuration.md

@@ -127,7 +127,7 @@ angle = 135.0
 
 | `[input]` key | Type | Default | Meaning |
 | --- | --- | --- | --- |
-| `focus_follows_mouse` | boolean | `false` | Focus windows under the pointer |
+| `focus_follows_mouse` | boolean | `false` | Focus windows under the pointer without raising them; click to raise |
 | `xkb_layout` | nonempty string | `"us"` | XKB layout |
 | `xkb_variant` | string | `""` | XKB variant |
 | `xkb_options` | string array | `[]` | XKB options |
@@ -178,7 +178,13 @@ Super+Shift+H/J/K/L move; Super+Ctrl+H/J/K/L resize; Super+1–9 workspace;
 Super+Shift+1–9 move to workspace; Super+R width cycle; Super+C center;
 Super+[/] consume/expel; Super+F maximize; Super+Shift+F fullscreen;
 Super+M layout; Super+Shift+Space floating; Super+Tab overview;
-Super+Shift+E immediate logout.
+Super+Shift+S area screenshot; Super+Shift+E immediate logout.
+
+The screenshot shortcut runs `ferese-screenshot`: drag to select an area, or
+press Escape to cancel. Captures are saved under your Pictures directory in
+`Screenshots` and copied to the clipboard as PNG images. It requires `grim`,
+`slurp`, and `wl-copy` (from `wl-clipboard`). Override the `screenshot` command
+to use another screenshot tool.
 
 ## Window rules
 
@@ -273,5 +279,7 @@ ending the session from another TTY.
 These are launch-time environment switches, not TOML keys. Enable only for
 trusted clients: `FERESE_ENABLE_INPUT_METHOD=1`,
 `FERESE_ENABLE_SHORTCUT_INHIBIT=1`, `FERESE_ENABLE_SCREENCOPY=1`.
+The installed session launcher enables screencopy for screenshots unless
+`FERESE_ENABLE_SCREENCOPY=0` is explicitly set in its environment.
 Text input is available by default; Ctrl+Alt+Escape releases an active shortcut
 inhibitor. Use `feresectl --help` for runtime control commands.

docs/installation.md

@@ -5,6 +5,7 @@
 On Fedora with SDDM, install a Rust toolchain (1.93 or newer), native build
 dependencies, `desktop-file-utils`, D-Bus and `foot`. Wallpaper browsing also
 needs `zenity`; locking needs swaylock or swaylock-effects.
+Area screenshots need `grim`, `slurp`, and `wl-clipboard`.
 
 From the checkout, run as your normal user:
 
@@ -35,6 +36,11 @@ its DRM backend inside an active graphical session.
 Logs are stored in `${XDG_STATE_HOME:-~/.local/state}/ferese/`. Keep an existing
 desktop available while testing scaling, monitor hotplug, suspend and locking.
 
+The session launcher enables the screencopy protocol for screenshot tools.
+Set `FERESE_ENABLE_SCREENCOPY=0` in the session environment to disable it.
+When enabled, Wayland clients can capture the unlocked desktop. Capture remains
+blocked while the session is locked. Launcher changes take effect at next login.
+
 ## Logout and recovery
 
 Save your work before **Super+Shift+E** or `feresectl exit`: logout is immediate.