From a091842e6200cca938df97fb3750d4dd48008951 Mon Sep 17 00:00:00 2001 From: Matthew John Cheetham Date: Thu, 1 Oct 2026 10:46:50 +0100 Subject: [PATCH] docs: update WSL docs to use correct GfW install paths Different versions of Git for Windows have different installation path prefixes; our existing docs only reference the mingw64 toolchain path. Update the docs to call out the different installation paths for x64 (UCRT64 and MINGW64), and ARM64 (CLANGARM64). Signed-off-by: Matthew John Cheetham --- docs/wsl.md | 36 +++++++++++++++++++++++++++++++----- 1 file changed, 31 insertions(+), 5 deletions(-) diff --git a/docs/wsl.md b/docs/wsl.md index cbcd6b384b..c37b4c2347 100644 --- a/docs/wsl.md +++ b/docs/wsl.md @@ -21,20 +21,46 @@ Start by installing the [latest Git for Windows ⬇️][latest-git-for-windows] _Inside your WSL installation_, run the following command to set GCM as the Git credential helper: +> [!IMPORTANT] +> The exact location of git-credential-manager.exe may be different in your +> installation of Git for Windows depending on the version you have installed. +> Please check and confirm the actual installation path before proceeding. + +### Git for Windows (x64 / x86_64 / "64-bit") + +The latest versions of Git for Windows for x64 (v2.56.0 and later) use the +`ucrt64` toolchain and installation path: + +```shell +git config --global credential.helper "/mnt/c/Program\ Files/Git/ucrt64/bin/git-credential-manager.exe" +``` + +Older versions of Git for Windows for x64 (v2.55.x and earlier) use the +`mingw64` toolchain and installation path: + ```shell git config --global credential.helper "/mnt/c/Program\ Files/Git/mingw64/bin/git-credential-manager.exe" ``` -> **Note:** the location of git-credential-manager.exe may be different in your -installation of Git for Windows. +### Git for Windows (ARM64) -If you intend to use Azure DevOps you must _also_ set the following Git -configuration _inside of your WSL installation_. +All known versions of Git for Windows for ARM64 use the `clangarm64` toolchain +and installation path: ```shell -git config --global credential.https://dev.azure.com.useHttpPath true +git config --global credential.helper "/mnt/c/Program\ Files/Git/clangarm64/bin/git-credential-manager.exe" ``` +## Azure DevOps Additional Configuration + +> [!IMPORTANT] +> If you intend to use Azure DevOps you must _also_ set the following Git +> configuration _inside of your WSL installation_. +> +> ```shell +> git config --global credential.https://dev.azure.com.useHttpPath true +> ``` + ## Configuring WSL without Git for Windows If you wish to use GCM inside of WSL _without installing Git for Windows_