about summary refs log tree commit diff
path: root/src/doc/rustc-dev-guide
diff options
context:
space:
mode:
author许杰友 Jieyou Xu (Joe) <39484203+jieyouxu@users.noreply.github.com>2024-06-24 13:21:15 +0800
committerGitHub <noreply@github.com>2024-06-24 05:21:15 +0000
commitddfa50dedb4f8a672a6c3c90d59212aa3dcad622 (patch)
tree158ae7ba7b70543159fd75b5a5fdcc1f865cf329 /src/doc/rustc-dev-guide
parentef22f393b3882ece8b7ef639b6a990b7ac7a03d2 (diff)
downloadrust-ddfa50dedb4f8a672a6c3c90d59212aa3dcad622.tar.gz
rust-ddfa50dedb4f8a672a6c3c90d59212aa3dcad622.zip
tests: document how to run `run-make` on Windows (#2002)
Diffstat (limited to 'src/doc/rustc-dev-guide')
-rw-r--r--src/doc/rustc-dev-guide/src/tests/running.md16
1 files changed, 16 insertions, 0 deletions
diff --git a/src/doc/rustc-dev-guide/src/tests/running.md b/src/doc/rustc-dev-guide/src/tests/running.md
index a4f77aa32fe..ca0ceb7513b 100644
--- a/src/doc/rustc-dev-guide/src/tests/running.md
+++ b/src/doc/rustc-dev-guide/src/tests/running.md
@@ -213,6 +213,22 @@ This is much faster, but doesn't always work. For example, some tests
 include directives that specify specific compiler flags, or which rely
 on other crates, and they may not run the same without those options.
 
+## Running `run-make` tests
+
+### Windows
+
+Running the `run-make` test suite on Windows is a bit more involved. There are numerous
+prerequisites and environmental requirements:
+
+- Install msys2: <https://www.msys2.org/>
+- Specify `MSYS2_PATH_TYPE=inherit` in `msys2.ini` in the msys2 installation directory, run the
+  following with `MSYS2 MSYS`:
+  - `pacman -Syuu`
+  - `pacman -S make`
+  - `pacman -S diffutils`
+  - `pacman -S binutils`
+  - `./x test run-make` (`./x test tests/run-make` doesn't work)
+
 
 ## Running tests on a remote machine