flush_delayed: add note about stashed diagnostics

RalfJung · RalfJung · commit bad7d36c33cd · 2025-11-17T12:09:57.000+01:00
diff --git a/compiler/rustc_errors/src/lib.rs b/compiler/rustc_errors/src/lib.rs
@@ -1205,6 +1205,10 @@ impl<'a> DiagCtxtHandle<'a> {
         std::mem::take(&mut self.inner.borrow_mut().fulfilled_expectations)
     }
 
+    /// Trigger an ICE if there are any delayed bugs and no hard errors.
+    ///
+    /// This will panic if there are any stashed diagnostics. You can call
+    /// `emit_stashed_diagnostics` to emit those before calling `flush_delayed`.
     pub fn flush_delayed(&self) {
         self.inner.borrow_mut().flush_delayed();
     }

Original file line number	Diff line number	Diff line change
`@@ -1205,6 +1205,10 @@ impl<'a> DiagCtxtHandle<'a> {`
`1205`	`1205`	`std::mem::take(&mut self.inner.borrow_mut().fulfilled_expectations)`
`1206`	`1206`	`}`
`1207`	`1207`
	`1208`	`+ /// Trigger an ICE if there are any delayed bugs and no hard errors.`
	`1209`	`+ ///`
	`1210`	`+ /// This will panic if there are any stashed diagnostics. You can call`
	`1211`	+ /// `emit_stashed_diagnostics` to emit those before calling `flush_delayed`.
`1208`	`1212`	`pub fn flush_delayed(&self) {`
`1209`	`1213`	`self.inner.borrow_mut().flush_delayed();`
`1210`	`1214`	`}`