diff --git a/src/libcore/intrinsics.rs b/src/libcore/intrinsics.rs index 5570d356149d..674cb271b3f3 100644 --- a/src/libcore/intrinsics.rs +++ b/src/libcore/intrinsics.rs @@ -259,7 +259,11 @@ extern "rust-intrinsic" { /// Inform the optimizer that a condition is always true. /// If the condition is false, the behavior is undefined. /// - /// No code is generated for this intrisic. + /// No code is generated for this intrinsic, but the optimizer will try + /// to preserve it (and its condition) between passes, which may interfere + /// with optimization of surrounding code and reduce performance. It should + /// not be used if the invariant can be discovered by the optimizer on its + /// own, or if it does not enable any significant optimizations. #[cfg(not(stage0))] pub fn assume(b: bool);