Merge branch 'main' into feat/override-path-and-xdg

docs/fish-config.1

@@ -570,6 +570,12 @@ shadowing system-installed Rust tools.
 NOTE: While these directories are merged with your system\[cq]s existing
 \f[V]$PATH\f[R] values, any executables in the prepended directories
 above will override (shadow) system binaries of the same name.
+.PP
+TIP: This standard PATH setup is gated behind the opinionated component
+overrides toggle.
+If you prefer to manage your PATH completely manually, you can disable
+it by setting \f[V]__fish_config_op_overrides\f[R] to \f[V]0\f[R] (or
+toggle it off in the \f[V]config-settings\f[R] menu).
 .PP
    *   *   *   *   *
 .SH 3. KEY BINDINGS
@@ -3532,6 +3538,8 @@ Disabling __fish_config_op_overrides removes all of them.
 Override                  What it replaces or sets
 ───────────────────────────────────────────────────────────────────────────
 Vi mode                   fish_vi_key_bindings replaces default Emacs mode
+XDG variables             Sets global XDG Base Directory variables
+PATH setup                Prepends custom bin directories to the PATH
 exit → smart_exit         exit wrapper that captures scrollback before closing
 PAGER=ov                  ov used by git, man, and all $PAGER-aware tools
 MANPAGER=bat pipeline     man pages rendered with syntax highlighting