From da53251938793568b424ce138c0d4e8575bf379c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=AE=B8=E6=9D=B0=E5=8F=8B=20Jieyou=20Xu=20=28Joe=29?=
 <39484203+jieyouxu@users.noreply.github.com>
Date: Sun, 17 Nov 2024 00:53:42 +0800
Subject: [PATCH] Document how to acquire `cdb.exe` (#2137)

---
 src/tests/compiletest.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/src/tests/compiletest.md b/src/tests/compiletest.md
index dc886e2525718..f47715889dfef 100644
--- a/src/tests/compiletest.md
+++ b/src/tests/compiletest.md
@@ -272,6 +272,17 @@ the debugger currently being used:
 
 [`tests/debuginfo`]: https://github.com/rust-lang/rust/tree/master/tests/debuginfo
 
+> **Note on acquiring `cdb.exe` on Windows 11**
+>
+> `cdb.exe` is acquired alongside a suitable "Windows 11 SDK" which is part of
+> the "Desktop Development with C++" workload profile in a Visual Studio
+> installer (e.g. Visual Studio 2022 installer).
+>
+> **HOWEVER** this is not sufficient by default alone. If you need `cdb.exe`,
+> you must go to Installed Apps, find the newest "Windows Software Development
+> Kit" (and yes, this can still say `Windows 10.0.22161.3233` even though the OS
+> is called Windows 11). You must then click "Modify" -> "Change" and then
+> selected "Debugging Tools for Windows" in order to acquire `cdb.exe`.
 
 ### Codegen tests