summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJesse Vincent <jesse@primeradiant.com>2026-09-26 13:04:15 -0700
committerJesse Vincent <jesse@primeradiant.com>2026-09-26 13:04:15 -0700
commit1c8408897d349127a238417157f38688960d5812 (patch)
tree0f7f51c2a9212d41b42d929e7dc9e63ac257410c
parentdbb67fc5f8ee2ed53305e353ca6419a499b4116b (diff)
docs(windows): match the WSL launcher and where.exe detailsfix/windows-bash-discovery
-rw-r--r--docs/windows/polyglot-hooks.md10
1 files changed, 6 insertions, 4 deletions
diff --git a/docs/windows/polyglot-hooks.md b/docs/windows/polyglot-hooks.md
index 2797ed6..3da01ae 100644
--- a/docs/windows/polyglot-hooks.md
+++ b/docs/windows/polyglot-hooks.md
@@ -82,10 +82,12 @@ afterward.
- `C:\Program Files (x86)\Git\bin\bash.exe`
- `%LOCALAPPDATA%\Programs\Git\bin\bash.exe` (a per-user Git for Windows
install), only when `LOCALAPPDATA` is set
- - `bash` on `PATH` (MSYS2, Cygwin, or a non-default Git install), found with
- `where $PATH:bash` so the current directory is never searched. The WSL
- launchers (`System32\bash.exe` and anything under `WindowsApps`) are
- skipped, since they fail when no Linux distro is installed.
+ - `bash` on `PATH` (MSYS2, Cygwin, or a non-default Git install), found by
+ running `%SystemRoot%\System32\where.exe $PATH:bash`, so neither `where`
+ nor `bash` is taken from the current directory. The WSL launchers
+ (`bash.exe` in `System32`, `Sysnative`, or
+ `%LOCALAPPDATA%\Microsoft\WindowsApps`) and extensionless matches are
+ skipped, since the launchers fail when no Linux distro is installed.
3. If bash is found, it runs the named extensionless hook script from the hooks
directory and exits with the script's exit code.
4. If no bash is found, the dispatcher exits `0` silently — the plugin