From bde086e3fa6e5d19340b9379936d008968cf932c Mon Sep 17 00:00:00 2001 From: Jieyou Xu Date: Thu, 17 Apr 2025 17:04:30 +0800 Subject: [PATCH] rustc-dev-guide: document `//@ ignore-auxiliary` --- src/tests/best-practices.md | 2 ++ src/tests/directives.md | 3 +++ 2 files changed, 5 insertions(+) diff --git a/src/tests/best-practices.md b/src/tests/best-practices.md index 6905ee13..2bdc7f3a 100644 --- a/src/tests/best-practices.md +++ b/src/tests/best-practices.md @@ -175,6 +175,8 @@ See [compiletest directives] for a listing of directives. - For `ignore-*`/`needs-*`/`only-*` directives, unless extremely obvious, provide a brief remark on why the directive is needed. E.g. `"//@ ignore-wasi (wasi codegens the main symbol differently)"`. +- When using `//@ ignore-auxiliary`, specify the corresponding main test files, + e.g. ``//@ ignore-auxiliary (used by `./foo.rs`)``. ## FileCheck best practices diff --git a/src/tests/directives.md b/src/tests/directives.md index 0aad8be9..dae659e6 100644 --- a/src/tests/directives.md +++ b/src/tests/directives.md @@ -124,6 +124,9 @@ means the test won't be compiled or run. * `ignore-X` where `X` is a target detail or other criteria on which to ignore the test (see below) * `only-X` is like `ignore-X`, but will *only* run the test on that target or stage +* `ignore-auxiliary` is intended for files that *participate* in one or more other + main test files but that `compiletest` should not try to build the file itself. + Please backlink to which main test is actually using the auxiliary file. * `ignore-test` always ignores the test. This can be used to temporarily disable a test if it is currently not working, but you want to keep it in tree to re-enable it later.