diff --git a/src/macros.rs b/src/macros.rs
index 80ef2c1..2c02d7c 100644
--- a/src/macros.rs
+++ b/src/macros.rs
@@ -1,6 +1,6 @@
 /// Return early with an error.
 ///
-/// This macro is equivalent to `return Err(From::from($err))`.
+/// This macro is equivalent to `return Err(eyre!(<args>))`.
 ///
 /// # Example
 ///
@@ -63,10 +63,10 @@ macro_rules! bail {
 
 /// Return early with an error if a condition is not satisfied.
 ///
-/// This macro is equivalent to `if !$cond { return Err(From::from($err)); }`.
+/// This macro is equivalent to `if !$cond { return Err(eyre!(<other args>)); }`.
 ///
 /// Analogously to `assert!`, `ensure!` takes a condition and exits the function
-/// if the condition fails. Unlike `assert!`, `ensure!` returns an `Err(Report)`
+/// if the condition fails. Unlike `assert!`, `ensure!` returns an `eyre::Result`
 /// rather than panicking.
 ///
 /// # Example