about summary refs log tree commit diff
path: root/src/doc/rustc-dev-guide
diff options
context:
space:
mode:
authorRémy Rakic <remy.rakic+github@gmail.com>2023-07-03 20:24:29 +0000
committerTshepang Mbambo <tshepang@gmail.com>2023-07-05 02:14:36 +0200
commit4b5b3591a2c5d48b59fab94b0e1178ff348c8bcd (patch)
tree0cc56f73e48fb424e1eae71e23b0c9e699a75162 /src/doc/rustc-dev-guide
parent0aa1b465cfad40e624721554bc4af239a8c7ff4b (diff)
downloadrust-4b5b3591a2c5d48b59fab94b0e1178ff348c8bcd.tar.gz
rust-4b5b3591a2c5d48b59fab94b0e1178ff348c8bcd.zip
document `.x test --rustc-args` option
Diffstat (limited to 'src/doc/rustc-dev-guide')
-rw-r--r--src/doc/rustc-dev-guide/src/tests/running.md9
1 files changed, 9 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 6bc794ca917..71fb82b68b1 100644
--- a/src/doc/rustc-dev-guide/src/tests/running.md
+++ b/src/doc/rustc-dev-guide/src/tests/running.md
@@ -133,6 +133,15 @@ Under the hood, the test runner invokes the standard Rust test runner
 filtering for tests that include "issue-1234" in the name. (Thus
 `--test-args` is a good way to run a collection of related tests.)
 
+## Passing arguments to `rustc` when running tests
+
+It can sometimes be useful to run some tests with specific compiler arguments,
+without using `RUSTFLAGS` (during development of unstable features, with `-Z`
+flags, for example).
+
+This can be done with `./x test`'s `--rustc-args` option, to pass additional
+arguments to the compiler when building the tests.
+
 ## Editing and updating the reference files
 
 If you have changed the compiler's output intentionally, or you are