diff --git a/src/librustc_metadata/diagnostics.rs b/src/librustc_metadata/diagnostics.rs
index 8ff2acbac9d5..0a1662dd42d9 100644
--- a/src/librustc_metadata/diagnostics.rs
+++ b/src/librustc_metadata/diagnostics.rs
@@ -14,7 +14,7 @@ register_long_diagnostics! {
 E0454: r##"
 A link name was given with an empty name. Erroneous code example:
 
-```ignore (cannot-test-this-because-???)
+```ignore (cannot-test-this-because-rustdoc-stops-compile-fail-before-trans)
 #[link(name = "")] extern {} // error: #[link(name = "")] given with empty name
 ```
 
@@ -51,7 +51,7 @@ https://doc.rust-lang.org/book/first-edition/conditional-compilation.html
 E0458: r##"
 An unknown "kind" was specified for a link attribute. Erroneous code example:
 
-```ignore (cannot-test-this-because-???)
+```ignore (cannot-test-this-because-rustdoc-stops-compile-fail-before-trans)
 #[link(kind = "wonderful_unicorn")] extern {}
 // error: unknown kind: `wonderful_unicorn`
 ```
@@ -67,7 +67,7 @@ Please specify a valid "kind" value, from one of the following:
 E0459: r##"
 A link was used without a name parameter. Erroneous code example:
 
-```ignore (cannot-test-this-because-???)
+```ignore (cannot-test-this-because-rustdoc-stops-compile-fail-before-trans)
 #[link(kind = "dylib")] extern {}
 // error: #[link(...)] specified without `name = "foo"`
 ```