Warn about the rust-src component footgun

dtolnay · Oct 14, 2024 · 412e9b6 · 412e9b6
1 parent 2860c0f
commit 412e9b6
Show file tree

Hide file tree

Showing 2 changed files with 20 additions and 0 deletions.
diff --git a/README.md b/README.md
@@ -224,6 +224,16 @@ to catch. If the compiler changes something that makes error messages that we
 care about substantially worse, it is also important to catch and report as a
 compiler issue.
 
+## CI
+
+Make sure `rust-src` component is installed on CI, otherwise error messages
+on CI will not include snippets of code from the standard library. This will
+make sure the output on CI is the same as on your local machine.
+
+```bash
+rustup component add rust-src
+```
+
 <br>
 
 #### License

diff --git a/src/lib.rs b/src/lib.rs
@@ -207,6 +207,16 @@
 //! important for a test suite to catch. If the compiler changes something that
 //! makes error messages that we care about substantially worse, it is also
 //! important to catch and report as a compiler issue.
+//!
+//! # CI
+//!
+//! Make sure `rust-src` component is installed on CI, otherwise error messages
+//! on CI will not include snippets of code from the standard library. This will
+//! make sure the output on CI is the same as on your local machine.
+//!
+//! ```bash
+//! rustup component add rust-src
+//! ```
 
 #![doc(html_root_url = "https://docs.rs/trybuild/1.0.99")]
 #![allow(