about summary refs log tree commit diff
diff options
context:
space:
mode:
author许杰友 Jieyou Xu (Joe) <39484203+jieyouxu@users.noreply.github.com>2024-09-25 01:46:42 +0800
committernora <48135649+Noratrieb@users.noreply.github.com>2024-09-24 19:49:14 +0200
commit96805d6a853053268f67e6c4cd50fb93cef6b577 (patch)
treeab0c6eb490c9a855d9e8c2cb957d8038a8af2ea5
parenta203e396d6f8de6ba82f2ebbf3d5e6a9f7327edb (diff)
downloadrust-96805d6a853053268f67e6c4cd50fb93cef6b577.tar.gz
rust-96805d6a853053268f67e6c4cd50fb93cef6b577.zip
Note lldb debuginfo requires `python310.dll` to be present in `PATH`
-rw-r--r--src/doc/rustc-dev-guide/src/tests/compiletest.md11
1 files changed, 11 insertions, 0 deletions
diff --git a/src/doc/rustc-dev-guide/src/tests/compiletest.md b/src/doc/rustc-dev-guide/src/tests/compiletest.md
index 1b506d350b1..4ba2f0cc5ae 100644
--- a/src/doc/rustc-dev-guide/src/tests/compiletest.md
+++ b/src/doc/rustc-dev-guide/src/tests/compiletest.md
@@ -254,6 +254,17 @@ test based on the debugger currently being used:
   NOTE: The "Rust" version of LLDB doesn't exist anymore, so this will always be ignored.
   This should probably be removed.
 
+> **Note on running lldb debuginfo tests locally**
+>
+> If you want to run lldb debuginfo tests locally, then currently on Windows it is required that:
+> 
+> - You have **exactly** Python 3.10 installed -- not a newer version, not an older version,
+>   precisely 3.10.
+> - You have the `python310.dll` available in your `PATH` env var. This is not provided by the
+>   standard Python installer you obtain from `python.org`; you need to add this to `PATH` manually.
+> 
+> Otherwise the lldb debuginfo tests can produce crashes in mysterious ways.
+
 [`tests/debuginfo`]: https://github.com/rust-lang/rust/tree/master/tests/debuginfo