diff --git a/core/src/hint.rs b/core/src/hint.rs index 1ee872fcc9490..80f6e32b6b2cd 100644 --- a/core/src/hint.rs +++ b/core/src/hint.rs @@ -603,8 +603,8 @@ pub const fn must_use(value: T) -> T { /// /// It can be used with `if` or boolean `match` expressions. /// -/// When used outside of a branch condition, it may still work if there is a branch close by, but -/// it is not guaranteed to have any effect. +/// When used outside of a branch condition, it may still influence a nearby branch, but +/// probably will not have any effect. /// /// It can also be applied to parts of expressions, such as `likely(a) && unlikely(b)`, or to /// compound expressions, such as `likely(a && b)`. When applied to compound expressions, it has @@ -635,8 +635,7 @@ pub const fn must_use(value: T) -> T { /// false => println!("this branch is unlikely to be taken"), /// } /// -/// // Use outside of a branch condition. This may still work if there is a branch close by, -/// // but it is not guaranteed to have any effect +/// // Use outside of a branch condition may still influence a nearby branch /// let cond = likely(x != 0); /// if cond { /// println!("this branch is likely to be taken"); @@ -646,7 +645,6 @@ pub const fn must_use(value: T) -> T { /// /// #[unstable(feature = "likely_unlikely", issue = "26179")] -#[rustc_nounwind] #[inline(always)] pub const fn likely(b: bool) -> bool { crate::intrinsics::likely(b) @@ -657,8 +655,8 @@ pub const fn likely(b: bool) -> bool { /// /// It can be used with `if` or boolean `match` expressions. /// -/// When used outside of a branch condition, it may still work if there is a branch close by, but -/// it is not guaranteed to have any effect. +/// When used outside of a branch condition, it may still influence a nearby branch, but +/// probably will not have any effect. /// /// It can also be applied to parts of expressions, such as `likely(a) && unlikely(b)`, or to /// compound expressions, such as `unlikely(a && b)`. When applied to compound expressions, it has @@ -689,8 +687,7 @@ pub const fn likely(b: bool) -> bool { /// false => println!("this branch is likely to be taken"), /// } /// -/// // Use outside of a branch condition. This may still work if there is a branch close by, -/// // but it is not guaranteed to have any effect +/// // Use outside of a branch condition may still influence a nearby branch /// let cond = unlikely(x != 0); /// if cond { /// println!("this branch is likely to be taken"); @@ -698,7 +695,6 @@ pub const fn likely(b: bool) -> bool { /// } /// ``` #[unstable(feature = "likely_unlikely", issue = "26179")] -#[rustc_nounwind] #[inline(always)] pub const fn unlikely(b: bool) -> bool { crate::intrinsics::unlikely(b) @@ -732,7 +728,6 @@ pub const fn unlikely(b: bool) -> bool { /// } /// ``` #[unstable(feature = "cold_path", issue = "26179")] -#[rustc_nounwind] #[inline(always)] pub const fn cold_path() { crate::intrinsics::cold_path()