about summary refs log tree commit diff
path: root/src
diff options
context:
space:
mode:
authorJubilee Young <workingjubilee@gmail.com>2025-06-24 21:21:13 -0700
committerJubilee Young <workingjubilee@gmail.com>2025-06-25 00:54:02 -0700
commit087dabfca7c39d68534bb8c23ffa78def4b24c37 (patch)
treea42fd1a4141311fef92b926d24b5507d62832f7b /src
parent78652b783dd1549d4782c2daba7d12214e001b54 (diff)
downloadrust-087dabfca7c39d68534bb8c23ffa78def4b24c37.tar.gz
rust-087dabfca7c39d68534bb8c23ffa78def4b24c37.zip
Sprinkle breadcrumbs around to lead people to the rust-invalid ABI
Diffstat (limited to 'src')
-rw-r--r--src/doc/rustc-dev-guide/src/tests/ui.md5
1 files changed, 5 insertions, 0 deletions
diff --git a/src/doc/rustc-dev-guide/src/tests/ui.md b/src/doc/rustc-dev-guide/src/tests/ui.md
index 8f4467a5551..09dc476d68e 100644
--- a/src/doc/rustc-dev-guide/src/tests/ui.md
+++ b/src/doc/rustc-dev-guide/src/tests/ui.md
@@ -59,6 +59,11 @@ The output is normalized to ignore unwanted differences, see the
 [Normalization](#normalization) section. If the file is missing, then
 compiletest expects the corresponding output to be empty.
 
+A common reason to use normalization, revisions, and most of the other following tools,
+is to account for platform differences. Consider alternatives to these tools, like
+e.g. using the `extern "rust-invalid"` ABI that is invalid on every platform
+instead of fixing the test to use cross-compilation and testing every possibly-invalid ABI.
+
 There can be multiple stdout/stderr files. The general form is:
 
 ```text